> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/insights/onsite/traffic/cloudflare-logpush-agent-analytics.md).

# Cloudflare Logpush

Este guia mostra como configurar o Cloudflare Logpush para transmitir registos de pedidos HTTP para o AirOps para Agent Analytics.

Este guia mostra como configurar o Cloudflare para transmitir para o AirOps via **Logpush**. Depois de ligado, o AirOps analisa automaticamente o seu tráfego, classifica as visitas de bots de IA (ChatGPT, Claude, Perplexity, Google e outros) e apresenta insights no seu painel Agent Analytics.

Logpush é uma funcionalidade nativa, gerida pela Cloudflare, que agrupa registos de pedidos e os entrega a um endpoint HTTP. Ao contrário da [integração com Workers](https://docs.airops.com/docs/pt/insights/onsite/traffic/cloudflare-worker-agent-analytics.md), não requer qualquer código para implementar ou manter, mas só está disponível no plano **Enterprise** .

{% hint style="info" %}
**Logpush ou Worker?** Utilize **Logpush** se estiver num plano Cloudflare Enterprise. É a opção mais simples e não requer código. Se estiver em qualquer outro plano, use a [integração com o Cloudflare Worker](https://docs.airops.com/docs/pt/insights/onsite/traffic/cloudflare-worker-agent-analytics.md) em vez disso, onde implementa e mantém um Worker pequeno.
{% endhint %}

***

## Pré-requisitos

* Uma **AirOps** conta ativa com Agent Analytics ativado
* Uma **conta Cloudflare** conta no **Enterprise** plano (Logpush é exclusivo do Enterprise)
* acesso de administrador à zona da Cloudflare que serve o seu website
* A sua **chave de API do Workspace**, disponível em `Definições → Workspace`
* A sua **ID do Brand Kit**, disponível no URL ao navegar para `Context → Brand Kits`. O URL assume a forma `https://app.airops.com/<YOUR_WORKSPACE_SLUG>/data/brand_kits/<YOUR_BRAND_KIT_ID>`

***

## Configuração no painel

A configuração no painel é a **recomendada** abordagem para a maioria dos websites. O Logpush armazena em buffer eventos de registo por pedido e entrega-os à AirOps em lotes comprimidos, no seu próprio ritmo.

### Passo 1: Criar um trabalho do Logpush

1. Abra o **painel da Cloudflare** e selecione o domínio que serve o seu website. Os trabalhos do Logpush são específicos de cada domínio, por isso tem de estar dentro do domínio específico (zona) que pretende acompanhar, e não na vista ao nível da conta.
2. Na navegação à esquerda, expanda **Investigar** e selecione **Logpush**.
3. Clique em **Criar um trabalho do Logpush**.
4. Para o conjunto de dados, selecione **Pedidos HTTP**.

### Passo 2: Selecionar campos do registo

Selecione os seguintes campos. A AirOps usa-os para análises completas, e enviar campos adicionais não causa problemas.

| Campo                    | Obrigatório |
| ------------------------ | ----------- |
| `EdgeStartTimestamp`     | Sim         |
| `EdgeEndTimestamp`       | Sim         |
| `EdgeResponseStatus`     | Sim         |
| `EdgeResponseBytes`      | Sim         |
| `ClientRequestMethod`    | Sim         |
| `ClientRequestScheme`    | Sim         |
| `ClientRequestHost`      | Sim         |
| `ClientRequestURI`       | Sim         |
| `ClientRequestUserAgent` | Sim         |
| `ClientRequestReferer`   | Sim         |
| `ClientCountry`          | Sim         |
| `ClientDeviceType`       | Sim         |

### Passo 3: Configurar o destino HTTP

Defina o tipo de destino para **destino HTTP** e introduza o endpoint de ingestão da AirOps como URL de destino. A sua chave de API do Workspace é passada como um cabeçalho de pedido personalizado.

| Definição          | Valor                                                                                                                      |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| **URL de destino** | `https://ingest.airops.com/api/v1/cloudflare-logpush/<YOUR_BRAND_KIT_ID>/ingest?header_X-API-Key=<YOUR_WORKSPACE_API_KEY>` |

{% hint style="info" %}
A Cloudflare anexa cabeçalhos de pedido personalizados como parâmetros de consulta na forma `header_<Name>=<Value>`. O `header_X-API-Key=<YOUR_WORKSPACE_API_KEY>` parâmetro é a forma como a Cloudflare envia a sua chave de API do Workspace da AirOps com cada entrega.
{% endhint %}

### Passo 4: Concluir o desafio de propriedade

Antes de o trabalho poder ser criado, a Cloudflare verifica que você é o proprietário do destino. A Cloudflare envia um POST de um token de propriedade para a URL de destino. Recupere esse token e cole-o novamente no painel da Cloudflare para concluir a verificação.

### Passo 5: Ativar o trabalho

1. Revise a configuração do trabalho.
2. Ative o trabalho para começar a entregar registos.

### Passo 6: Verifique a ligação

Depois de ativar o trabalho do Logpush, os dados devem começar a chegar dentro de **alguns minutos** (o Logpush agrupa antes de enviar).

1. Na **painel da Cloudflare**, verifique o estado de entrega do trabalho do Logpush. Uma entrega recente bem-sucedida significa que os dados estão a chegar à AirOps.
2. No seu **painel AirOps**, navegue para **Agent Analytics**. A origem da Cloudflare passa para um estado ligado, e o tráfego de bots preenche-se assim que os crawlers visitarem o seu site.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-69321eb24d64bd25d0f457853c28502b3339fff2%2Fagent-logpush-01-setup-panel.png?alt=media" alt="Set up Agent Analytics source picker listing CloudFront, Vercel, Cloudflare Worker, and Netlify, with no Cloudflare Logpush option"><figcaption><p>O Cloudflare Logpush não aparece no seletor de origem atual do Agent Analytics.</p></figcaption></figure>

***

## Configuração da API

Também pode criar o trabalho do Logpush programaticamente usando a API da Cloudflare. Isto é útil para automatizar scripts ou gerir muitas zonas. Vai precisar de um token de API da Cloudflare com a permissão **Editar registos** e a sua **ID da zona**.

```bash
curl --request POST \
  "https://api.cloudflare.com/client/v4/zones/<YOUR_ZONE_ID>/logpush/jobs" \
  --header "Authorization: Bearer <YOUR_CLOUDFLARE_API_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "airops-log-collector",
    "dataset": "http_requests",
    "destination_conf": "https://ingest.airops.com/api/v1/cloudflare-logpush/<YOUR_BRAND_KIT_ID>/ingest?header_X-API-Key=<YOUR_WORKSPACE_API_KEY>",
    "output_options": {
      "field_names": [
        "EdgeStartTimestamp",
        "EdgeEndTimestamp",
        "EdgeResponseStatus",
        "EdgeResponseBytes",
        "ClientRequestMethod",
        "ClientRequestScheme",
        "ClientRequestHost",
        "ClientRequestURI",
        "ClientRequestUserAgent",
        "ClientRequestReferer",
        "ClientCountry",
        "ClientDeviceType"
      ],
      "timestamp_format": "rfc3339"
    },
    "enabled": true
  }'
```

{% hint style="info" %}
A `<YOUR_WORKSPACE_API_KEY>` passada em `destination_conf` deve ser o mesmo valor que a sua chave de API do Workspace, disponível em `Definições → Workspace`. Quando cria o trabalho através da API, a Cloudflare ainda exige a etapa do desafio de propriedade descrita acima antes de as entregas começarem.
{% endhint %}

***

## O que esperar após a configuração

* Os registos começam a chegar ao **destino HTTP** que configurou dentro de **minutos**. O Logpush agrupa eventos de registo no seu próprio ritmo antes de os entregar. Este é o tempo de entrega para esse endpoint, e não quando o tráfego aparece no seu painel.
* O Agent Analytics apresenta **apenas tráfego de bots de IA e crawlers**. A navegação humana não é mostrada.
* Um kit de marca aparece como configurado assim que o Logpush entregar o seu primeiro lote. As páginas específicas aparecem assim que um bot rastrear uma página monitorizada.

***

## Se Não Vir Dados

| Sintoma                                                    | Causa provável                                          | Correção                                                                                                                     |
| ---------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| O trabalho da Cloudflare mostra erros de entrega / não-2xx | A URL de destino ou a autenticação está mal configurada | Volte a verificar o ID do Brand Kit na URL e confirme `?header_X-API-Key=` é a sua chave de API atual do Workspace da AirOps |
| A Cloudflare mostra `401` / `403` respostas                | Chave errada ou rotacionada, ou workspace errado        | Verifique se a chave de API é atual e se o Brand Kit pertence a esse workspace                                               |
| Entrega bem-sucedida, mas o Agent Analytics está vazio     | Esperado: apenas o tráfego de bots é mostrado           | Espere que um crawler visite; as visitas humanas não são mostradas                                                           |
| As primeiras linhas de bots ainda não apareceram           | Tempo de rastreio                                       | As primeiras linhas visíveis aparecem quando um crawler visita de novo, o que depende da frequência de rastreio              |

Se continuar bloqueado, contacte o suporte da AirOps com o seu **ID do Brand Kit** e o **estado de entrega do trabalho do Logpush**.

***

## Parar ou desligar

Para deixar de enviar dados para a AirOps, desative ou elimine o trabalho do Logpush no painel da Cloudflare. Rodar a sua chave de API do Workspace da AirOps também interrompe a entrega, uma vez que a Cloudflare continuará a enviar a chave antiga.

***

## O que o AirOps monitoriza

Depois de ligado, o AirOps automaticamente:

* **Ingere os seus registos de pedidos da Cloudflare** via Logpush
* **Classifica o tráfego de bots de IA**: identifica visitas do ChatGPT, Claude, Google, Perplexity, Gemini, Meta, Apple, Bing, ByteDance, Common Crawl e outros
* **Categoriza o comportamento de crawl**: distingue entre crawlers de treino de IA, fetches de pesquisa de IA, indexação de IA e navegação em IA iniciada pelo utilizador
* **Exibe análises**: detalhamentos do tráfego de bots de IA e crawlers e tendências de rastreio no seu painel


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/insights/onsite/traffic/cloudflare-logpush-agent-analytics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
