Logpush da Cloudflare

O Cloudflare Logpush envia logs de solicitações HTTP para a Ahrefs automaticamente. É o método recomendado para sites com alto tráfego, mas exige um plano Cloudflare Enterprise.

Pré-requisitos

• Um plano Cloudflare Enterprise na zona que você quer monitorar.
• Um Token de API da Cloudflare com as seguintes permissões:
  • Zona → Zona → Leitura
  • Zona → Logs → Editar

Obtendo token de API do Cloudflare

Verifique se você está conectado ao Dashboard do Cloudflare com a conta correta. Em seguida, navegue até a página https://dash.cloudflare.com/profile/api-tokens, localize e clique no botão Criar Token no canto superior direito:

Agora prossiga com o fluxo de Criar token personalizado:

Preencha as seguintes informações:

• Nome do token de API: ahrefs-bot-analytics
• Conceda as seguintes permissões:
  • Zona / Logs / Editar para que possamos configurar um job do Logpush para enviar os logs para o Ahrefs Bot Analytics
  • Zona / Zona / Ler para que possamos localizar a zona a ser configurada
• Os recursos da zona podem ser definidos como Incluir / Todas as zonas; como alternativa, selecione a zona que corresponde ao domínio do seu site.

Agora clique no botão Continue to summary; o resumo deve ficar assim:

Agora clique no botão Criar token e copie o token gerado para a área de transferência para usar nas próximas etapas.

Consulte a documentação da Cloudflare sobre como criar um token de API para obter informações adicionais.

Configuração automática

1. No Ahrefs, vá para Configurações do Projeto → Análise de Bots.
2. Selecione Cloudflare Logpush como método.
3. Cole seu Token de API do Cloudflare e clique em Conectar.

O Ahrefs vai usar seu token para:

1. Encontrar a zona que corresponde ao domínio do seu projeto.
2. Verifique se há jobs do Logpush existentes.
3. Criar um novo job que envia logs para a Ahrefs.

Configuração manual

Se você preferir não fornecer um Token de API, pode configurar o job do Logpush manualmente usando a API do Cloudflare.

Etapa 1 — Obtenha seu ID da zona e Token de API

1. Acesse seu Dashboard do Cloudflare e selecione o domínio do seu site.

2. Na barra lateral direita, role para baixo até a seção API para encontrar seu ID da zona.

3. Clique em "Obtenha seu token de API" e crie um novo token com as seguintes permissões:

   • Zona → Zona → Leitura
   • Zona → Logs → Editar

   Consulte Como obter token de API para instruções detalhadas.

Etapa 2 — Crie o job do Logpush

Depois de ter seu $ZONE_ID e $CF_TOKEN, execute o comando a seguir. Você pode encontrar o comando exato já preenchido com os detalhes do seu projeto em Configurações do Projeto → Análise de Bots → Configurar 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
}'

Etapa 3 — Verificar a conexão

Depois de criar a tarefa, volte para Configurações do Projeto → Análise de bots no Ahrefs e clique em Verificar status para confirmar se os dados estão sendo recebidos.