> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deeptrace.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations 

> Onboarding made simple. Follow this guide to start solving alerts with Deeptrace in minutes.

### How to setup Deeptrace

Once your workspace is configured, follow these two steps to integrate Deeptrace:

<Steps>
  <Step title="Create your Deeptrace account">
    Click [here](https://app.deeptrace.com/) to log in to your new workspace and follow our authentication flow.
  </Step>

  <Step title="Connect your Integrations">
    Click [here](https://app.deeptrace.com/onboarding) to go to the integrations page and then follow the setup steps for your tools below.

    <AccordionGroup>
      <Accordion title="GitHub">
        1. Click **Connect** next to GitHub.
        2. Follow the GitHub OAuth flow to authorize Deeptrace and select the relevant repositories you'd like Deeptrace to access.
      </Accordion>

      <Accordion title="Slack">
        1. Click **Connect** next to  Slack  and complete the  OAuth flow.
                   <Note>
                     The channel you choose here doesn't matter as you can add/remove Deeptrace to any channel
                   </Note>
        2. In your alert channel, type `@Deeptrace` to invite the agent into the channel.
      </Accordion>

      <Accordion title="Datadog">
        1. Click **Connect** next to Datadog
        2. Find your Datadog site URL [**(docs)**](https://docs.datadoghq.com/getting_started/site/#:~:text=within%20their%20environments.-,Access%20the%20Datadog%20site,-You%20can%20identify)
        3. In Datadog, create both an [**API Key**](https://app.datadoghq.com/organization-settings/api-keys) and [**App Key**](https://app.datadoghq.com/organization-settings/application-keys). On each page: 
        4. Click **+ New Key**
        5. Name it deeptrace and click **Create Key**
        6. Click **Copy** and save the key to use below
                   <Note>
                     Note: Add these scopes to your Datadog App Key: `apm_read`, `dashboards_read`, `logs_read_data`, `logs_read_index_data`, `metrics_read`, `timeseries_query`, `monitors_read`, `rum_apps_read`(if you use rum)
                   </Note>
      </Accordion>

      <Accordion title="Sentry">
        1. Click **Connect** next to Sentry.
        2. Complete the OAuth flow and **deselect** Sentry Seer.
      </Accordion>

      <Accordion title="Grafana">
        Click **Connect** next to Grafana.

        **To get your Grafana URL:**

        1. Log in to your Grafana instance
        2. Copy the base URL from your browser (e.g., [https://mycompany.grafana.net](https://mycompany.grafana.net))
        3. Paste it into the **Grafana URL** field

        **To create a Service Account Token:**

        1. Go to **Administration → Users and access → Service accounts**
        2. Click **Add service account**
        3. Fill in the account details:
           * Display name: **deeptrace**
           * Role: **Viewer**
        4. Click **Create**
        5. Click **Add service account token**:
           * • Display name: **deeptrace-token**
           * • Expiration: **No Expiration**
        6. Click **Generate token**
        7. Copy the token and paste it into the **Service Account Token** field
      </Accordion>

      <Accordion title="Self-Hosted Grafana">
        1. Click **Connect** next to Self-Hosted Grafana.
        2. Follow our detailed [setup instructions](https://www.notion.so/Self-hosted-Grafana-MCP-2b7d7e5509208042b37cf964fd5c14ae) to connect your Self-Hosted Grafana MCP server.
      </Accordion>

      <Accordion title="AWS Cloudwatch">
        1. Click **Connect** next to AWS Cloudwatch.
        2. Go to the AWS CloudFormation console → **Create stack** → with new resources
        3. Specify the template as **Upload a template file**
        4. Upload the config.yaml file (download it using the button below)
        5. Click **Next**, enter stack name as **"deeptrace"**
        6. Click **Next**, acknowledge the capabilities checkbox, then click **Next**
        7. Click **Submit** to create the stack
        8. Once the stack creation completes *(this may take around 30 seconds to a minute)*, go to the **Outputs** tab
        9. Copy the **RoleArn** value and paste it in the field above
      </Accordion>

      <Accordion title="PagerDuty">
        1. Click **Connect** next to PagerDuty 
        2. Create a token in PagerDuty under **User Settings → API Access**.
        3. Copy and paste this into the Deeptrace UI.

        <Note>
          **Prerequisite:** Your team is on a paid PagerDuty plan.
        </Note>
      </Accordion>

      <Accordion title="Snowflake">
        Click **Connect** next to Snowflake.

        **To find your Account Identifier:**

        1. Log in to your Snowflake account
        2. Your account identifier is in the URL: `https://<account_identifier>.snowflakecomputing.com`
        3. Example: `YWKSTOS-BBB93431`

        **To create an OAuth integration:**

        1. In Snowflake, run the following SQL as an admin:
           ```text theme={null}
           CREATE OR REPLACE SECURITY INTEGRATION deeptrace_integration
             TYPE = OAUTH
             ENABLED = TRUE
             OAUTH_CLIENT = CUSTOM
             OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
             OAUTH_REDIRECT_URI = 'https://app.deeptrace.com/snowflake-connect'
             OAUTH_ISSUE_REFRESH_TOKENS = TRUE
             OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
             ENABLED = TRUE;
           ```
        2. Get the client credentials:
           ```text theme={null}
           SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('DEEPTRACE_INTEGRATION');
           ```
        3. Copy the **OAUTH\_CLIENT\_ID** and **OAUTH\_CLIENT\_SECRET** from the result
        4. Paste them into the fields on the Deeptrace UI
      </Accordion>

      <Accordion title="Honeycomb">
        Click **Connect** next to Honeycomb.

        **To get your Management API Key:**

        1. Go to **Team Settings** on Honeycomb
        2. Navigate to **API Keys**
        3. Click **Create Management API Key**
        4. Set the scope to **read-only** for environments and MCP
        5. Copy the **Secret Key** and paste it into the Secret Key field
        6. Copy the **Key ID** and paste it into the Key ID field
        7. Click **Connect Honeycomb**
      </Accordion>

      <Accordion title="Posthog">
        1. Click **Connect** next to Posthog.
        2. Go to the API keys page via this [**link**](https://us.posthog.com/project/235265/settings/user-api-keys)
        3. Click **Create personal API key** with the name **deeptrace**
        4. Configure the API key with read access for the following scopes: **Dashboards, Insights, Queries, Feature Flags, Experiments, Surveys, Error Tracking, Organization, Project, Events, Properties**
        5. Click **Create key** and copy the generated API key
        6. Paste it into the **API Key** field on the setup form
      </Accordion>

      <Accordion title="pganalyze">
        1. Click **Connect** next to pganalyze.
        2. Log in to your pganalyze account at [app.pganalyze.com](http://app.pganalyze.com)
        3. Navigate to **Settings → API Keys**
        4. Click **Create New API Key** (Read API Key)
        5. Copy the generated key and paste it into the **API Key** field

        **To find your Database IDs:**

        1. For each database you want to monitor:
           * Navigate to its dashboard page in pganalyze
           * Copy the number at the end of the URL
             * e.g. -123456789 in app.pganalyze.com/databases/-123456789
           * Enter each **Database ID** in the field and click Add
      </Accordion>

      <Accordion title="BYO MCP">
        1. Click **Add Custom MCP** next to Custom Integrations
        2. After clicking Add Custom MCP, create a **display name** for this integration
        3. Input the **streamable HTTP endpoint** of your MCP server
        4. Enter the **Auth Header Name**, the HTTP header name for authentication (e.g. "X-API-Key")
        5. Add the **Auth Secret**, this is the pre-shared secret or API key. This will be encrypted and stored securely.
        6. Provide a **description** on what this MCP does. This helps the agent understand when and how to use it.
      </Accordion>

      <Accordion title="Notion">
        1. Click **Connect** next to Notion
        2. Select the relevant pages to grant Deeptrace access to.
      </Accordion>

      <Accordion title="Linear">
        1. Click **Connect** next to Linear
        2. Select the teams to grant Deeptrace access to (public and select private teams).
      </Accordion>

      <Accordion title="New Relic">
        1.  Go to [**one.newrelic.com/api-keys**](https://one.newrelic.com/api-keys)
        2. Click **Create a key**
        3. Select **User** as the key type
        4. Give it a descriptive name (e.g., "Deeptrace Integration")
        5. Copy the key (starts with NRAK-)
        6. Select your region (US or EU based on your account location)

        The User API Key provides read access to your New Relic data for investigations.
      </Accordion>

      <Accordion title="Coralogix">
        1. Go to your Coralogix dashboard → Settings → Users and Teams → API Keys
        2. Click **+ Key** and select Team key type
        3. Give it a descriptive name (e.g., "Deeptrace Integration")
        4. From the Role Presets dropdown, select DataQuerying and Alerts
        5. Click **Create**, then copy and save the key
        6. Select your Coralogix region

        The Team API Key provides read access to your Coralogix logs, metrics, traces, and alerts for investigations.
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

<Note>
  **Don't see your integration listed?** Reach out to [sri@deeptrace.com](mailto:sri@deeptrace.com) to request a new integration.
</Note>

## Next steps

Now that you have your integrations, learn how to engage with Deeptrace in Slack and explore its key features.

<CardGroup cols={2}>
  <Card title="Guides" icon="book" href="/guide">
    Learn how to use Deeptrace
  </Card>

  <Card title="Features" icon="sparkles" href="/features">
    Explore the key features of Deeptrace
  </Card>
</CardGroup>