Dynatrace

Connecting Hawkeye to your Dynatrace account allows us to collect telemetry data, such as service performance, environment metrics, and application health.

This data enables real-time monitoring and insights into the performance of your applications running on Dynatrace.

Note

For each step, we’ve created a short demo walkthrough and a step-by-step guide. You can check out the demo for a visual guide to setting up your Dynatrace connection!

1. Generate a Dynatrace API Key

Fig.1 - A walkthrough of how to generate Dynatrace API Key in Dynatrace

To authorize Hawkeye to access your Dynatrace data, you need to create an API key with appropriate permissions.

1. Access Account Management: In the Dynatrace console, navigate to the bottom-left corner of the screen.

   • Click your username.
   • From the pop-up menu, select Account Management.

   

   Fig.2 - Access acount management

2. Open Identity & Access Management:

   • On the Account Management screen, click Identity & Access Management in the top navigation bar.
   • Select OAuth Clients from the list of available options.

   Fig.3 - Open identity & access management

3. Create a New OAuth Client:

   • On the OAuth Clients screen, click the Create client button in the upper-right corner.

   Fig.4 - Create new OAuth client

   • On the Create Client screen:

     • Enter the current user’s email address in the Subject user email field.

   

   Fig.5 - Enter client details

4. Assign Permissions: Grant the following permissions to ensure the OAuth client has the appropriate level of access.

Permissions

Settings Service

• settings:objects:read – View schema settings objects.
• app-settings:objects:read – View app settings objects.

Environment API

• environment-api:events:read – Read events.
• environment-api:metrics:read – Read metrics.
• environment-api:security-problems:write – Manage security problems.
• environment-api:security-problems:read – Read security problems.
• environment-api:problems:write – Manage problems.
• environment-api:problems:read – Read problems.
• environment-api:entities:read – Read entities.

Grail Data Ingest and Query

• storage:system:read – View system tables.
• storage:bizevents:read – View business events.
• storage:buckets:read – View Grail buckets.
• storage:metrics:read – View metrics.
• storage:events:read – View events.
• storage:logs:read – View logs.
• storage:smartscape:read – View Smartscape data.
• storage:entities:read – View entities.
• storage:spans:read – View spans.
• storage:security.events:read – View security events.

Document Service

• document:documents:read – View documents.

• Scroll to the bottom of the screen.
• Click the Create client button.

2. Retrieve API Key Information

After the client is created, make note of the following credentials:

• Client ID
• Client Secret
• Login URL – for example:

Important: For Hawkeye integration, you must convert the login URL into the live data endpoint.
Replace apps with live in the URL.
Example:

• Login URL: https://bcz58691.apps.dynatrace.com
• Live Data Endpoint: https://bcz58691.live.dynatrace.com

3. Add Dynatrace Connection to Hawkeye

Now that you have your API key and Environment ID, configure the Dynatrace connection in Hawkeye.

1. Navigate to the Connections Tab: In the Hawkeye dashboard, go to the Connections section and click New Connection.

   

   Fig.6 - Create new Dynatrace connection dashboard

2. Select Dynatrace: From the list of available integrations, select Dynatrace, and click Next.

   

   Fig.7 - Select Dynatrace

3. Enter Connection Details: When setting up the connection, you will need to provide the following information:

   • Name (Required)
     Enter a unique name for the connection. This field is mandatory and is usually marked with a red asterisk (*).
     Example: Dynatrace-Production-Integration

   • Description (Optional)
     Provide a short description of the integration to help identify its purpose or scope.
     Example: Integration for monitoring production environment

   • Endpoint (Required)
     Specify the Dynatrace API endpoint.

     • Use the live data endpoint (replace apps with live in the login URL).
     • Example:

     https://bcz58691.live.dynatrace.com

   • Client ID (Required)
     Enter the Client ID that was generated when you created the OAuth client in Dynatrace.

   • Client Secret (Required)
     Enter the Client Secret associated with the Client ID. This is used to authenticate API requests securely.

     

     Fig.8 - Enter connection details

4. Verify the Connection: Hawkeye will verify the connection to Dynatrace. Once the verification is complete, the Dynatrace connection card will be visible on your dashboard.