> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Datadog

> ログ検索・メトリクスクエリ・インフラストラクチャ監視・インシデント調査のためにDatadogをCloudThinkerに接続します

Datadogアカウントを接続することで、CloudThinkerエージェントがスタック全体でログの検索、メトリクスのクエリ、インフラストラクチャの監視、インシデントの調査を行えるようになります。Datadogは**APIキー**と**スコープ付きアプリケーションキー**のペアで認証します。

***

## 対応プラットフォーム

| サイト     | URL                 |
| ------- | ------------------- |
| **US1** | `app.datadoghq.com` |
| **US3** | `us3.datadoghq.com` |
| **US5** | `us5.datadoghq.com` |
| **EU1** | `app.datadoghq.eu`  |
| **AP1** | `ap1.datadoghq.com` |
| **AP2** | `ap2.datadoghq.com` |

<Warning>
  GovCloud（US1-FED）はDatadog MCPサーバーではサポートされていません。
</Warning>

***

## 前提条件

**Datadog APIキー**と**スコープ付きアプリケーションキー**が必要です。

**APIキーの作成:**

1. Datadogアカウントで **Organization Settings → API Keys** に移動します。
2. **+ New Key** をクリックし、名前（例: `CloudThinker`）を付けて保存します。
3. キーの値をコピーします。

**スコープ付きアプリケーションキーの作成:**

1. **Organization Settings → Application Keys** に移動します。
2. **+ New Key** をクリックし、名前（例: `CloudThinker`）を付けます。
3. **Scopes** で[必要な権限](#必要な権限)に記載された権限を選択します。
4. 保存してキーの値をコピーします。

<Tip>
  スコープなしのキーの代わりに、常にスコープ付きのアプリケーションキーを使用してください。スコープなしのキーは、作成者ユーザーのすべての権限を継承します。
</Tip>

***

## セットアップ

<Steps>
  <Step title="CloudThinkerを開く">
    CloudThinkerワークスペースで **Connections → Datadog** に移動します。
  </Step>

  <Step title="Datadogサイトを選択">
    アカウントに合ったDatadogサイトを選択します（例: `datadoghq.com` はUS1、`datadoghq.eu` はEU1）。
  </Step>

  <Step title="APIキーを入力">
    Datadog **APIキー**を貼り付けます。
  </Step>

  <Step title="アプリケーションキーを入力">
    Datadog **アプリケーションキー**を貼り付けます。
  </Step>

  <Step title="接続">
    **Connect** をクリックします。CloudThinkerが認証情報を検証し、**Connected** ステータスを表示します。
  </Step>
</Steps>

***

## 接続の詳細

| フィールド               | 説明                           | 例                     |
| ------------------- | ---------------------------- | --------------------- |
| **Site**            | アカウントに合ったDatadogサイト          | `US1 (datadoghq.com)` |
| **API Key**         | Datadog APIキー                | —                     |
| **Application Key** | 明示的なスコープを持つDatadogアプリケーションキー | —                     |

***

## 必要な権限

アプリケーションキー作成時に以下のスコープを選択してください。読み取りスコープはすべての調査ツールをカバーします。`notebooks_write` はオプションでノートブック作成を有効にします。

| スコープ                                     | 有効になる機能                    |
| ---------------------------------------- | -------------------------- |
| `logs_read_data`, `logs_read_index_data` | ログの検索と分析                   |
| `metrics_read`, `timeseries_query`       | メトリクスと時系列データのクエリ           |
| `monitors_read`                          | ステータスとタグでモニターを検索           |
| `incidents_read`                         | インシデントの検索と詳細取得             |
| `dashboards_read`                        | ダッシュボード設定の検査               |
| `hosts_read`                             | インフラストラクチャホストの一覧表示と検査      |
| `apm_read`                               | トレースの取得とAPMスパンの検索          |
| `apm_service_catalog_read`               | サービスの一覧表示と依存関係のマッピング       |
| `events_read`                            | プラットフォームとカスタムイベントの検索       |
| `notebooks_read`                         | 調査ノートブックの検索と取得             |
| `rum_apps_read`                          | Real User Monitoringデータの検索 |
| `notebooks_write`                        | 調査ノートブックの作成と編集（オプション）      |

<Tip>
  読み取りスコープのみから始めてください。エージェントが調査ノートブックを作成する必要があるワークフローにのみ `notebooks_write` を追加してください。
</Tip>

***

## エージェント機能

接続後、エージェントはDatadog環境全体で読み取りおよび書き込み操作を実行できます。

| 機能              | エージェントができること                             |
| --------------- | ---------------------------------------- |
| **ログ**          | サービスと環境をまたいでログを検索し、パターンとトレンドを分析          |
| **メトリクス**       | 利用可能なメトリクスを検索し、時系列データをクエリし、メトリクスメタデータを取得 |
| **モニター**        | ステータス、名前、またはタグでモニターを検索                   |
| **インシデント**      | アクティブおよび解決済みのインシデントを検索し、完全なインシデント詳細を取得   |
| **ダッシュボード**     | ダッシュボード設定を検索・検査                          |
| **インフラストラクチャー** | インフラストラクチャ全体のホストを一覧表示・検査                 |
| **APM**         | 分散トレースを取得し、レイテンシー分析のためにスパンを検索            |
| **サービスカタログ**    | サービスを一覧表示し、サービス依存関係をマッピング                |
| **イベント**        | プラットフォームとカスタムイベントを検索                     |
| **ノートブック**      | 調査ノートブックを検索・取得・作成・編集                     |
| **RUM**         | Real User Monitoringデータを検索               |
| **接続ヘルス**       | Datadog接続が正常に動作しているか確認                   |

<Warning>
  ノートブックの書き込み操作は実行前にユーザーの承認が必要です。
</Warning>

### 接続を確認

```text theme={null}
@alex run the Datadog connection health check and summarize active monitors and host count
```

### プロンプト例

```text theme={null}
@alex search for error logs in the production environment from the last 15 minutes
@alex check for active Datadog incidents and investigate root causes
@alex analyze APM traces for the checkout service and identify latency bottlenecks
```

***

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

<Accordion title="接続テストが403で失敗">
  APIキーが有効で失効していないことを確認してください。アプリケーションキーが必要なスコープを持ち、両方のキーが同じDatadog組織に属していることを確認してください。
</Accordion>

<Accordion title="接続後にデータが表示されない">
  アプリケーションキーのスコープにクエリしているデータタイプが含まれているか確認してください（例: ログの場合は `logs_read_data`）。Datadogの保持期間の設定を確認し、サービスまたはホストがデータを積極的に送信していることを確認してください。
</Accordion>

<Accordion title="Datadogサイトの選択を間違えた">
  クエリが空の結果を返す場合、間違ったサイトを選択している可能性があります。DatadogのURLを確認してください。`app.datadoghq.com` はUS1、`us3.datadoghq.com` はUS3、`app.datadoghq.eu` はEU1です。切断してから正しいサイトで再接続してください。
</Accordion>

<Accordion title="APIキーとアプリケーションキーの混乱">
  両方のキーが必要で、それぞれ異なる役割を持ちます。**APIキー**はリクエストを認証します。**アプリケーションキー**はエージェントがアクセスできるDatadogの機能とデータを制御します。どちらか一方だけでは不十分です。
</Accordion>

***

## セキュリティ

* **最小権限** — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
* **デフォルトで読み取り専用** — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
* **認証情報のローテーション** — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
* **オフボーディング時に失効** — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。

- **スコープ付きアプリケーションキー** — 常に明示的なスコープを指定してください。スコープなしのキーは作成者の全権限を継承します。
- **統合ごとに別々のキー** — CloudThinker用に専用のAPIキーとアプリケーションキーを作成して、独立して失効できるようにしてください。

***

## 関連情報

<CardGroup cols={2}>
  <Card title="Grafana 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/grafana.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c1329049025cd3c3a0909b400baef7be" href="/ja/guide/connections/grafana" width="24" height="24" data-path="images/icons/grafana.svg">
    代替メトリクスとダッシュボード
  </Card>

  <Card title="PagerDuty 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/pagerduty.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=cdc34a966d5d46da70c3bc509a2a7492" href="/ja/guide/connections/pagerduty" width="24" height="24" data-path="images/icons/pagerduty.svg">
    インシデントアラートとオンコール管理
  </Card>
</CardGroup>