Cloudflare Logpush

Cloudflare Logpush automatycznie wysyła logi żądań HTTP do Ahrefs. To zalecana metoda dla witryn o dużym ruchu, ale wymaga planu Cloudflare Enterprise.

Wymagania wstępne

• Plan Cloudflare Enterprise dla strefy, którą chcesz monitorować.
• Token API Cloudflare z następującymi uprawnieniami:
  • Strefa → Strefa → Odczyt
  • Zone → Logs → Edit

Uzyskiwanie tokenu API Cloudflare

Upewnij się, że jesteś zalogowany(-a) do panelu Cloudflare Dashboard na właściwym koncie. Następnie przejdź na stronę https://dash.cloudflare.com/profile/api-tokens, znajdź i kliknij przycisk Utwórz token w prawym górnym rogu:

Teraz przejdź do procesu Create Custom Token:

Wypełnij poniższe informacje:

• Nazwa tokena API: ahrefs-bot-analytics
• Przyznaj następujące uprawnienia:
  • Strefa / Dzienniki / Edytuj, abyśmy mogli skonfigurować zadanie Logpush wysyłające dzienniki do Ahrefs Bot Analytics
  • Zone / Zone / Read — abyśmy mogli odnaleźć strefę do skonfigurowania
• W polu Zone Resources możesz ustawić Include / All Zones; ewentualnie wybierz strefę odpowiadającą domenie Twojej witryny.

Teraz kliknij przycisk Continue to summary; podsumowanie powinno wyglądać tak:

Teraz kliknij przycisk Create Token i skopiuj wygenerowany token do schowka, aby użyć go w kolejnych krokach.

Więcej informacji znajdziesz w dokumentacji Cloudflare: jak utworzyć token API.

Automatyczna konfiguracja

1. W Ahrefs przejdź do Ustawienia Projektu → Analiza botów.
2. Wybierz Cloudflare Logpush jako metodę.
3. Wklej Token API Cloudflare i kliknij Połącz.

Ahrefs użyje Tokena, aby:

1. Znaleźć strefę pasującą do domeny Twojego projektu.
2. Sprawdź istniejące zadania Logpush.
3. Utworzyć nowe zadanie przesyłania logów do Ahrefs.

Konfiguracja ręczna

Jeśli wolisz nie podawać tokena, możesz skonfigurować zadanie Logpush ręcznie za pomocą API Cloudflare.

Krok 1 — Pobierz Zone ID i Token API

1. Przejdź do swojego Dashboard w Cloudflare i wybierz domenę swojej witryny.

2. Na prawym pasku bocznym przewiń w dół do sekcji API, aby znaleźć swój Zone ID.

3. Kliknij opcję „Uzyskaj swój token API” i utwórz nowy token z następującymi uprawnieniami:

   • Strefa → Strefa → Odczyt
   • Zone → Logs → Edit

   Szczegółowe instrukcje znajdziesz w sekcji Obtaining API token.

Krok 2 — Utwórz zadanie Logpush

Gdy masz już swoje $ZONE_ID i $CF_TOKEN, uruchom następujące polecenie. Dokładne polecenie, wstępnie uzupełnione danymi Twojego projektu, znajdziesz w Ustawienia Projektu → Analiza botów → Skonfiguruj ręcznie.

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
}'

Krok 3 — Sprawdź połączenie

Po utworzeniu zadania wróć do Ustawienia projektu → Analityka bota w Ahrefs i kliknij Sprawdź status, aby upewnić się, że dane są odbierane.