> 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 orienta você na configuração do Cloudflare para transmitir para o AirOps via **Logpush**. Depois de conectado, o AirOps analisa automaticamente seu tráfego, classifica visitas de bots de IA (ChatGPT, Claude, Perplexity, Google e muito mais) e exibe insights no seu painel de Agent Analytics.

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

{% hint style="info" %}
**Logpush ou Worker?** Use **Logpush** se estiver num plano Cloudflare Enterprise. É a opção mais fácil e não requer código. Se estiver em qualquer outro plano, use a [integração com Cloudflare Worker](/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 o Agent Analytics ativado
* Uma **conta Cloudflare** conta no **Enterprise** plano (o Logpush é exclusivo do Enterprise)
* Acesso de administrador à zona da Cloudflare que serve o seu site
* Sua **chave de API do Workspace**, disponível em `Configurações → Workspace`
* Sua **Brand Kit ID**, disponível na URL navegando para `Contexto → Kits de marca`. A URL tem o formato `https://app.airops.com/<YOUR_WORKSPACE_SLUG>/data/brand_kits/<YOUR_BRAND_KIT_ID>`

***

## Configuração no dashboard

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

### Passo 1: Criar um job de Logpush

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

### Passo 2: Selecionar campos de registo

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

| 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_<Nome>=<Valor>`. O `header_X-API-Key=<YOUR_WORKSPACE_API_KEY>` parâmetro é 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 job poder ser criado, a Cloudflare verifica se é o proprietário do destino. A Cloudflare faz um POST do token de propriedade para o URL de destino. Recupere esse token e cole-o de volta no dashboard da Cloudflare para concluir a verificação.

### Passo 5: Ativar o job

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

### Passo 6: Verificar a conexão

Depois de ativar o job de Logpush, os dados devem começar a fluir no prazo de **alguns minutos** (o Logpush agrupa antes de enviar).

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

***

## Configuração da API

Também pode criar o job de Logpush programaticamente usando a API da Cloudflare. Isto é útil para automatização de scripts ou gestão de muitas zonas. Vai precisar de um token de API da Cloudflare com a **Editar registos** e o seu **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 `Configurações → Workspace`. Ao criar o job através da API, a Cloudflare continua a exigir o passo de desafio de propriedade descrito 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 os eventos de registo segundo o 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 dashboard.
* O Agent Analytics mostra **apenas o tráfego de bots e crawlers de IA**. A navegação humana não é mostrada.
* Um kit de marca aparece como configurado assim que o Logpush entrega o seu primeiro lote. As páginas específicas aparecem assim que um bot rastreia uma página monitorizada.

***

## Se Não Vir Dados

| Sintoma                                                | Causa provável                                          | Correção                                                                                                                        |
| ------------------------------------------------------ | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| o job da Cloudflare mostra erros de entrega / não-2xx  | O URL de destino ou a autenticação está mal configurada | Volte a verificar o ID do kit de marca no URL e confirme `?header_X-API-Key=` é a sua chave atual de API do Workspace da AirOps |
| a Cloudflare mostra `401` / `403` respostas            | Chave errada ou rotacionada, ou workspace errado        | Verifique se a chave da API está atual e se o kit de marca 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       | Momento do crawl                                        | As primeiras linhas visíveis aparecem sempre que um crawler visitar a seguir, o que depende da frequência de crawl              |

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

***

## Parar ou Desligar

Para deixar de enviar dados para a AirOps, desative ou elimine o job de Logpush no dashboard 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 rastreia

Depois de conectado, o AirOps automaticamente:

* **Ingere os registos de pedidos da sua 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 rastreamento**: distingue entre rastreadores de treinamento de IA, buscas de IA, indexação de IA e navegação em IA iniciada pelo usuário
* **Exibe análises**: divisões do tráfego de bots e crawlers de IA e tendências de crawl no seu dashboard


---

# 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.