Cloudflare Logpush

Cloudflare Logpush invia automaticamente ad Ahrefs i log delle richieste HTTP. È il metodo consigliato per i siti ad alto traffico, ma richiede un piano Cloudflare Impresa.

Prerequisiti

• Un piano Cloudflare Impresa sulla zona che vuoi monitorare.
• Un Token API di Cloudflare con le seguenti autorizzazioni:
  • Zona → Zona → Lettura
  • Zone → Logs → Edit

Ottenimento del token API di Cloudflare

Assicurati di aver effettuato l’accesso alla Dashboard di Cloudflare con l’account corretto. Quindi vai alla pagina https://dash.cloudflare.com/profile/api-tokens, individua e fai clic sul pulsante Crea token in alto a destra:

Ora procedi con il flusso Crea token personalizzato:

Inserisci le seguenti informazioni:

• Nome del token API: ahrefs-bot-analytics
• Concedi le seguenti autorizzazioni:
  • Zona / Log / Modifica in modo da poter configurare un job Logpush per inviare i log ad Ahrefs Bot Analytics
  • Zone / Zone / Read per consentirci di individuare la zona da configurare
• Le risorse della zona possono essere impostate su Include / All Zones; in alternativa, seleziona la zona che corrisponde al dominio del tuo sito web.

Ora fai clic sul pulsante Continua al riepilogo; il riepilogo dovrebbe apparire così:

Ora fai clic sul pulsante Crea token e copia il token generato negli appunti per usarlo nei passaggi successivi.

Per ulteriori informazioni, consulta la documentazione di Cloudflare su come creare un token API.

Configurazione automatica

1. In Ahrefs, vai su Impostazioni del Progetto → Bot Analytics.
2. Seleziona Cloudflare Logpush come metodo.
3. Incolla il tuo Token API di Cloudflare e fai clic su Connetti.

Ahrefs userà il tuo Token per:

1. Trovare la zona corrispondente al dominio del tuo Progetto.
2. Controlla se esistono job Logpush.
3. Crea un nuovo job che invia i log ad Ahrefs.

Configurazione manuale

Se preferisci non fornire un Token API, puoi configurare manualmente il job Logpush usando l'API di Cloudflare.

Passaggio 1 — Ottieni il tuo Zone ID e il Token API

1. Vai alla tua Dashboard di Cloudflare (https://dash.cloudflare.com/) e seleziona il dominio del tuo sito web.

2. Nella barra laterale destra, scorri verso il basso fino alla sezione API per trovare il tuo Zone ID.

3. Fai clic su "Ottieni token API" e crea un nuovo token con le seguenti autorizzazioni:

   • Zona → Zona → Lettura
   • Zone → Logs → Edit

   Consulta Ottenere un token API per istruzioni dettagliate.

Passaggio 2 — Crea il job Logpush

Una volta ottenuti $ZONE_ID e $CF_TOKEN, esegui il seguente comando. Puoi trovare il comando esatto precompilato con i dettagli del tuo Progetto in Impostazioni del Progetto → Bot Analytics → Configura manualmente.

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

Passaggio 3 — Verifica la connessione

Dopo aver creato il job, torna in Impostazioni del progetto → Bot Analytics in Ahrefs e fai clic su Controlla stato per verificare che i dati vengano ricevuti.