Datadog

Connecting Hawkeye to your Datadog account allows us to collect application and infrastructure telemetry, which includes metrics, traces, and logs. These telemetry data enable real-time monitoring and alerting through the Hawkeye dashboard.

To ensure an easy connection with Hawkeye, you will authenticate using a Datadog API Key, APP ID, and Endpoint.

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 Datadog connection!

Step 1: Setup Datadog Integration

To retrieve these credentials, you’ll need to sign into your Datadog account. The following steps will guide you on how to retrieve your credentials.

Generate API Key.

1. Sign in to your Datadog account and navigate to the User profile.

2. From the drop-down menu that appears, under Organization Settings, select API Keys.

   

3. At the top-right corner of the page, click New Key to generate a new API Key.

4. Enter a name for your API Key in the input provided, and click create to continue.

5. Your new API Key has been created. Securely copy your key.

Generate Application Key.

1. Navigate to the User profile at the top-right corner of your Datadog dashboard.

2. From the drop-down menu that appears, under Organization Settings, select Application Keys.

   

3. At the top-right corner of the page, click New Key to generate a new Application Key.

4. Enter a name for your Application Key in the input provided, and click create to continue.

5. Click Edit to modify Application key access Select the following permissions and click Save after selection, to save configuration

   • apm_read
   • events_read
   • metrics_read
   • monitors_read
   • logs_read_data
   • logs_read_index_data
   • logs_modify_indexes
   • logs_read_workspaces
   • logs_read_config

6. Safely copy your newly created Application key.

Obtain Endpoint

To obtain your Datadog Endpoint, copy the datadog url from your browser . E.g - https://app.datadoghq.com or https://us5.datadoghq.com/

Step 2: Add Datadog Connection to Hawkeye

Now that you have your API Key, APP ID, and Endpoint, proceed to the Hawkeye dashboard to complete the connection setup.

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

   

2. Select Datadog: From the list of available integrations, select Datadog.

   

   Then, click Next at the top right corner.

3. Enter Credentials: Provide the following credentials:

   • Name: Give your connection a descriptive name.
   • Description: Optionally, add a description for the integration.
   • API Key: Paste the API Key you generated from your Datadog account.
   • APP ID: Enter the APPLICATION ID you generated from your Datadog account.
   • Endpoint: Enter the DATADOG URL from your browser.

   

   Click Save to complete the setup.

4. Verify connection: Once the connection is successfully established, navigate to the connections section in Hawkeye. You should see the Datadog connection card displayed on your dashboard.

   

Step 3: Adding Datadog connection to Project

Note

While adding the Datadog connection, you can enable automated session by checking the Created automated session box. You can enable this while creating a new project or while editing an existing project.

The following steps will guide you on how to add your Datadog connection to projects.

1. Navigate to the Projects Tab: In the Hawkeye dashboard, go to the Projects section and click on New project.

   

2. Enter project details: In the new project page, enter the following details:

   • Project name: Give your project a descriptive name.
   • Project description: Enter a detailed description for your project.
   • Color: Select a color you want to identify your project with.

   

3. Select connection: From the list of connections that appear, select Datadog. In the Datadog accordion;

   • Check the Create automated session box to enable automated session
   • Select the Treshold for priority: High, High & Medium or All

   Click Next when done.

   

4. Enter project Instructions: State precisely, the details of your project, and what resources you expect to monitor or ignore. (This helps Hawkeye understand the context of your project and to deliver better and more relevant analysis).

5. Navigate back to Project: After your Project has been created successfully, navigate back to Projects page.

6. View new project: In the list of Projects in the Projects page, you’ll find your newly created Project with Datadog connection.

7. Start Session: If project status is Ready, click to start a new session.

   

8. Enter a prompt: Select from the list of prompts on the session page or enter a prompt manually to start a session.

   

9. Your automated session is begins: This page displays your session analytics. You can click the input box below to ask further questions.