Skip to main content

​
Datadog

ShanoneのDatadog連携は、可観測性を扱う39個のツールをエージェントに提供します。メトリクス、モニター、ダッシュボード、ログ、トレース、ホスト、SLO、ダウンタイム、Syntheticsが対象です。

​
はじめに

1

APIキーとApplicationキーを発行する

DatadogのOrganization Settings → API KeysでAPIキーを、Organization Settings → Application KeysでApplicationキーを作成します。両方が必須です。
2

認証情報をShanoneに登録する

Shanoneダッシュボードの連携を開き、Datadogを選択してAPIキーとApplicationキーの両方を入力します。
3

リクエストを再実行する

保存が完了すると、datadog_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはDatadog向けに39個のツールを、以下のカテゴリに整理して提供しています。
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

​
よくあるユースケース

インシデントトリアージ

発火中のモニターを取得し、直近のログ/トレースと関連付けて根本原因の可能性を要約する

Dashboard as Code

新しいサービスのSLIを反映するダッシュボードをプログラムで作成・更新する

メンテナンスウィンドウ

デプロイ前にダウンタイムを予約し、予定より早く完了した場合は前倒しでキャンセルする

コスト & 使用状況の追跡

使用状況サマリーを取得し、Datadogの利用料がどこに集中しているか把握する

​
トラブルシューティング

DatadogではAPIキーとApplicationキーの両方が必要です。監視専用のAPIキーだけでは、ここで提供している読み書き操作の多くには不十分です。連携ページで両方のフィールドが保存されているか確認してください。
まずdatadog_list_metricsでメトリクス名とタグが実在するか確認し、時間範囲(from/to)がそのメトリクスが実際に送信されていた期間と重なっているか確認してください。
ログの保持期間とインデックス化は対象のログインデックスの保持ポリシーに依存します。datadog_list_log_indexesで、検索対象のインデックスが指定した時間範囲のログを実際に保持しているか確認してください。