Datadog
Params
Section titled “Params”site string Optional The Datadog site to connect to. Choose the site that matches your Datadog organization.
Supported values:
datadoghq.com— US1 (default)us3.datadoghq.com— US3us5.datadoghq.com— US5datadoghq.eu— EU1ap1.datadoghq.com— AP1
indexes string[] Optional List of Datadog log index names to query. An empty list (the default) searches across all indexes (*).
query_prefix string Optional A Lucene query string that is always prepended to every search. Useful for scoping a connector to a specific service, environment, or team without requiring users to type it every time.
Example: service:my-service AND env:production
Examples
Section titled “Examples”Minimal Configuration
Section titled “Minimal Configuration”connectors: - type: datadog name: my_datadogWith a Specific Site
Section titled “With a Specific Site”connectors: - type: datadog name: my_datadog_eu params: site: "datadoghq.eu"Scoped to Specific Indexes and a Query Prefix
Section titled “Scoped to Specific Indexes and a Query Prefix”connectors: - type: datadog name: my_datadog params: site: "datadoghq.com" indexes: - "main" - "prod-logs" query_prefix: "env:production"Authentication
Section titled “Authentication”The Datadog adapter uses browser-session authentication. When you run a query for the first time, Cruncher opens a browser window pointing to your Datadog site. Log in as usual (including SSO/SAML if required), and Cruncher will automatically capture the session cookies and CSRF token it needs.
Once authenticated, the session is reused for all subsequent queries. If the session expires, Cruncher will automatically re-open the login window.
Facet Autocomplete
Section titled “Facet Autocomplete”Cruncher automatically fetches your Datadog log facets and index names to provide autocomplete suggestions in the query editor. Facets with a fixed set of values (e.g. status) are resolved directly; facets with dynamic values (e.g. kube_namespace) are populated by querying the top 10 most frequent values from the last 15 minutes.
Usage Notes
Section titled “Usage Notes”- The
indexesparam scopes queries to specific log indexes. Leave it empty to search all indexes. - The
query_prefixis combined with the QQL search term usingAND, so it always applies. - The
indexcontroller param (set inline in the QQL query bar) overrides theindexesconfig param for that query.