Datadog
Source: https://runstack.engineer/docs/toolkits/datadog
Logs, metrics, monitors, dashboards, APM, and on-call.
Tools (61):
| Tool | Description |
|---|---|
datadogAggregateLogs | Aggregate logs server-side without downloading raw events: counts, unique values, percentiles, stats, grouped breakdowns, or timeseries. Use datadogSearchLogs only when individual messages are needed. |
datadogSearchLogs | Search individual log messages with a query and millisecond time range. List indexes with datadogListLogIndexes first — a wrong or missing index silently hides logs. Paginate with the returned nextLogId. |
datadogListLogIndexes | List log index names and configs. Call before datadogSearchLogs to pick the right index and avoid hidden results or excess usage. |
datadogListMetrics | Discover actively reporting metric names since a timestamp, optionally filtered by host or tags. Use before datadogQueryMetrics to find exact names. |
datadogQueryMetrics | Query timeseries data with a metrics query string over a UTC seconds range (max 1 year). Use datadogListMetrics first to confirm names; millisecond timestamps silently return empty series. |
datadogSubmitMetrics | Submit custom gauge/rate/count series (KPIs, app metrics). Points default to the current time when timestamp is omitted. |
datadogCreateMonitor | Create a monitor with alerting thresholds and notifications. The query syntax must match the monitor type exactly or creation fails. |
datadogGetMonitor | Get a monitor by ID with state, config, and optionally downtimes. Use datadogListMonitors to discover IDs. |
datadogListMonitors | List monitors with name/tag/state filters. Set page and page_size together to paginate (pages start at 0); omit both for all monitors. |
datadogUpdateMonitor | Update a monitor; only provided fields change. Confirm query/type changes with the user first. |
datadogDeleteMonitor | Permanently delete a monitor. Irreversible — confirm with the user first. |
datadogMuteMonitor | Mute a monitor to silence alerts during maintenance or deployments. Without end it stays muted until manually unmuted. |
datadogUnmuteMonitor | Unmute a monitor so alerting resumes immediately. Only unmute after maintenance or the issue is fully resolved to avoid alert storms. |
datadogCreateDowntime | Create a downtime to suppress alerts during maintenance or deployments. Scope to hosts, services, tags, or a monitor ID. |
datadogCreateDashboard | Create a dashboard with widgets for unified monitoring views. For log/APM/RUM widget queries keep group_by inside the query object, not at request level. |
datadogGetDashboard | Get a dashboard by ID with widgets, layout, and template variables. Keep reflow_type and pause_auto_refresh from the response for round-trip updates. |
datadogUpdateDashboard | Update a dashboard; only provided fields change. Omit reflow_type and pause_auto_refresh to preserve existing values. |
datadogDeleteDashboard | Permanently delete a dashboard. Irreversible — confirm with the user first. |
datadogListDashboards | List dashboards with shared/deleted filters and start/count pagination. |
datadogCreateEvent | Post an event for deployments, outages, or config changes. Markdown is supported in text. |
datadogListEvents | List events in a seconds-epoch window. Start broad (few filters, narrow range) and narrow incrementally — combined filters on wide ranges can return empty or huge results. |
datadogListHosts | List infrastructure hosts with metrics, tags, and status. Filter by tag query and sort by status, name, cpu, iowait, or load. |
datadogGetHostTags | Get all tags for a host, optionally filtered by source (users, chef, puppet, aws, datadog). |
datadogListAllTags | List all tags in use across the organization, optionally filtered by source. Use to discover tag keys for filters. |
datadogUpdateHostTags | Replace all tags from one source on a host (defaults to users source). This overwrites — include the full desired tag set. |
datadogListApmServices | List APM services for an environment with performance stats. Use env "*" for all environments. Requires APM instrumentation. |
datadogSearchTraces | Search distributed traces for incident investigation and bottleneck analysis. Bound the window, include env and service, and prefix custom attributes with @. Paginate with page.cursor. |
datadogSearchSpansAnalytics | Aggregate span data (error rates, latency patterns) grouped by facets. The body must be a valid aggregate_request — when filter/compute cannot satisfy the schema, use datadogSearchTraces instead. |
datadogCreateSyntheticApiTest | Create a synthetic API test (http/ssl/tcp/dns/icmp) that monitors an endpoint from worldwide locations. Get location IDs from datadogGetSyntheticsLocations first. |
datadogListSynthetics | List synthetic tests with client-side tag/location filtering and limit/offset pagination. |
datadogGetSyntheticsLocations | List public and private synthetic locations. Use the IDs when creating synthetic tests. |
datadogListIncidents | List incidents with state/severity/timeline data. Filter active incidents with filter_query state:active. |
datadogCreateSlo | Create a metric or monitor SLO with target thresholds. Metric SLOs need numerator/denominator queries; monitor SLOs need monitor IDs. |
datadogListSlos | List SLOs with tag, name/description, and limit/offset filters. |
datadogListUsers | List organization users with roles and access levels. Paginate with page_size/page_number. |
datadogListRoles | List organization roles (permission sets) with member counts. Filter by partial name match. |
datadogGetUsageSummary | Get monthly billable usage (hosts, containers, API calls, logs) for cost monitoring. Empty payloads for inactive months are expected, not errors. |
datadogListApiKeys | List API key metadata (names, owners, last-used) for auditing and rotation planning. Handle output securely — restrict to authorized personnel. |
datadogListAwsIntegrations | List configured AWS account integrations with roles and collection settings. Filter by account ID or IAM role name. Use to verify monitoring coverage. |
datadogCreateWebhook | Register a named HTTPS destination for monitor alerts. Monitors must reference the webhook by name in their message/notification settings to deliver alerts. |
datadogCreateEscalationPolicy | Create an On-Call escalation policy with steps (targets, assignment, timeouts), retries, and team links. |
datadogGetEscalationPolicy | Get an On-Call escalation policy by ID with steps and team links. |
datadogUpdateEscalationPolicy | Update an On-Call escalation policy by ID. The data object must include the policy id and full attributes. |
datadogDeleteEscalationPolicy | Delete an On-Call escalation policy by ID. Irreversible — confirm with the user first. |
datadogCreateSchedule | Create an On-Call schedule with rotation layers (members, intervals, time restrictions) and team links. |
datadogGetSchedule | Get an On-Call schedule by ID with layers and team links. |
datadogUpdateSchedule | Update an On-Call schedule by ID. The data object must include the schedule id and full attributes. |
datadogDeleteSchedule | Delete an On-Call schedule by ID. Irreversible — confirm with the user first. |
datadogGetScheduledOnCallUser | Get the currently scheduled on-call user for a schedule. Use during incidents to find who to page. |
datadogCreateNotificationChannel | Create an email or phone notification channel for a user (E.164 for phone, address+formats for email). |
datadogGetNotificationChannel | Get one notification channel for a user by channel ID. |
datadogListNotificationChannels | List all notification channels configured for a user. |
datadogDeleteNotificationChannel | Delete a user notification channel. Irreversible — confirm with the user first. |
datadogCreateNotificationRule | Create a notification rule for a user: urgency category, delay, and the channel it routes to. |
datadogGetNotificationRule | Get one notification rule for a user by rule ID. |
datadogListNotificationRules | List all notification rules configured for a user. |
datadogUpdateNotificationRule | Update a user notification rule by ID (category, delay, channel). |
datadogDeleteNotificationRule | Delete a user notification rule. Irreversible — confirm with the user first. |
datadogGetTeamOnCallUsers | Get the current on-call users for an On-Call team. Use during incidents to find responders. |
datadogGetTeamRoutingRules | Get the On-Call routing rules configured for a team. |
datadogSetTeamRoutingRules | Replace the On-Call routing rules for a team. This overwrites all existing rules — confirm with the user first. |