Skip to main content

​
Datadog

Shanone’s Datadog integration gives your agent 39 tools for observability: metrics, monitors, dashboards, logs, traces, hosts, SLOs, downtimes, and synthetics.

​
Getting Started

1

Generate an API Key and Application Key

In Datadog, go to Organization Settings → API Keys to create an API Key, and Organization Settings → Application Keys for an Application Key. Both are required together.
2

Add credentials to Shanone

Open Integrations in the Shanone dashboard, select Datadog, and enter both the API Key and Application Key.
3

Retry your request

Once saved, shanone_execute_tool calls for datadog_* tools will succeed.

​
Available Tools

Shanone provides 39 tools for Datadog, organized into these categories:
datadog_create_monitor, datadog_get_monitor, datadog_list_monitors, datadog_update_monitor, datadog_delete_monitor, datadog_mute_monitor, datadog_unmute_monitor
datadog_create_dashboard, datadog_get_dashboard, datadog_list_dashboards, datadog_update_dashboard, datadog_delete_dashboard
datadog_query_metrics, datadog_list_metrics, datadog_submit_metrics, datadog_get_metric_metadata, datadog_update_metric_metadata
datadog_search_logs, datadog_list_log_indexes, datadog_aggregate_logs
datadog_search_traces, datadog_get_trace_by_id, datadog_search_spans_analytics, datadog_list_apm_services, datadog_get_service_dependencies, datadog_get_service_summary
datadog_create_downtime, datadog_list_downtimes, datadog_cancel_downtime, datadog_create_event, datadog_list_events
datadog_create_slo, datadog_list_slos, datadog_create_synthetic_api_test, datadog_list_synthetics, datadog_get_synthetics_locations
datadog_list_hosts, datadog_get_host_tags, datadog_list_all_tags, datadog_update_host_tags
datadog_create_webhook, datadog_list_webhooks, datadog_get_usage_summary

​
Common Use Cases

Incident triage

Pull firing monitors, correlate with recent logs/traces, and summarize likely root cause

Dashboard-as-code

Programmatically create or update dashboards to reflect a new service’s SLIs

Maintenance windows

Schedule a downtime before a deploy and cancel it early if the deploy finishes ahead of schedule

Cost & usage tracking

Pull usage summaries to understand where Datadog billing is concentrated

​
Troubleshooting

Datadog requires both an API Key and an Application Key together — a monitoring-only API Key alone isn’t sufficient for most read/write operations exposed here. Check both fields are saved in Integrations.
Confirm the metric name and tags exist by checking datadog_list_metrics first, and make sure the time range (from/to) actually overlaps with when the metric was reported.
Log retention and indexing are governed by the target log index’s retention policy — check datadog_list_log_indexes to confirm the index being searched actually retains logs for the requested time range.