Docs · static mirror — the interactive version loads with JavaScript.

Datadog

Source: https://runstack.engineer/docs/toolkits/datadog

Logs, metrics, monitors, dashboards, APM, and on-call.

Tools (61):

ToolDescription
datadogAggregateLogsAggregate logs server-side without downloading raw events: counts, unique values, percentiles, stats, grouped breakdowns, or timeseries. Use datadogSearchLogs only when individual messages are needed.
datadogSearchLogsSearch 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.
datadogListLogIndexesList log index names and configs. Call before datadogSearchLogs to pick the right index and avoid hidden results or excess usage.
datadogListMetricsDiscover actively reporting metric names since a timestamp, optionally filtered by host or tags. Use before datadogQueryMetrics to find exact names.
datadogQueryMetricsQuery 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.
datadogSubmitMetricsSubmit custom gauge/rate/count series (KPIs, app metrics). Points default to the current time when timestamp is omitted.
datadogCreateMonitorCreate a monitor with alerting thresholds and notifications. The query syntax must match the monitor type exactly or creation fails.
datadogGetMonitorGet a monitor by ID with state, config, and optionally downtimes. Use datadogListMonitors to discover IDs.
datadogListMonitorsList monitors with name/tag/state filters. Set page and page_size together to paginate (pages start at 0); omit both for all monitors.
datadogUpdateMonitorUpdate a monitor; only provided fields change. Confirm query/type changes with the user first.
datadogDeleteMonitorPermanently delete a monitor. Irreversible — confirm with the user first.
datadogMuteMonitorMute a monitor to silence alerts during maintenance or deployments. Without end it stays muted until manually unmuted.
datadogUnmuteMonitorUnmute a monitor so alerting resumes immediately. Only unmute after maintenance or the issue is fully resolved to avoid alert storms.
datadogCreateDowntimeCreate a downtime to suppress alerts during maintenance or deployments. Scope to hosts, services, tags, or a monitor ID.
datadogCreateDashboardCreate 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.
datadogGetDashboardGet a dashboard by ID with widgets, layout, and template variables. Keep reflow_type and pause_auto_refresh from the response for round-trip updates.
datadogUpdateDashboardUpdate a dashboard; only provided fields change. Omit reflow_type and pause_auto_refresh to preserve existing values.
datadogDeleteDashboardPermanently delete a dashboard. Irreversible — confirm with the user first.
datadogListDashboardsList dashboards with shared/deleted filters and start/count pagination.
datadogCreateEventPost an event for deployments, outages, or config changes. Markdown is supported in text.
datadogListEventsList 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.
datadogListHostsList infrastructure hosts with metrics, tags, and status. Filter by tag query and sort by status, name, cpu, iowait, or load.
datadogGetHostTagsGet all tags for a host, optionally filtered by source (users, chef, puppet, aws, datadog).
datadogListAllTagsList all tags in use across the organization, optionally filtered by source. Use to discover tag keys for filters.
datadogUpdateHostTagsReplace all tags from one source on a host (defaults to users source). This overwrites — include the full desired tag set.
datadogListApmServicesList APM services for an environment with performance stats. Use env "*" for all environments. Requires APM instrumentation.
datadogSearchTracesSearch distributed traces for incident investigation and bottleneck analysis. Bound the window, include env and service, and prefix custom attributes with @. Paginate with page.cursor.
datadogSearchSpansAnalyticsAggregate 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.
datadogCreateSyntheticApiTestCreate a synthetic API test (http/ssl/tcp/dns/icmp) that monitors an endpoint from worldwide locations. Get location IDs from datadogGetSyntheticsLocations first.
datadogListSyntheticsList synthetic tests with client-side tag/location filtering and limit/offset pagination.
datadogGetSyntheticsLocationsList public and private synthetic locations. Use the IDs when creating synthetic tests.
datadogListIncidentsList incidents with state/severity/timeline data. Filter active incidents with filter_query state:active.
datadogCreateSloCreate a metric or monitor SLO with target thresholds. Metric SLOs need numerator/denominator queries; monitor SLOs need monitor IDs.
datadogListSlosList SLOs with tag, name/description, and limit/offset filters.
datadogListUsersList organization users with roles and access levels. Paginate with page_size/page_number.
datadogListRolesList organization roles (permission sets) with member counts. Filter by partial name match.
datadogGetUsageSummaryGet monthly billable usage (hosts, containers, API calls, logs) for cost monitoring. Empty payloads for inactive months are expected, not errors.
datadogListApiKeysList API key metadata (names, owners, last-used) for auditing and rotation planning. Handle output securely — restrict to authorized personnel.
datadogListAwsIntegrationsList configured AWS account integrations with roles and collection settings. Filter by account ID or IAM role name. Use to verify monitoring coverage.
datadogCreateWebhookRegister a named HTTPS destination for monitor alerts. Monitors must reference the webhook by name in their message/notification settings to deliver alerts.
datadogCreateEscalationPolicyCreate an On-Call escalation policy with steps (targets, assignment, timeouts), retries, and team links.
datadogGetEscalationPolicyGet an On-Call escalation policy by ID with steps and team links.
datadogUpdateEscalationPolicyUpdate an On-Call escalation policy by ID. The data object must include the policy id and full attributes.
datadogDeleteEscalationPolicyDelete an On-Call escalation policy by ID. Irreversible — confirm with the user first.
datadogCreateScheduleCreate an On-Call schedule with rotation layers (members, intervals, time restrictions) and team links.
datadogGetScheduleGet an On-Call schedule by ID with layers and team links.
datadogUpdateScheduleUpdate an On-Call schedule by ID. The data object must include the schedule id and full attributes.
datadogDeleteScheduleDelete an On-Call schedule by ID. Irreversible — confirm with the user first.
datadogGetScheduledOnCallUserGet the currently scheduled on-call user for a schedule. Use during incidents to find who to page.
datadogCreateNotificationChannelCreate an email or phone notification channel for a user (E.164 for phone, address+formats for email).
datadogGetNotificationChannelGet one notification channel for a user by channel ID.
datadogListNotificationChannelsList all notification channels configured for a user.
datadogDeleteNotificationChannelDelete a user notification channel. Irreversible — confirm with the user first.
datadogCreateNotificationRuleCreate a notification rule for a user: urgency category, delay, and the channel it routes to.
datadogGetNotificationRuleGet one notification rule for a user by rule ID.
datadogListNotificationRulesList all notification rules configured for a user.
datadogUpdateNotificationRuleUpdate a user notification rule by ID (category, delay, channel).
datadogDeleteNotificationRuleDelete a user notification rule. Irreversible — confirm with the user first.
datadogGetTeamOnCallUsersGet the current on-call users for an On-Call team. Use during incidents to find responders.
datadogGetTeamRoutingRulesGet the On-Call routing rules configured for a team.
datadogSetTeamRoutingRulesReplace the On-Call routing rules for a team. This overwrites all existing rules — confirm with the user first.