Cloudflare Logpush

Cloudflare Logpush envoie automatiquement les journaux des requêtes HTTP à Ahrefs. C’est la méthode recommandée pour les sites à fort trafic, mais elle nécessite un forfait Cloudflare Entreprise.

Prérequis

• Un forfait Cloudflare Entreprise sur la zone que vous souhaitez surveiller.
• Un jeton d'API Cloudflare avec les autorisations suivantes :
  • Zone → Zone → Lire
  • Zone → Logs → Edit

Obtention du jeton d’API Cloudflare

Assurez-vous d’être connecté au Dashboard Cloudflare avec le bon compte. Accédez ensuite à la page https://dash.cloudflare.com/profile/api-tokens, repérez et cliquez sur le bouton Create Token en haut à droite :

Passez maintenant au flux Créer un jeton personnalisé :

Renseignez les informations suivantes :

• Nom du jeton API : ahrefs-bot-analytics
• Accordez les autorisations suivantes :
  • Zone / Journaux / Modifier afin que nous puissions configurer une tâche Logpush pour envoyer les journaux vers Ahrefs Bot Analytics
  • Zone / Zone / Lire afin que nous puissions localiser la zone à configurer
• Les ressources de zone peuvent être définies sur Inclure / Toutes les zones ; sinon, sélectionnez la zone qui correspond au domaine de votre site web.

Cliquez maintenant sur le bouton Continuer vers le récapitulatif ; le récapitulatif devrait ressembler à ceci :

Cliquez maintenant sur le bouton Créer un jeton et copiez le jeton généré dans le presse-papiers pour l’utiliser lors des étapes suivantes.

Consultez la documentation Cloudflare sur la création d’un jeton API pour plus d’informations.

Configuration automatique

1. Dans Ahrefs, allez dans Paramètres du projet → Bot Analytics.
2. Sélectionnez Cloudflare Logpush comme méthode.
3. Collez votre jeton d'API Cloudflare et cliquez sur Connecter.

Ahrefs utilisera votre jeton pour :

1. Trouver la zone correspondant au domaine de votre projet.
2. Vérifier l’existence de tâches Logpush.
3. Créer une nouvelle tâche qui envoie des journaux à Ahrefs.

Configuration manuelle

Si vous préférez ne pas fournir de jeton d’API, vous pouvez configurer la tâche Logpush manuellement à l’aide de l’API Cloudflare.

Étape 1 — Obtenez votre ID de zone et votre jeton d’API

1. Accédez à votre Dashboard Cloudflare et sélectionnez le domaine de votre site web.

2. Dans la barre latérale droite, faites défiler vers le bas jusqu’à la section API pour trouver votre ID de zone.

3. Cliquez sur « Obtenir votre jeton API » et créez un jeton avec les autorisations suivantes :

   • Zone → Zone → Lire
   • Zone → Logs → Edit

   Voir Obtention d'un jeton API pour obtenir des instructions détaillées.

Étape 2 — Créez la tâche Logpush

Une fois que vous avez votre $ZONE_ID et votre $CF_TOKEN, exécutez la commande suivante. Vous pouvez trouver la commande exacte, préremplie avec les détails de votre projet, dans Paramètres du projet → Bot Analytics → Configurer manuellement.

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

Étape 3 — Vérifier la connexion

Après avoir créé la tâche, retournez dans Paramètres du projet → Analyse du bot dans Ahrefs et cliquez sur Vérifier l’état pour vérifier que les données sont bien reçues.