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

# Datadog

> API キーとアプリケーションキーの認証情報を使用して Datadog を Iru Compliance に接続し、モニターの設定、ユーザーのインベントリ、セキュリティ態勢のエビデンスを収集します。

### Datadog について

**Datadog** コネクタは、アカウントの設定とセキュリティ関連のデータ（モニター、ユーザーとチーム、インテグレーションの状態、および関連する設定）を読み取ります。このエビデンスは Iru Compliance のコントロールに添付できます。通信には、お客様の **API キー**（`DD-API-KEY`）を使用した Datadog の HTTP API を使用します。一部の読み取りパスでは**アプリケーションキー**（`DD-APPLICATION-KEY`）も必要になる場合があります。製品内のウィザードには、お客様のテナントで Iru が必要とする内容が反映されます。

### 仕組み

Datadog では、キーが用途ごとに分かれています。

* **API キー**は、`DD-API-KEY` を介してデータプレーンのトラフィックと多くの設定の読み取りを認証します。
* **アプリケーションキー**は、特定の設定 API で `DD-APPLICATION-KEY` を介して API キーと組み合わせて使用します。

このコネクタは、コンプライアンスのエビデンスのための**読み取り**操作に重点を置いています。このソースの一部として、**Iru がカスタムメトリクスやログを Datadog に送信することはありません**。

| 項目 | 値 |
| - | - |
| **カテゴリ** | モニタリング |
| **認証** | API キー（必要に応じてアプリケーションキー） |
| **リージョン** | Datadog は**リージョン固有**です（US、EU など）。お客様のアカウントに対応する組織とエンドポイントを使用してください。 |

ドキュメント: [API キーとアプリケーションキー](https://docs.datadoghq.com/account_management/api-app-keys/)、[認証](https://docs.datadoghq.com/api/latest/authentication/)、[レート制限](https://docs.datadoghq.com/api/latest/rate-limits/)。

### 前提条件

* Datadog でキーを作成するための **組織管理者**（または同等）のアクセス権。
* お客様の **Datadog サイト**（`datadoghq.com`、`datadoghq.eu`、FedRAMP のバリエーションなど）を把握していること。

### Datadog を Iru に接続する

<Tabs>
  <Tab title="Datadog">
    <Note>
      Compliance でソースを接続する前に、このタブを完了してください。
    </Note>

    <Steps>
      <Step title="正しい Datadog サイトにサインインする">
        組織の Datadog URL（例: **`app.datadoghq.com`**、**`app.datadoghq.eu`**、または **FedRAMP** / **Gov** のホスト）を開きます。**組織設定** を管理できるロールでサインインします。
      </Step>

      <Step title="組織設定 を開く">
        左側のナビゲーションまたはアバターメニューから **組織設定** を選択します（レイアウトによっては **アクセス** または **Administration** の下にあります）。
      </Step>

      <Step title="APIキー を開く">
        **APIキー** を選択します。既存のキーと新しいキーを作成するためのコントロールが表示されます（パスは **組織設定** → **APIキー** のようになります）。
      </Step>

      <Step title="新しい API キーを作成する">
        **New Key** を選択します。**Iru Compliance** などの名前を入力してキーを作成します。

        <Note>
          Datadog では**組織あたりの API キーの数**に上限があります（通常は **50**）。上限に近い場合は、使用していないキーを削除してください。
        </Note>
      </Step>

      <Step title="API キーを安全な場所にコピーする">
        キーの値をすぐに**コピー**し、**Iru Compliance** に貼り付けるまでパスワードと同様に保管します。Datadog では、完全な値が作成時にしか表示されない場合があります。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進みます。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Datadog**](#datadog) タブを完了してください。
    </Note>

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Datadog をオンにする">
        **Datadog** を探します（**カテゴリ** を **Monitoring** に設定するか、**名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="Datadog の API キーを入力する">
        ウィザードで求められたら、Datadog の **API キー**を貼り付けます。
      </Step>

      <Step title="求められた場合はアプリケーションキーを追加する">
        ウィザードで**アプリケーションキー**を求められた場合は、Datadog の **組織設定** → **Application Keys** でキーを作成し、ウィザードに貼り付けます（再度求められた場合は API キーも貼り付けます）。
      </Step>

      <Step title="接続を完了する">
        **APIキーを送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Datadog** カードが **有効** になっていることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**の設定を確認してから、もう一度お試しください。
  </Accordion>

  <Accordion title="403 Forbidden / unauthorized">
    API キーの文字列を確認してください。テナントが想定している**同じ組織とサイト**のキーを使用していることを確認してください。
  </Accordion>

  <Accordion title="データが不完全">
    一部のエンドポイントでは、API キーとアプリケーションキーの**両方**が必要です。求められた場合は両方を入力してください。
  </Accordion>

  <Accordion title="429 レート制限">
    間隔を空けて再試行してください。大規模なアカウントでは、同期の時間枠を広げる必要がある場合があります。失敗した呼び出しの Datadog のレート制限ヘッダーを確認してください。
  </Accordion>

  <Accordion title="リージョンが間違っている">
    エンドポイントをお客様の Datadog サイト（US、EU、その他）に合わせてください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="API キーは自動的に期限切れにならないため、独自の…" icon="circle-info">
    API キーは**自動的に期限切れになりません**。独自のスケジュールでローテーションし、ローテーションしたら Iru を更新してください。
  </Card>

  <Card title="レート制限はエンドポイントによって異なり、初回のバックフィルには…" icon="shield">
    レート制限はエンドポイントによって異なります。利用の多い組織では、初回のバックフィルに時間がかかる場合があります。
  </Card>

  <Card title="エビデンスには、キーがアクセスできる API が…" icon="server">
    エビデンスには、キーがアクセスできる API の内容が反映されます。最小権限のキーでは、意図的に範囲の狭いデータが返される場合があります。
  </Card>
</CardGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="Sources の管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照・管理します。
  </Card>

  <Card title="Compliance の利用を開始する" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="Artifacts の管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースやアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>