Skip to main content
When you connect Datadog to Unblocked, Unblocked can reference incidents, logs, metrics, monitors, events, hosts, APM spans, and Real User Monitoring (RUM) events from your Datadog organization when answering questions about outages, alerts, and production issues. Unblocked provides links back to the original Datadog resources for easy reference. Unblocked discovers the available services and facets in your log data automatically, so log queries work without manual configuration.

​
Data sync

Unblocked syncs incidents from Datadog every 15 minutes, and an initial sync starts as soon as you connect. Private incidents aren’t synced. Logs, metrics, monitors, events, hosts, APM spans, and RUM events are queried directly from Datadog at the time you ask a question, so those answers always reflect live data.

​
Log storage tiers

Unblocked can search logs in Datadog’s Standard Indexing, Flex Logs, and Online Archives storage tiers. Unblocked searches Standard Indexing first. If nothing matches, it repeats the search in Flex Logs, so questions about logs older than your index retention can still be answered. Unblocked searches Online Archives only when your question asks for it.

​
APM spans and RUM events

Unblocked can count APM spans and RUM events, and break the counts down by facets such as app version, HTTP status code, or endpoint. Use this for questions like:
  • Is this error still happening on the latest app version?
  • How many sessions are on each app version?
  • Which endpoints return the most errors for a service?
Span counts come from indexed spans. Datadog samples indexed spans, so Unblocked reports them as indexed span counts, not as request volumes or error rates. RUM counts can be of events, sessions, or users. APM spans and RUM events each need an optional scope on your application key. See Connect Datadog.
Unblocked returns counts only. It doesn’t retrieve individual traces, spans, or RUM events.

​
Connect Datadog

1

Connect Datadog

In the Unblocked sidebar, click Settings, then Data Sources, then Connect another data source. Scroll to the Incident Management section and select Datadog.
2

Create an API Key

In Datadog, go to Organization Settings › API Keys and create a new API key.
3

Create an Application Key

In Datadog, go to Organization Settings › Application Keys and create a new application key with the following scopes:
  • events_read
  • incident_read
  • logs_read_data
  • timeseries_query
  • monitors_read
  • hosts_read
  • apm_service_catalog_read or service_catalog_read
  • user_access_read
For additional features, also add these optional scopes:
  • apm_read for APM spans
  • rum_apps_read for RUM events
Unblocked connects without the optional scopes, but it can’t answer questions about APM spans or RUM events until you add them. If you’ve already connected Datadog, add them to your existing application key.
4

Enter your keys and region

Paste the API key and application key into Unblocked, then select your Datadog region. If you’re not sure which region to choose, US1 is the default.Datadog keysClick Next.
5

Done

Unblocked will begin referencing your Datadog incidents, logs, metrics, and monitors in its answers.Datadog connected