Skip to main content

​
How to setup Deeptrace

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

Create your Deeptrace account

Click here to log in to your new workspace and follow our authentication flow.
2

Connect your Integrations

Click here to go to the integrations page and then follow the setup steps for your tools below.
  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.
  1. Click **Connect **next to Slack and complete the OAuth flow.
    The channel you choose here doesn’t matter as you can add/remove Deeptrace to any channel
  2. In your alert channel, type @Deeptrace to invite the agent into the channel.
  1. Click **Connect **next to Datadaog.
  2. Find your Datadog site URL (docs)
  3. In Datadog, create both an API Key and App Key. 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: 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)
  1. Click Connect next to Sentry.
  2. Complete the OAuth flow and deselct Sentry Seer.
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)
  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
  1. Click Connect next to Self-Hosted Grafana.
  2. Follow our detailed setup instructions to connect your Self-Hosted Grafana MCP server.
  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
  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.
Prerequisite: Your team is on a paid PagerDuty plan.
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: 
    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: 
    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
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
  1. Click **Connect **next to Posthog.
  2. Go to the API keys page via this link
  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
  1. Click Connect next to pganalyze.
  2. Log in to your pganalyze account at 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
  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.
  1. Click Connect next to Notion
  2. Select the relevant pages to grant Deeptrace access to
  1. Click Connect next to Linear
  2. Select the teams to grant Deeptrace access to (public and select private teams)
Don’t see your integration listed? Reach out to [email protected] to request a new integration.

​
Next steps

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

Guides

Learn how to use Deeptrace

Features

Explore the key features of Deeptrace