• Products
  • Get started
  • Documentation
  • Resources

Data Manager - OneAgent Adapter

Assets Data Manager for Jira Service Management Cloud is currently rolling out in Open Beta and will be available to all Premium + Enterprise sites by end of October 2024.

Introduction

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

OneAgent Adapter uses an API connection to bring data into Assets Data Manager.

Before you begin setting up request your Dynatrace Subject Matter Expert to check that OneAgent is API enabled. Additionally, ensure that relevant details such as API URL and API Access Token are available.

How do I connect this tool to Assets Data Manager?

This task requires Data Manager Adapters admin permissions to complete. See how permissions and roles work in Data Manager.

 

Follow this procedure to connect this tool to Assets Data Manager using the custom-built Adapter:

  1. Gather all of the information listed in the Data Manager Fields section, such as the Name, Object class, Data Source Name, and Data Source Type.

  2. Gather all of the information in the OneAgent Fields section - this may require consultation with the subject matter expert (SME) for OneAgent.

  3. Within Data Manager:

    1. Create a new job by selecting the Adaptor that matches your tool.

    2. Configure all of the required fields with the appropriate information.

  4. Within OneAgent:

    1. Follow all of the steps listed in the Authentication and Authorization section, below, to properly configure Authentication and Authorization.

    2. Review the information in the API Call section.

    3. Review the information in the Fields Retrieved section, below.

Each time this job is run, the data your have selected will be brought into Data Manager using the configured Adapter and become raw data.

Data Manager Fields

You will need to specify the following information from Assets Data Manager:

  1. Name - the name of the Connection, visible as the job name in Adapters.

  2. Object Class - the name of the Object Class you want to the data to be loaded into.

  3. Data Source Name - the type of data being created; which is usually the tool name, e.g AD, Qualys etc. Note: This can be the same as Name.

  4. Data Source Type - what type of data is the tool providing? For example, Assets, CMDB, user location and more.

OneAgent Fields

You will need to specify the following information from OneAgent:

  1. API URL: the URL to access the Dynatrace data source.

  2. API Token: a 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 name for your token.

  4. Select the required scopes for the token. Make sure the access token that is generated must be tagged with the DataExport scope.

  5. Select Generate token.

API Call

The Adapters Client directly calls the API to retrieve a list of Hosts.

  1. API: {api-url}/api/v1/oneagents

  2. Method: GET

  3. Response: Refer to the list of Fields Retrieved

Fields Retrieved

The following fields are retrieved:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 EntityId DisplayName DiscoveredName FirstSeenTimestamp LastSeenTimestamp OsType OsArchitecture OsVersion HypervisorType IpAddresses Bitness CpuCores LogicalCpuCores CloudType MonitoringMode NetworkZoneId ConsumedHostUnits UserLevel AutoInjection LocalIp AmiId] AwsSecurityGroup AwsInstanceType LocalHostName AwsInstanceId CustomizedName EsxiHostName VmwareName AwsNameTag

 

Still need help?

The Atlassian Community is here for you.