Cloudflare 概要ダッシュボード

概要

Integrate with Cloudflare to get your zone metrics, including web traffic, DNS queries, and threat insights. The integration is based on Cloudflare’s analytics API. Learn more about what resources correspond with which metrics in our documentation.

Log Collection: In addition to these metrics, Cloudflare allows customers to push logs directly into Datadog using Cloudflare Logpush. These detailed logs contain metadata generated by Cloudflare products and are helpful for debugging and creating analytics, especially when combined with logs from other sources. Enable Cloudflare log collection in combination with these metrics to get full visibility into your Cloudflare environment.

すぐに使えるダッシュボードは、アプリケーションのセキュリティとパフォーマンスを向上させます。この一元化されたダッシュボードにより、以下の要素が視覚化されます

• セキュリティ脅威
• HTTP リクエスト量とエラー率
• 往復時間とトラフィックフローの変更を含むロードバランシング
• ワーカースクリプトにおけるパフォーマンスの問題

Cloudflare インフラストラクチャーを深く洞察するリッチ化されたログと詳細なメトリクスにより、問題解決に必要なコンテキストを構築できます。

The integration works with Datadog Cloud SIEM to provide out-of-the-box threat detection for

• 不可能移動
• dangerous misconfigurations
• DDoS 攻撃

IP アドレスのブロックや Datadog でのケースの作成など、同梱されている Workflow Automation のブループリントを利用して、セキュリティ脅威をより迅速に緩和できます。

セットアップ

Before you begin, you need a Datadog account, with an API key, and access to Cloudflare Logpush, which requires an Enterprise account plan.

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

インストール

Install the integration with the Datadog Cloudflare integration tile.

構成

1. Go to the Configure tab inside the Datadog Cloudflare integration tile.
2. 監視するアカウントの電子メールアドレスと、API キーまたはトークンを入力します。Cloudflare API キーと API トークンは、Cloudflare アカウントの My profile > Api Tokens の下にあります。
3. アカウントの名前を追加します。この名前は任意で、メトリクスの account タグ内で使用されます。

ログ収集

Cloudflare allows customers to push logs directly into Datadog using Cloudflare Logpush. You can manage the Logpush job with the Cloudflare API or directly within your Cloudflare dashboard.

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

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

Cloudflare API

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

   • name (任意): ドメイン名をジョブ名として使用。
   • destination_conf: 以下のパラメーターからなるログの出力先。
     • <DATADOG_ENDPOINT_URL>: The Datadog HTTP logs intake endpoint, which can be either one below. You can find the difference at Datadog API reference.
       • v1: http-intake.logs./v1/input
       • v2 (latest): http-intake.logs./api/v2/logs
     • <DATADOG_API_KEY>: 使用する Datadog API キー。
     • ddsource: cloudflare に設定。
     • service (任意): サービス名を指定。
     • host (任意): ホスト名を指定。
     • ddtags (任意): タグを指定。
   • dataset: The category of logs you want to receive. See the Cloudflare Log fields for a list of supported datasets.
   • logpull_options (optional): To configure fields, sample rate, and timestamp format, see the Logpush API options. Datadog mandates the use of RFC 3339 format for timestamps from Cloudflare, which is the default option used by Cloudflare.

   リクエスト例:

   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. Once you have connected a service with the Logpush section of the Cloudflare dashboard, select the dataset, select data fields, and then, under select destination, choose Datadog.

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

   http-intake.logs./api/v2/logs?ddsource=cloudflare
   

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

   例:

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

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

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

収集データ

メトリクス

Metric categories

以下の表では、収集されるメトリクスの種類と関連するメトリクスのプレフィックスについて説明します。

権限

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

イベント

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

サービスチェック

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

トラブルシューティング

Need help? Contact Datadog support.