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

# Cloudflare 連携(Logpush)

> このドキュメントでは、HTTP リクエストデータを取得し、Cloudflare Logpush を使用して Profound Agent Analytics プラットフォームに転送する Cloudflare Worker の設定とデプロイの方法を説明します。

## 概要

この連携では、ミドルウェアとして動作する Cloudflare Logpush を使用してリクエストのメタデータを収集し、Agent Analytics API に送信します。Cloudflare Logpush は Cloudflare Enterprise の機能で、Cloudflare のログを Profound のような Cloudflare 以外の送信先に転送できます。Cloudflare Logpush の詳細については、[ドキュメントサイトを参照してください](https://developers.cloudflare.com/logs/about/)。

## 前提条件

* Enterprise プランの Cloudflare アカウント

* ドメインの Cloudflare 設定へのアクセス権

* Agent Analytics 用の Profound Log Ingestion Token

<Tip>
  Cloudflare の Free/Pro プランをご利用の場合は、<a href="/ja-jp/agent-analytics/cloudflare_worker" target="_self">Cloudflare Workers を使用した連携ガイド</a>をご覧ください。
</Tip>

<img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/cloudflare_logpush/logpush_setup.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=1f3d1936ae852ac98962c9167a90e126" alt="Logpush Detected" width="3680" height="2390" data-path="images/agent-analytics/cloudflare_logpush/logpush_setup.png" />

## 設定

<Steps>
  <Step title="ステップ 1">
    Cloudflare ダッシュボードでドメインを選択し、**Analytics & Logs -> Logpush** に移動します。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/cloudflare_logpush/cloudflare_logpush_nav.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=625b1175af5e6297333789cb96f6da7b" alt="Cloudflare Logpush Navigation" width="248" height="258" data-path="images/agent-analytics/cloudflare_logpush/cloudflare_logpush_nav.png" />
  </Step>

  <Step title="ステップ 2">
    新しい Logpush ジョブを作成し、HTTP 送信先を選択します。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/cloudflare_logpush/cloudflare_http_destination.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=ed84b38394cdeec008e1ce996f9115d6" alt="Cloudflare HTTP Destination" width="246" height="296" data-path="images/agent-analytics/cloudflare_logpush/cloudflare_http_destination.png" />
  </Step>

  <Step title="ステップ 3">
    次の API URL 形式を使用して Profound Log Ingestion Token を含め、続行します。

    ```http theme={null}
    https://artemis.api.tryprofound.com/v1/logs/cloudflare_logpush?header_X-API-Key=bot_PROFOUND_LOG_INGESTION_TOKEN
    ```
  </Step>

  <Step title="ステップ 4">
    **If logs match...** で `Filtered logs` を選択します。

    次に、`ClientRequestHost` フィールドでドメインに一致するようにフィルタリングします。

    <Tip>
      フィルターには必ず貴社のドメインを使用してください。`www.tryprofound.com` は例示用のため使用しないでください。
    </Tip>

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/cloudflare_logpush/cloudflare_filter_logs.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=39352a097e7fc3cfd9248d64b684c3ee" alt="Cloudflare Filter Logs" width="1297" height="258" data-path="images/agent-analytics/cloudflare_logpush/cloudflare_filter_logs.png" />
  </Step>

  <Step title="ステップ 5">
    HTTP requests データセットを選択し、送信する次のフィールドを選択します。

    * リクエスト

      * `ClientIP` - クライアントの IP アドレス。

      * `ClientRequestHost` - クライアントがリクエストしたホスト。

      * `ClientRequestMethod` - クライアントリクエストの HTTP メソッド。

      * `ClientRequestReferer` - HTTP リクエストのリファラー。

      * `ClientRequestURI` - クライアントがリクエストした URI。

      * `ClientRequestUserAgent` - クライアントから報告されたユーザーエージェント。

    * パフォーマンス

      * `EdgeStartTimestamp` - エッジがクライアントからリクエストを受信したタイムスタンプ。

      * `EdgeEndTimestamp` - エッジがクライアントへのレスポンス送信を完了したタイムスタンプ。

    * レスポンス

      * `EdgeResponseBytes` - エッジがクライアントに返したバイト数。

      * `EdgeResponseStatus` - Cloudflare がクライアントに返した HTTP ステータスコード。

    以上で完了です。Web サイトへの Profound Agent Analytics の設定が正常に完了しました。1 時間以内にダッシュボードにデータが表示され始めます。
  </Step>
</Steps>

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

* ログが表示されない場合は、Log Ingestion Token と URL を確認してください

* Workers > Analytics で実行エラーがないか確認してください

* ルートパターンがドメインの設定と一致していることを確認してください

* Cloudflare ダッシュボードのメトリクスを確認して、Worker がリクエストを受信していることを確認してください

## その他のリソース

* [Cloudflare Logpush のドキュメント](https://developers.cloudflare.com/logs/about/)

* [Cloudflare の HTTP 送信先の有効化に関するドキュメント](https://developers.cloudflare.com/logs/get-started/enable-destinations/http/)

* API に関するご質問は [support@tryprofound.com](mailto:support@tryprofound.com) までお問い合わせください

## セキュリティに関する考慮事項

* 本番環境では、Log Ingestion Token をシークレットとして保存してください

* Log Ingestion Token は定期的にローテーションしてください

* Worker の使用状況とログに異常なパターンがないか監視してください