topic Re: Which API and field?: Indicator of brand new on-boarding hosts in Dynatrace API

Which API and field?: Indicator of brand new on-boarding hosts

avrildong — Mon, 14 Nov 2022 20:19:04 GMT

Use case: we intend to find out EXACT checklist of those brand-new-on-boarding hosts/one-agents during last 7 days or custom period. Those have to match with "Console > Deployment status > OneAgents" which EXCLUDE those preexisting-hosts/one-agents with re-enabled-monitor.

Issue:

hosts & oneagents API limitation > those 2 API shown "firstSeenTimestamp" field re-count the datetime if already-on-boarded hosts restarted or one-agent service restarted. We need to exclude those cases but ONLY retrieve first-time-brand-new-on-board ones.

Question: which API and field can reach above goal? Any solution for us to easily grab "brand-new-on-boarding hosts/one-agents during last 7 days or custom period"?

Re: Which API and field?: Indicator of brand new on-boarding hosts

Mizső — Tue, 15 Nov 2022 13:48:13 GMT

Hi @avrildong,

Have you already checked this?

MONITORED_AGENT_REGISTERED: Hosts where the new OneAgent has been recognized.

OneAgent on a host API | Dynatrace Docs

Maybe it could help.

Best regards,

Mizső

Re: Which API and field?: Indicator of brand new on-boarding hosts

avrildong — Tue, 15 Nov 2022 14:13:12 GMT

@Mizső ,

Thanks!

Have you already checked this? > Yes, we have tried this API api/v1/oneagents plus api/v1/entity/infrastructure/hosts, however, "hosts & oneagents API limitation > those 2 API shown "firstSeenTimestamp" field re-count the datetime if already-on-boarded hosts restarted or one-agent service restarted. We need to exclude those cases but ONLY retrieve first-time-brand-new-on-board ones.".

Rgds, Avril

Re: Which API and field?: Indicator of brand new on-boarding hosts

Ana_Kuzmenchuk — Fri, 16 Dec 2022 08:35:14 GMT

Hi @avrildong, were you able to find a solution for your specific use case maybe? If so, we'd really appreciate you sharing it with the Community 😊

And if not yet, let's bring this question to the top once again so more people see it and hope someone has the answer for you 😉 Cheers!

Re: Which API and field?: Indicator of brand new on-boarding hosts

avrildong — Fri, 25 Aug 2023 21:38:59 GMT

@Ana_Kuzmenchuk and @Mizső , thanks much for asking! Sorry I do not know why I missed this thread so that I reply late.

I believe the solution works, but we did not validate more.

use case:

"MONITORED_AGENT_REGISTERED" in api/v1/oneagents response "api_v1_oneagents_1yr.response.json" > "MONITORED_AGENT_REGISTERED" returned 5 hits (= 5 new on-board) vs "displayname" 10283 hits (total one-agents)

sample of 1 -

{
"hostInfo": {
"entityId": "HOST-0C400BF17DA7BB73",
"displayName":
....
"faultyVersion": null,
"active": null,
"configuredMonitoringMode": "FULL_STACK",
"monitoringType": "STANDALONE",
"autoUpdateSetting": "DISABLED",
"updateStatus": "UP2DATE",
"availableVersions": [],
"configuredMonitoringEnabled": true,
"availabilityState": "MONITORED",
"detailedAvailabilityState": "MONITORED_AGENT_REGISTERED", > this one
"currentActiveGateId": 1850586947,
"currentActiveGateIds": [
...
],