DDSQL Editor

Join the Preview!

Querying Logs, Metrics, Spans, and RUM through DDSQL is in Preview. Use this form to request access. If you want access to Spans, RUM, or other data sources not listed in the use cases section, mention them in the access request form.

Request Access

Overview

With DDSQL Editor, you can get deeper visibility into your infrastructure by querying your resources with natural language or with DDSQL, a dialect of SQL with additional support for querying tags.

The result of a SQL query showing cloud provider host count on the DDSQL page in Datadog

Query in natural language

Type your question into the search box, and Datadog builds the SQL query for you. If you haven’t already, reach out to support to enable this feature.

A query inputted into the natural language search box

Use SQL syntax (DDSQL)

DDSQL is a query language for Datadog data. It implements several standard SQL operations, such as SELECT, and allows queries against unstructured data, such as tags. Get exactly the data you want by writing your own SELECT statement. Query tags as if they are standard table columns. For more information, see the DDSQL Reference.

SELECT instance_type, count(instance_type)
FROM aws.ec2_instance
WHERE tags->'region' = 'us-east-1' -- region is a tag, not a column
GROUP BY instance_type

Explore your telemetry

Querying Logs, Metrics, Spans, and RUM through DDSQL is in Preview. Use this form to request access.

If you want access to Spans, RUM, or other data sources not listed in the use cases section, mention them in the access request form.

View, filter, and built queries in the Data Explorer.

Side panel showing a list of available tables for querying in the DDSQL Editor

Click a table name to view its columns and relationships:

The data tab showing table information for aws.ec2_instance

For data sources such as Logs, use the query builder to generate table functions.

Save useful queries for future reference or download the data as CSV.

DDSQL Editor interface showing query results with save and export options highlighted

Export a saved query to a dashboard by clicking Save to Dashboard. From a dashboard you can visualize results and send Scheduled Reports.

Browse and re-run recent or saved queries in the side panel.

Side panel showing the Queries tab with a list of saved and recent queries in the DDSQL Editor

Permissions

To access the DDSQL Editor app, users need the ddsql_editor_read permission. This permission is included in the Datadog Read Only Role by default. If your organization uses custom roles, add this permission to the appropriate role. For more information on managing permissions, see the RBAC documentation.