For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/do-query-actions.md. A documentation index is available at /llms.txt.

DO Query Actions

Supported OS Linux Windows Mac OS

Integration version1.1.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

Overview

The DO Query Actions check executes SQL queries against PostgreSQL and reports success/failure metrics. This check is designed to receive configuration via Remote Config and execute queries on demand.

Setup

Installation

The DO Query Actions check is included in the Datadog Agent package.

Configuration

  1. Edit the do_query_actions.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting metrics. See the sample do_query_actions.d/conf.yaml.example for all available configuration options.

  2. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for do_query_actions under the Checks section.

Data Collected

Metrics

do_query_actions.query_execution_time
(gauge)		The time taken to execute the query.
Shown as second
do_query_actions.query_status
(gauge)		Indicates the query execution status. 1 for success and 0 for failure.

Service Checks

No service checks are provided by this integration.

Events

Query results are sent as events via the do-query-results event track type, containing query output, execution metadata, and entity information.

Troubleshooting

Need help? Contact Datadog support.