Docs
ドキュメントを検索...⌘K

Cloudflare Logpush

Cloudflare Logpush は HTTP リクエストログを Ahrefs に自動送信します。 高トラフィックのサイトには推奨されますが、Cloudflare エンタープライズ プランが必要です。

前提条件

  • 監視したいゾーンに Cloudflare エンタープライズ プランが適用されていること。
  • 次の権限を持つ Cloudflare API トークン:
    • ゾーン → ゾーン → 読み取り
    • Zone → Logs → Edit

Cloudflare APIトークンの取得

正しいアカウントでCloudflareダッシュボードにログインしていることを確認してください。 次に https://dash.cloudflare.com/profile/api-tokens ページに移動し、右上にある Create Token ボタンを見つけてクリックしてください:

トークンを作成

続いて、カスタムトークンの作成フローに進みます:

カスタムトークンを作成

以下の情報を入力してください:

  • APIトークン名:ahrefs-bot-analytics
  • 以下の権限を付与してください:
    • Ahrefs Bot Analytics にログをプッシュする Logpush ジョブを設定できるように、Zone / Logs / Edit を有効にします
    • 設定対象のゾーンを特定できるように、Zone / Zone / Read を付与します
  • Zone Resources は Include / All Zones に設定できます。もしくは、ウェブサイトのドメインに対応するゾーンを選択してください。
トークンの設定

次に Continue to summary ボタンをクリックします。サマリーは次のようになります:

トークンのサマリー

Create Token ボタンをクリックし、生成されたトークンをクリップボードにコピーして、次の手順で使用してください。

詳しくは、Cloudflare のドキュメント「API トークンの作成方法」をご覧ください。

自動セットアップ

  1. Ahrefs で プロジェクト設定 → Bot Analytics に移動します。
  2. 方法として Cloudflare Logpush を選択します。
  3. Cloudflare API トークンを貼り付け、接続 をクリックします。

Ahrefs はトークンを使用して次を行います:

  1. プロジェクトのドメインに一致するゾーンを特定します。
  2. 既存の Logpush ジョブをチェック.
  3. Ahrefs にログを送信する新しいジョブを作成します。

info

お客様のトークンは一度使用され、保存されません。

手動セットアップ

API トークンを提供したくない場合は、Cloudflare API を使って Logpush ジョブを手動で設定できます。

ステップ 1 — ゾーン ID と API トークンを取得

  1. Cloudflare ダッシュボード に移動し、ウェブサイトのドメインを選択してください。

  2. 右サイドバーで、API セクションまでスクロールダウンしてゾーン ID を見つけてください。

  3. 「API トークンを取得」をクリックし、以下の権限で新しいトークンを作成してください。

    • ゾーン → ゾーン → 読み取り
    • Zone → Logs → Edit

    詳しい手順は、API トークンの取得 を参照してください。

ステップ 2 — Logpush ジョブを作成

ゾーン ID($ZONE_ID)と API トークン($CF_TOKEN)を取得したら、次のコマンドを実行してください。 プロジェクトの情報が入力済みの正確なコマンドは、プロジェクト設定 → Bot Analytics → 手動でセットアップ で確認できます。

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logpush/jobs" \
  -X POST \
  -H "Authorization: Bearer $CF_TOKEN" \
  --data-binary '{
  "name": "ahrefs-web-analytics-http-requests",
  "destination_conf": "https://analytics.ahrefs.com/api/cf_logpush/http_requests?header_x-ahrefs-web-analytics-property=YOUR_PROPERTY_KEY",
  "dataset": "http_requests",
  "frequency": "high",
  "filter": "{\"where\":{\"or\":[{\"key\":\"ClientRequestHost\",\"operator\":\"eq\",\"value\":\"yourwebsite.com\"},{\"key\":\"ClientRequestHost\",\"operator\":\"endsWith\",\"value\":\".yourwebsite.com\"}]}}",
  "output_options": {
    "field_names": [
      "ClientIP", "ClientRequestMethod", "ClientRequestHost",
      "ClientRequestProtocol", "ClientRequestScheme", "ClientRequestURI",
      "ClientRequestPath", "ClientRequestUserAgent", "ClientRequestReferer",
      "EdgeStartTimestamp", "EdgeEndTimestamp", "EdgeResponseStatus",
      "EdgeResponseBytes", "EdgeResponseContentType",
      "EdgeTimeToFirstByteMs", "ClientCountry", "ClientCity", "ClientASN",
      "ClientDeviceType", "ClientRegionCode", "BotScore", "BotScoreSrc",
      "BotTags", "VerifiedBotCategory", "RayID"
    ],
    "timestamp_format": "unixnano"
  },
  "enabled": true
}'

warning

destination_conf の URL とプロパティキーは、プロジェクトごとに固有です。 正しい値を使用するため、プロジェクト設定 → Bot Analytics ページから正確なコマンドをコピーしてください。

ステップ 3 — 接続を確認

ジョブを作成したら、Ahrefs の プロジェクト設定 → Bot Analytics に戻り、ステータスを確認 をクリックして、データが受信されていることを確認します。