OneAgent data source

Dynatrace OneAgent is a unified monitoring solution deployed across IT environments. It monitors applications, services, processes, and infrastructure components.

The OneAgent data source uses an API connection to bring OneAgent data into Data Manager.

Before you begin:

• Ask your Dynatrace SME to confirm that OneAgent is API‑enabled.

• Ensure API URL and API token details are available.

How do I connect OneAgent to Data Manager?

1. Gather all of the Data Manager type information, including the data source name, short display name, and the data source type.

2. Gather the OneAgent fields – this may require consultation with the OneAgent subject matter expert (SME).

3. In Data Manager, add a new data source by selecting the tool you which to connect and configure with all the gathered information.

Each time this data source is fetched the data becomes raw data.

Data Manager fields

You need to specify the following information from Data Manager:

• Data source name – the name of the data source used to run, transform, map, cleanse, and import the data.

• Short display name – a unique name as a data source label.

• Data source type – what type of data the tool is providing. For example, Assets, CMDB, user location.

OneAgent fields

• API URL – URL for your Dynatrace environment.

• API token – unique identifier to authenticate the Dynatrace API client.

Authentication and authorization

1. In the Dynatrace menu, select Access tokens.

2. Select Generate new token.

3. Enter a token name.

4. Select required scopes; ensure the token includes the DataExport scope.

5. Select Generate token.

API call

The adapter queries OneAgent for host data:

• API: {api-url}/api/v1/oneagents

• Method: GET

• Response: list of hosts with the fields below.

Fields Retrieved

The following fields are retrieved: