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 トークンの作成方法」をご覧ください。
自動セットアップ
- Ahrefs で プロジェクト設定 → Bot Analytics に移動します。
- 方法として Cloudflare Logpush を選択します。
- Cloudflare API トークンを貼り付け、接続 をクリックします。
Ahrefs はトークンを使用して次を行います:
- プロジェクトのドメインに一致するゾーンを特定します。
- 既存の Logpush ジョブをチェック.
- Ahrefs にログを送信する新しいジョブを作成します。
info
お客様のトークンは一度使用され、保存されません。
手動セットアップ
API トークンを提供したくない場合は、Cloudflare API を使って Logpush ジョブを手動で設定できます。
ステップ 1 — ゾーン ID と API トークンを取得
-
Cloudflare ダッシュボード に移動し、ウェブサイトのドメインを選択してください。
-
右サイドバーで、API セクションまでスクロールダウンしてゾーン ID を見つけてください。
-
「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 に戻り、ステータスを確認 をクリックして、データが受信されていることを確認します。