Skip to content
TeamLoop

Datadog Integration

Connect Datadog to search monitors, events, and track alerting history across your infrastructure.

What You Can Query

Section titled “What You Can Query”
Content TypeDescription
MonitorsAlert definitions with status, thresholds, tags
EventsInfrastructure and application events
State ChangesMonitor alert/warn/OK transitions
TagsService and team metadata
ThresholdsMonitor configuration details

Connecting Datadog

Section titled “Connecting Datadog”

Datadog uses a composite credential: an API key, an application key, and your Datadog site.

  1. Log into TeamLoop at app.teamloop.io
  2. Navigate to Settings > Integrations
  3. Click Connect next to Datadog
  4. Enter your credentials as JSON: 
    {
      "api_key": "your-datadog-api-key",
      "app_key": "your-datadog-app-key",
      "site": "datadoghq.com"
    }
  5. TeamLoop validates the credentials and saves them encrypted

Creating Datadog Keys

Section titled “Creating Datadog Keys”

API Key:

  1. Go to Organization Settings > API Keys in Datadog
  2. Click New Key
  3. Name it (e.g., “TeamLoop”) and copy the key

Application Key:

  1. Go to Organization Settings > Application Keys in Datadog
  2. Click New Key
  3. Name it (e.g., “TeamLoop”) and copy the key

The site field identifies your Datadog region (e.g., datadoghq.com, datadoghq.eu, us5.datadoghq.com). Defaults to datadoghq.com if omitted. We never write to your Datadog account.

Example Queries

Section titled “Example Queries”

Search Monitors

Section titled “Search Monitors”
teamloop_query:
  query: "high CPU alert"
  sources: "datadog"

Find Recent Incidents

Section titled “Find Recent Incidents”
teamloop_query:
  query: "database latency spike"
  sources: "datadog"

Track Service Health

Section titled “Track Service Health”
teamloop_query:
  query: "payment service errors"
  sources: "datadog"

Automatic Change Tracking

Section titled “Automatic Change Tracking”

TeamLoop automatically tracks changes from Datadog via the events API.

Monitor Timeline

Section titled “Monitor Timeline”

When you query a monitor, TeamLoop fetches its state change history (last 30 days):

  • Alert transitions (OK, Warn, Alert)
  • Recovery events
  • Trigger events with details
  • Escalation context

Event Activity

Section titled “Event Activity”

Infrastructure and application events are captured with:

  • Event title and description
  • Source type and host
  • Alert type classification
  • Timestamps

Entity Extraction

Section titled “Entity Extraction”

Datadog content maps to TeamLoop entity types:

Datadog ContentTeamLoop Entity
MonitorDOCUMENT
EventDOCUMENT
State changeCHANGE
Monitor creatorPERSON
Service tagCOMPONENT

Temporal Queries with Datadog

Section titled “Temporal Queries with Datadog”

Point-in-Time

Section titled “Point-in-Time”

See what monitors and events were known on a specific date:

teamloop_query:
  query: "production alerts"
  sources: "datadog"
  mode: "as_of"
  as_of: "2024-06-01"

Evolution

Section titled “Evolution”

Track how alerting patterns evolved over a quarter:

teamloop_evolution:
  query: "database monitors"
  from_date: "2024-01-01"
  to_date: "2024-03-31"

Troubleshooting

Section titled “Troubleshooting”

No Results

Section titled “No Results”
  • Verify the Datadog integration is connected
  • Check that your API and application keys are valid
  • Try broader search terms
  • Monitor search matches on monitor names

Authentication Errors

Section titled “Authentication Errors”
  • Verify both API key and application key are active
  • Ensure the application key has read permissions
  • Confirm the site field matches your Datadog region

Security

Section titled “Security”
  • Credentials are encrypted at rest using pgcrypto
  • API keys can be revoked from Datadog Organization Settings
  • TeamLoop only reads, never writes
  • You can disconnect at any time from TeamLoop settings
  • Connected credentials show a hint so you can identify which keys are in use

Next Steps

Section titled “Next Steps”