対応プラットフォーム
前提条件
Datadog APIキーとスコープ付きアプリケーションキーが必要です。 APIキーの作成:- Datadogアカウントで Organization Settings → API Keys に移動します。
- + New Key をクリックし、名前(例:
CloudThinker)を付けて保存します。 - キーの値をコピーします。
- Organization Settings → Application Keys に移動します。
- + New Key をクリックし、名前(例:
CloudThinker)を付けます。 - Scopes で必要な権限に記載された権限を選択します。
- 保存してキーの値をコピーします。
セットアップ
1
CloudThinkerを開く
CloudThinkerワークスペースで Connections → Datadog に移動します。
2
Datadogサイトを選択
アカウントに合ったDatadogサイトを選択します(例:
datadoghq.com はUS1、datadoghq.eu はEU1)。3
APIキーを入力
Datadog APIキーを貼り付けます。
4
アプリケーションキーを入力
Datadog アプリケーションキーを貼り付けます。
5
接続
Connect をクリックします。CloudThinkerが認証情報を検証し、Connected ステータスを表示します。
接続の詳細
必要な権限
アプリケーションキー作成時に以下のスコープを選択してください。読み取りスコープはすべての調査ツールをカバーします。notebooks_write はオプションでノートブック作成を有効にします。
エージェント機能
接続後、エージェントはDatadog環境全体で読み取りおよび書き込み操作を実行できます。接続を確認
プロンプト例
トラブルシューティング
接続テストが403で失敗
接続テストが403で失敗
APIキーが有効で失効していないことを確認してください。アプリケーションキーが必要なスコープを持ち、両方のキーが同じDatadog組織に属していることを確認してください。
接続後にデータが表示されない
接続後にデータが表示されない
アプリケーションキーのスコープにクエリしているデータタイプが含まれているか確認してください(例: ログの場合は
logs_read_data)。Datadogの保持期間の設定を確認し、サービスまたはホストがデータを積極的に送信していることを確認してください。Datadogサイトの選択を間違えた
Datadogサイトの選択を間違えた
クエリが空の結果を返す場合、間違ったサイトを選択している可能性があります。DatadogのURLを確認してください。
app.datadoghq.com はUS1、us3.datadoghq.com はUS3、app.datadoghq.eu はEU1です。切断してから正しいサイトで再接続してください。APIキーとアプリケーションキーの混乱
APIキーとアプリケーションキーの混乱
両方のキーが必要で、それぞれ異なる役割を持ちます。APIキーはリクエストを認証します。アプリケーションキーはエージェントがアクセスできるDatadogの機能とデータを制御します。どちらか一方だけでは不十分です。
セキュリティ
- 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
- デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
- 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
- オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
- スコープ付きアプリケーションキー — 常に明示的なスコープを指定してください。スコープなしのキーは作成者の全権限を継承します。
- 統合ごとに別々のキー — CloudThinker用に専用のAPIキーとアプリケーションキーを作成して、独立して失効できるようにしてください。
関連情報
Grafana 接続
代替メトリクスとダッシュボード
PagerDuty 接続
インシデントアラートとオンコール管理