Before You Connect
You’ll need an organization admin account in Decimal, plus a Datadog API key and Application key for the organization whose logs you want to query. Create the keys in Datadog’s Organization Settings; its key guide covers creation and scoping. Give the application key these log permissions:
The key’s owner must also have access to the logs you need. Check Datadog’s permissions reference if a scoped key still can’t read them.
Connect Datadog
- Open Settings → Integrations → Datadog in Decimal.
- Enter the API key and Application key.
- Select the Site where your Datadog organization lives. Match the region you use to sign in; don’t leave US1 selected if your organization is elsewhere.
- Click Connect. Decimal tests a log search before saving the connection.
- Check that Status reads Connected and that Site matches your organization.
Verify a Log Search
Open Datadog’s Log Explorer and find a recent log entry you can recognize. Note a distinctive message or request ID, the time range, and the index if you use more than one. In Playground, ask for that entry. Replace the placeholders with your own values:Search Datadog logs for “REQUEST_ID” between START_TIME and END_TIME in UTC, using index INDEX_NAME. Show the matching entries and the Log Explorer link.Compare the returned entries with Datadog. Open the Log Explorer link to check the query and time range. If the result is empty, use the same search in Datadog before changing permissions. For a support-ticket investigation that doesn’t query logs, check Logs Investigation under the Support Agent’s capabilities, if that section is available in your workspace.
Let Agents Read Feature Flags
Addfeature_flag_config_read and feature_flag_environment_config_read to the application key if you want the agent to inspect feature flag configuration. These permissions are separate from log access; Datadog’s flag permissions describe them.
On the connected Datadog page in Decimal, turn on Let agents read feature flags under Feature flags. Decimal checks access before saving the setting. If the switch won’t stay on, check both scopes and try again.
Then ask in Playground: “Find the Datadog feature flag FLAG_KEY and show its configuration for ENVIRONMENT.” Use a flag and environment you can compare with Datadog.
Troubleshoot the Connection
After correcting the problem, repeat the known-log search or feature flag lookup above. If it still fails, email us with the site, error text, time range, and the Decimal conversation or ticket URL. Leave keys out of the message.