Cloudflare Logpush

Cloudflare Logpush автоматично надсилає журнали HTTP-запитів до Ahrefs. Це рекомендований метод для сайтів із великим трафіком, але він потребує плану Cloudflare Enterprise.

Передумови

• План Cloudflare Enterprise для зони, яку ви хочете відстежувати.
• Токен Cloudflare API з такими дозволами:
  • Зона → Zone → Read
  • Zone → Logs → Edit

Отримання API-токена Cloudflare

Переконайтеся, що ви ввійшли до Cloudflare Dashboard з правильним обліковим записом. Потім перейдіть на сторінку https://dash.cloudflare.com/profile/api-tokens, знайдіть і натисніть кнопку Create Token у верхньому правому куті:

Тепер перейдіть до процесу Створення власного токена:

Заповніть таку інформацію:

• Назва API-токена: ahrefs-bot-analytics
• Надайте такі дозволи:
  • Zone / Logs / Edit, щоб ми могли налаштувати завдання Logpush для надсилання журналів до Ahrefs Bot Analytics
  • Zone / Zone / Read — щоб ми могли знайти зону для налаштування
• Zone Resources можна встановити як Include / All Zones або вибрати Zone, що відповідає домену вашого сайту.

Тепер натисніть кнопку Continue to summary, підсумок має виглядати так:

Тепер натисніть кнопку Create Token і скопіюйте згенерований токен у буфер обміну, щоб використати його на наступних кроках.

Додаткову інформацію дивіться в документації Cloudflare: як створити API-токен.

Автоматичне налаштування

1. В Ahrefs перейдіть до Налаштування проєкту → Bot Analytics.
2. Виберіть Cloudflare Logpush як метод.
3. Вставте свій токен Cloudflare API і натисніть Підключити.

Ahrefs використає ваш токен, щоб:

1. Знайти зону, що відповідає домену вашого проєкту.
2. Перевірити наявні завдання Logpush.
3. Створити нове завдання з надсилання журналів до Ahrefs.

Ручне налаштування

Якщо ви не хочете надавати токен API, ви можете налаштувати завдання Logpush вручну через Cloudflare API.

Крок 1 — Отримайте свій Zone ID та токен API

1. Перейдіть до Cloudflare Dashboard і виберіть домен вашого вебсайту.

2. У правій бічній панелі прокрутіть вниз до розділу API, щоб знайти свій Zone ID.

3. Клацніть на «Отримати API-токен» і створіть токен із такими дозволами:

   • Зона → Zone → Read
   • Zone → Logs → Edit

   Детальні інструкції див. у розділі Отримання API-токена.

Крок 2 — Створіть завдання Logpush

Коли у вас будуть $ZONE_ID і $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
}'

Крок 3 — Перевірте підключення

Після створення завдання поверніться в Ahrefs до Налаштування проєкту → Аналітика ботів і натисніть Перевірити статус, щоб переконатися, що дані надходять.