Cloudflare Logpush

Cloudflare Logpush sendet HTTP-Anfrage-Logs automatisch an Ahrefs. Dies ist die empfohlene Methode für Websites mit hohem Traffic, erfordert aber einen Cloudflare Enterprise-Plan.

Voraussetzungen

• Einen Cloudflare-Enterprise-Plan für die Zone, die du überwachen möchtest.
• Ein Cloudflare-API-Token mit den folgenden Berechtigungen:
  • Zone → Zone → Lesen
  • Zone → Logs → Edit

Cloudflare-API-Token abrufen

Stellen Sie sicher, dass Sie mit dem richtigen Konto im Cloudflare-Dashboard angemeldet sind. Navigieren Sie dann zur Seite https://dash.cloudflare.com/profile/api-tokens, suchen Sie oben rechts die Schaltfläche Token erstellen und klicken Sie darauf:

Fahre nun mit dem Ablauf Benutzerdefiniertes Token erstellen fort:

Fülle die folgenden Informationen aus:

• Name des API-Tokens: ahrefs-bot-analytics
• Erteile die folgenden Berechtigungen:
  • Zone / Logs / Bearbeiten, damit wir einen Logpush-Job konfigurieren können, der Logs an Ahrefs Bot Analytics weiterleitet
  • Zone / Zone / Read, damit wir die zu konfigurierende Zone finden können
• Zone Resources können auf Include / All Zones gesetzt werden; alternativ wähle die Zone aus, die der Domain deiner Website entspricht.

Klicke nun auf die Schaltfläche Continue to summary; die Zusammenfassung sollte so aussehen:

Klicke nun auf die Schaltfläche Create Token und kopiere das generierte Token in die Zwischenablage, um es in den nächsten Schritten zu verwenden.

Weitere Informationen findest du in der Cloudflare-Dokumentation unter So erstellst du einen API-Token.

Automatische Einrichtung

1. Gehe in Ahrefs zu Projekteinstellungen → Bot Analytics.
2. Wähle Cloudflare Logpush als Methode aus.
3. Füge deinen Cloudflare-API-Token ein und klicke auf Verbinden.

Ahrefs verwendet deinen Token, um:

1. Die Zone zu finden, die zur Domain deines Projekts passt.
2. Auf vorhandene Logpush-Jobs prüfen.
3. Einen neuen Job erstellen, der Logs an Ahrefs sendet.

Manuelle Einrichtung

Wenn du lieber keinen API-Token bereitstellen möchtest, kannst du den Logpush-Job manuell über die Cloudflare API einrichten.

Schritt 1 — Zone-ID und API-Token abrufen

1. Gehe zu deinem Cloudflare-Dashboard und wähle die Domain deiner Website aus.

2. Scrolle in der rechten Seitenleiste nach unten zum Abschnitt „API“, um deine Zone-ID zu finden.

3. Klicke auf „API-Token abrufen“ und erstelle einen neuen Token mit den folgenden Berechtigungen:

   • Zone → Zone → Lesen
   • Zone → Logs → Edit

   Detaillierte Anweisungen findest du unter Obtaining API token.

Schritt 2 — Den Logpush-Job erstellen

Sobald du deine $ZONE_ID und $CF_TOKEN hast, führe den folgenden Befehl aus. Den genauen Befehl, der bereits mit den Details deines Projekts ausgefüllt ist, findest du unter Projekteinstellungen → Bot Analytics → Manuell einrichten.

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

Schritt 3 — Verbindung überprüfen

Nachdem Sie den Job erstellt haben, gehen Sie in Ahrefs zurück zu Projekteinstellungen → Bot-Analytics und klicken Sie auf Status prüfen, um zu überprüfen, ob Daten empfangen werden.