> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Datadog

> Datadog offers monitoring, observability, and security for cloud-scale applications, unifying metrics, logs, and traces to help teams detect issues and optimize performance

Datadog offers monitoring, observability, and security for cloud-scale applications, unifying metrics, logs, and traces to help teams detect issues and optimize performance

`datadog` · **65 tools** · no triggers

## Connect it

```bash theme={"theme":"github-dark"}
run auth datadog
run auth datadog --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run datadog          # common commands
run datadog --all    # every command
```

```ts theme={"theme":"github-dark"}
import { datadog } from "@boxd/run";
```

## Common tools

| Tool                         | What it does                                                                                                                                                               |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `aggregate-logs`             | Aggregate Datadog logs without downloading raw events. Use for counts, unique values, percentiles, numeric statistics, grouped breakdowns, and values over time.           |
| `create-dashboard`           | Create a dashboard in Datadog. Dashboards provide customizable visualizations for monitoring your infrastructure, applications, and business metrics in a unified view.    |
| `create-downtime`            | Creates a new downtime in Datadog to suppress alerts during maintenance windows or planned outages.                                                                        |
| `create-escalation-policy`   | Creates a Datadog On-Call escalation policy.                                                                                                                               |
| `create-monitor`             | Creates a new Datadog monitor to track metrics, logs, or other data sources with configurable alerting thresholds and notifications.                                       |
| `create-schedule`            | Creates a Datadog On-Call schedule.                                                                                                                                        |
| `create-slo`                 | Create a Service Level Objective (SLO) in Datadog. SLOs help you define and track reliability targets for your services, enabling data-driven...                           |
| `create-synthetic-api-test`  | Create a synthetic API test in Datadog. Creates a new synthetic API test that continuously monitors API endpoints from multiple locations worldwide.                       |
| `create-webhook`             | Create a webhook in Datadog. Registers a named destination endpoint; each monitor must explicitly reference the webhook by name in its message or...                       |
| `delete-dashboard`           | Delete a dashboard in Datadog. Permanently removes a dashboard from your organization.                                                                                     |
| `get-dashboard`              | Get a specific dashboard from Datadog. Retrieves detailed information about a dashboard including its widgets, layout, template variables, and metadata.                   |
| `get-schedule`               | Retrieves a Datadog On-Call schedule by ID.                                                                                                                                |
| `get-service-dependencies`   | Get service dependency mapping from Datadog APM. This action retrieves the dependency graph for a specific service, showing both upstream services...                      |
| `get-synthetics-locations`   | Tool to retrieve all available public and private locations for Synthetic tests in Datadog.                                                                                |
| `get-tags`                   | Retrieves all tags associated with a specific host in Datadog.                                                                                                             |
| `get-trace-by-id`            | DEPRECATED: Use DATADOG\_SEARCH\_TRACES instead. Get detailed information about a specific trace by its ID.                                                                |
| `list-all-tags`              | List all tags from Datadog. Tags help organize and filter your infrastructure and applications.                                                                            |
| `list-api-keys`              | List API keys in Datadog. Retrieves all API keys in the organization for security auditing, access management, and key rotation planning.                                  |
| `list-apm-services`          | List APM services from Datadog. Application Performance Monitoring (APM) provides deep visibility into your applications, helping you track...                             |
| `list-aws-integration`       | List AWS integrations in Datadog. Retrieves all configured AWS account integrations, showing which AWS accounts are monitored by Datadog and their configuration settings. |
| `list-incidents`             | List incidents from Datadog. Incident Management helps you track, manage, and resolve incidents efficiently with comprehensive timeline and impact tracking.               |
| `list-log-indexes`           | Tool to retrieve a list of all log indexes configured in Datadog, including their names and configurations.                                                                |
| `list-metrics`               | Discover metric names by listing actively reporting metrics since a given timestamp.                                                                                       |
| `list-monitors`              | Get all monitor details. This endpoint allows you to retrieve information about all monitors configured in your organization.                                              |
| `list-notification-channels` | Lists the On-Call notification channels configured for a Datadog user.                                                                                                     |

<Accordion title="All 65 tools" icon="list">
  | Tool                          | What it does                                                                                                                                                               |
  | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `aggregate-logs`              | Aggregate Datadog logs without downloading raw events. Use for counts, unique values, percentiles, numeric statistics, grouped breakdowns, and values over time.           |
  | `create-dashboard`            | Create a dashboard in Datadog. Dashboards provide customizable visualizations for monitoring your infrastructure, applications, and business metrics in a unified view.    |
  | `create-downtime`             | Creates a new downtime in Datadog to suppress alerts during maintenance windows or planned outages.                                                                        |
  | `create-escalation-policy`    | Creates a Datadog On-Call escalation policy.                                                                                                                               |
  | `create-event`                | Creates a new event in Datadog. Events are useful for tracking deployments, outages, configuration changes, and other important occurrences.                               |
  | `create-monitor`              | Creates a new Datadog monitor to track metrics, logs, or other data sources with configurable alerting thresholds and notifications.                                       |
  | `create-notification-channel` | Creates an On-Call notification channel for a Datadog user.                                                                                                                |
  | `create-notification-rule`    | Creates an On-Call notification rule for a Datadog user.                                                                                                                   |
  | `create-schedule`             | Creates a Datadog On-Call schedule.                                                                                                                                        |
  | `create-slo`                  | Create a Service Level Objective (SLO) in Datadog. SLOs help you define and track reliability targets for your services, enabling data-driven...                           |
  | `create-synthetic-api-test`   | Create a synthetic API test in Datadog. Creates a new synthetic API test that continuously monitors API endpoints from multiple locations worldwide.                       |
  | `create-webhook`              | Create a webhook in Datadog. Registers a named destination endpoint; each monitor must explicitly reference the webhook by name in its message or...                       |
  | `delete-dashboard`            | Delete a dashboard in Datadog. Permanently removes a dashboard from your organization.                                                                                     |
  | `delete-escalation-policy`    | Deletes a Datadog On-Call escalation policy by ID. This action cannot be undone.                                                                                           |
  | `delete-monitor`              | Deletes a Datadog monitor permanently. Use with caution as this action cannot be undone.                                                                                   |
  | `delete-notification-channel` | Deletes an On-Call notification channel for a Datadog user. This action cannot be undone.                                                                                  |
  | `delete-notification-rule`    | Deletes an On-Call notification rule for a Datadog user. This action cannot be undone.                                                                                     |
  | `delete-schedule`             | Deletes a Datadog On-Call schedule by ID. This action cannot be undone.                                                                                                    |
  | `get-dashboard`               | Get a specific dashboard from Datadog. Retrieves detailed information about a dashboard including its widgets, layout, template variables, and metadata.                   |
  | `get-escalation-policy`       | Retrieves a Datadog On-Call escalation policy by ID.                                                                                                                       |
  | `get-monitor`                 | Retrieves detailed information about a specific Datadog monitor, including its current state, configuration, and any active downtimes.                                     |
  | `get-notification-channel`    | Retrieves an On-Call notification channel for a user by ID.                                                                                                                |
  | `get-notification-rule`       | Retrieves an On-Call notification rule for a user by ID.                                                                                                                   |
  | `get-schedule`                | Retrieves a Datadog On-Call schedule by ID.                                                                                                                                |
  | `get-scheduled-on-call-user`  | Gets the currently scheduled on-call user for a Datadog On-Call schedule.                                                                                                  |
  | `get-service-dependencies`    | Get service dependency mapping from Datadog APM. This action retrieves the dependency graph for a specific service, showing both upstream services...                      |
  | `get-synthetics-locations`    | Tool to retrieve all available public and private locations for Synthetic tests in Datadog.                                                                                |
  | `get-tags`                    | Retrieves all tags associated with a specific host in Datadog.                                                                                                             |
  | `get-team-on-call-users`      | Gets the current on-call users for a Datadog On-Call team.                                                                                                                 |
  | `get-team-routing-rules`      | Gets the Datadog On-Call routing rules configured for a team.                                                                                                              |
  | `get-trace-by-id`             | DEPRECATED: Use DATADOG\_SEARCH\_TRACES instead. Get detailed information about a specific trace by its ID.                                                                |
  | `get-usage-summary`           | Retrieves usage summary information from Datadog including API calls, hosts, containers, and other billable usage metrics.                                                 |
  | `list-all-tags`               | List all tags from Datadog. Tags help organize and filter your infrastructure and applications.                                                                            |
  | `list-api-keys`               | List API keys in Datadog. Retrieves all API keys in the organization for security auditing, access management, and key rotation planning.                                  |
  | `list-apm-services`           | List APM services from Datadog. Application Performance Monitoring (APM) provides deep visibility into your applications, helping you track...                             |
  | `list-aws-integration`        | List AWS integrations in Datadog. Retrieves all configured AWS account integrations, showing which AWS accounts are monitored by Datadog and their configuration settings. |
  | `list-dashboards`             | Lists all Datadog dashboards with basic information. Useful for dashboard management and getting an overview of available dashboards.                                      |
  | `list-events`                 | Lists events from Datadog within a specified time range. Events track important occurrences like deployments, outages, and configuration changes.                          |
  | `list-hosts`                  | Lists all hosts in your Datadog infrastructure with detailed information including metrics, tags, and status.                                                              |
  | `list-incidents`              | List incidents from Datadog. Incident Management helps you track, manage, and resolve incidents efficiently with comprehensive timeline and impact tracking.               |
  | `list-log-indexes`            | Tool to retrieve a list of all log indexes configured in Datadog, including their names and configurations.                                                                |
  | `list-metrics`                | Discover metric names by listing actively reporting metrics since a given timestamp.                                                                                       |
  | `list-monitors`               | Get all monitor details. This endpoint allows you to retrieve information about all monitors configured in your organization.                                              |
  | `list-notification-channels`  | Lists the On-Call notification channels configured for a Datadog user.                                                                                                     |
  | `list-notification-rules`     | Lists the On-Call notification rules configured for a Datadog user.                                                                                                        |
  | `list-roles`                  | List roles from Datadog organization. Roles define sets of permissions that control what users can do within your Datadog organization.                                    |
  | `list-service-checks`         | Lists service checks from Datadog. Service checks are status checks that track the health of your services and infrastructure components.                                  |
  | `list-sl-os`                  | List Service Level Objectives (SLOs) from Datadog. Service Level Objectives help you track the reliability and performance of your services by...                          |
  | `list-synthetics`             | List Synthetics tests from Datadog. Synthetics monitoring allows you to proactively monitor your applications and APIs by simulating user...                               |
  | `list-users`                  | List users from Datadog organization. User management allows you to see team members, their roles, and access levels within your Datadog organization.                     |
  | `list-webhooks`               | List webhooks from Datadog. Webhooks allow you to send notifications to external services when monitors trigger, enabling integration with your workflows.                 |
  | `mute-monitor`                | Mute a monitor in Datadog. Temporarily silences alerts from a monitor, which is useful during maintenance windows, deployments, or when investigating...                   |
  | `query-metrics`               | Queries Datadog metrics and returns time series data. Useful for retrieving historical metric data, creating custom dashboards, or building reports.                       |
  | `search-logs`                 | Searches Datadog logs with advanced filtering capabilities. IMPORTANT NOTES: - Sort parameter is NOT supported by the Datadog Logs API and will cause...                   |
  | `search-spans-analytics`      | Search and analyze span data with aggregations in Datadog. This action uses the Datadog Spans Analytics API to perform advanced queries and...                             |
  | `search-traces`               | Search for traces in Datadog APM. This action allows you to search for distributed traces across your services.                                                            |
  | `set-team-routing-rules`      | Replaces (sets) the On-Call routing rules for a Datadog team.                                                                                                              |
  | `submit-metrics`              | Submits custom metrics to Datadog. Useful for sending application-specific metrics, business KPIs, or custom performance indicators.                                       |
  | `unmute-monitor`              | Unmute a monitor in Datadog. Re-enables alerts from a previously muted monitor, returning it to normal monitoring and alerting behavior.                                   |
  | `update-dashboard`            | Update a dashboard in Datadog. Updates an existing dashboard with new configuration, widgets, or layout while preserving its identity and creation metadata.               |
  | `update-escalation-policy`    | Updates a Datadog On-Call escalation policy by ID.                                                                                                                         |
  | `update-host-tags`            | Updates tags for a specific host in Datadog. This replaces all existing tags from the specified source with the new tags provided.                                         |
  | `update-monitor`              | Updates an existing Datadog monitor with new configuration, thresholds, or notification settings.                                                                          |
  | `update-notification-rule`    | Updates an On-Call notification rule for a user by ID.                                                                                                                     |
  | `update-schedule`             | Updates a Datadog On-Call schedule by ID.                                                                                                                                  |
</Accordion>

[Open Datadog in the console →](https://app.boxd.sh/integrations/detail/datadog)
