Cloudflare

概要

Cloudflare と統合することで、Web トラフィック、DNS クエリ、脅威に関するインサイトなど、ゾーンのメトリクスを取得できます。インテグレーションは、Cloudflare の分析 API を通じて行われます。

セットアップ

作業を開始するには、Datadog アカウントのほか、API キーと Cloudflare Logpush へのアクセス権が必要です。なお、Logpush へのアクセスには、Enterprise アカウントプランの購入が必要です。

Cloudflare API トークンを使用する場合は、Zone > Zone > Read および Zone > Analytics > Read の権限を保有していることを確認してください。

APM に Datadog Agent を構成する

Datadog の Cloudflare インテグレーションタイルを使用して、インテグレーションをインストールします。

コンフィギュレーション

1. Datadog Cloudflare インテグレーションタイル内の Configuration タブに移動します。
2. 監視するアカウントの電子メールアドレスと、API キーまたはトークンを入力します。Cloudflare API キーと API トークンは、Cloudflare アカウントの My profile > Api Tokens の下にあります。
3. アカウントの名前を追加します。この名前は任意で、メトリクスの account タグ内で使用されます。

ログの収集

Cloudflareでは、Cloudflare Logpush を使用してログを直接 Datadog にプッシュすることができます。Logpush のジョブは Cloudflare API または Cloudflare ダッシュボードで管理できます。

Cloudflare インテグレーションパイプラインをインストールすると、特定の属性が自動的にリマップされます。どの属性がリマップされるかを確認するには

1. ログパイプラインに移動します。
2. 右上の Browse Pipeline Library をクリックします。
3. 検索バーに Cloudflare と入力します。
4. Cloudflare をクリックすると、インストールされているリマッパーなどのプロセッサーのリストが表示されます。

Cloudflare API

1. Logpush ジョブエンドポイントへ POST をリクエストし、Logpush ジョブを作成します。以下のフィールドを含めます。

   • name (任意): ドメイン名をジョブ名として使用。
   • destination_conf: 以下のパラメーターからなるログの出力先。
     • <DATADOG_ENDPOINT_URL>: Datadog HTTP ログのインテークエンドポイント。エンドポイントは、http-intake.logs./v1/input になります
     • <DATADOG_API_KEY>: 使用する Datadog API キー。
     • ddsource: cloudflare に設定。
     • service (任意): サービス名を指定。
     • host (任意): ホスト名を指定。
     • ddtags (任意): タグを指定。
   • dataset: 受信するログのカテゴリー。サポートされるデータセットについては、Cloudflare のログフィールドを参照。
   • logpull_options (オプション): フィールド、サンプルレート、タイムスタンプの形式を構成するには、Logpush API オプションを参照。

   リクエスト例:

   curl -s -X POST 'https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/logpush/jobs' \
   --header 'X-Auth-Key: <CLOUDFLARE_AUTH_KEY>' \
   --header 'X-Auth-Email: <CLOUDFLARE_AUTH_EMAIL>' \
   --header 'Content-Type: application/json' \
   --data-raw '{
      "name": "<NAME>",
      "destination_conf": "datadog://<DATADOG_ENDPOINT_URL>?header_DD-API-KEY=<DATADOG_API_KEY>&ddsource=cloudflare&service=cloudflare&ddtags=env:dev",
      "logpull_options": "fields=RayID,EdgeStartTimestamp&timestamps=rfc3339",
      "dataset": "http_requests"
   }'
   

   応答例:

   {
    "errors": [],
    "messages": [],
    "result": {
      "id": 100,
      "dataset": "http_requests",
      "enabled": false,
      "name": "<DOMAIN_NAME>",
      "logpull_options": "fields=RayID,EdgeStartTimestamp&timestamps=rfc3339",
      "destination_conf": "datadog://http-intake.logs./v1/input?header_DD-API-KEY=<DD-API-KEY>&ddsource=cloudflare&service=cloudflare&ddtags=env:dev",
      "last_complete": null,
      "last_error": null,
      "error_message": null
    },
    "success": true
   }
   

   id の値をメモしておきます。上記の例では、100 です。

2. ジョブを有効にします。応答で返されたジョブ ID を使用してリクエスト本文で {"enabled": true} を送信します。

   リクエスト例:

   curl -s -X PUT \
   https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/logpush/jobs/<JOB_ID> -d'{"enabled":true}' | jq .
   

   応答例:

   {
     "errors": [],
     "messages": [],
     "result": {
       "id": 100,
       "dataset": "http_requests",
       "enabled": true,
       "name": "<DOMAIN_NAME>",
       "logpull_options": "fields=RayID,EdgeStartTimestamp&timestamps=rfc3339",
       "destination_conf": "datadog://?header_DD-API-KEY=<DATADOG-API-KEY>",
       "last_complete": null,
       "last_error": null,
       "error_message": null
     },
     "success": true
   }
   

Cloudflare ダッシュボード

1. Cloudflare ダッシュボードの Logpush セクションでサービスを接続したら、データセットとデータフィールドを選択し、宛先として Datadog を選択します。

2. Enter destination information の下で Datadog の URL エンドポイントを入力します。

   http-intake.logs./v1/input?ddsource=cloudflare
   

   注: ddsource=cloudflare は必須です。ログを区別するために、オプションで service、host、ddtags などのパラメーターを追加することもできます。

   例:

   http-intake.logs./v1/input?service=<SERVICE>&host=<HOST>&ddsource=cloudflare
   

3. Datadog Cloudflare インテグレーションタイルのセットアップに使用した Datadog API キーを入力します。

4. アクセスを確認すると、Prove ownership の下に “Ready to push!” と表示されます。Push をクリックして完了します。

収集データ

メトリクス

アクセス許可

Cloudflare API トークンでこれらのアクセス許可が有効になっていることを確認します。

イベント

Cloudflare インテグレーションには、イベントは含まれません。

サービスのチェック

Cloudflare インテグレーションには、サービスのチェック機能は含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。