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

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.

   

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.

3. Create a New OAuth Client:

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

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

   

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.

   

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

   

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.

     

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.