> 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/netlify-agent-analytics.md).

# Netlify

Conecte o seu site Netlify ao AirOps para monitorizar o tráfego de bots de IA através de Netlify Log Drains.

Conecte o seu site Netlify ao AirOps para monitorizar o tráfego de bots de IA. Adicione um **Log Drain da Netlify** que transmite os registos de tráfego da edge para o AirOps, que classifica as visitas de bots de IA (ChatGPT, Claude, Perplexity, Google e mais) e apresenta insights no seu painel de Agent Analytics.

A configuração é um passo manual único no painel da Netlify. Os Log Drains são uma funcionalidade da **Netlify Enterprise** da Netlify. Não é necessária nenhuma etiqueta do site nem script do lado do cliente.

***

## Pré-requisitos

* Uma **AirOps** conta ativa com Agent Analytics ativado
* Uma **Netlify Enterprise** conta (os Log Drains não estão disponíveis nos planos Free, Personal ou Pro)
* Uma **site da Netlify** a servir o seu site
* Uma **Brand Kit** no AirOps para esse site. Defina o respetivo Brand URL como o domínio do seu site para que as análises ao nível da página sejam resolvidas (configurável em Context > Brand Kits > Brand URL)

Se não tiver a certeza de que o seu brand kit está configurado corretamente, confirme com o seu contacto de Customer Success do AirOps antes de configurar o drain.

***

## Passo 1: Obtenha o seu endpoint e token do AirOps

No AirOps, abra **Insights → No site → Análise de Agentes**, clique em **Configure o Agent Analytics** e escolha **Netlify**. O painel mostra os dois valores de que precisa:

* o **URL do endpoint de ingestão** para o seu brand kit
* o seu **token de API do workspace**, oculto por predefinição. Clique em **Mostrar** para o revelar, ou **Copiar** para o copiar diretamente para a área de transferência.

O token é o valor de `Authorization: Bearer` no Passo 2.

{% hint style="info" %}
Se o token não for mostrado, a sua função não tem acesso à chave de API do workspace. Peça a um administrador do workspace.

Também pode montar o endpoint manualmente: `https://ingest.airops.com/api/v1/netlify/<YOUR_BRAND_KIT_ID>/ingest`. O ID do seu Brand Kit está no URL em Context > Brand Kits, no formato `https://app.airops.com/<YOUR_WORKSPACE_SLUG>/data/brand_kits/<YOUR_BRAND_KIT_ID>`. O token também se encontra em Settings > Workspace.
{% endhint %}

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5368cd65ba16a0cb5b6fe548d7e1ec5ee4e272a4%2Fagent-netlify-01-setup-panel.png?alt=media" alt="Set up Agent Analytics panel for Netlify with the ingest endpoint URL and workspace API token to copy"><figcaption><p>Copie os valores do AirOps para a configuração da Netlify.</p></figcaption></figure>

## Passo 2: Adicione um Log Drain na Netlify

Na Netlify, vá ao **Logs & Metrics > Log Drains > Add log drain**, depois:

1. **Serviço:** General HTTP endpoint
2. **Tipos de registo:** Apenas tráfego (deixe os registos de function, edge, deploy e firewall desativados)
3. **Formato:** NDJSON
4. **URL do endpoint:** o endpoint do AirOps do Passo 1
5. **Cabeçalho:** adicionar `Authorization: Bearer <o seu token>`
6. **Excluir PII:** deixe isto **desativado** (ver o aviso abaixo)
7. Clique em **Conectar** para guardar o drain.

{% hint style="warning" %}
Deixe **"Excluir PII" desativado**. A opção de exclusão de PII da Netlify remove o User-Agent e o IP do cliente dos registos de tráfego. O AirOps identifica os agentes de IA a partir do User-Agent, por isso, com a PII excluída, nenhum tráfego de bots pode ser classificado e o seu painel fica vazio. Mantenha esta opção desativada para o Agent Analytics.
{% endhint %}

## Passo 3: Verifique a ligação

De volta ao AirOps, reabra **Configure o Agent Analytics** e escolha **Netlify**, depois clique em **Já configurei isto**. A Netlify mostra agora um selo verde **Conectado** na lista de origens.

O seu drain fica ativo assim que a Netlify o aceitar, e o tráfego aparece no painel à medida que os agentes de IA rastreiam as suas páginas monitorizadas.

{% hint style="info" %}
Teste com um caminho real e existente no seu site. Os pedidos para páginas inexistentes podem ser servidos a partir da cache de edge da Netlify sem chegarem ao drain, por isso um teste 404 não produzirá dados. Confirme também que o tipo de registo do drain está definido como **Tráfego**.
{% endhint %}

***

## Resolução de problemas

| Sintoma                                                              | Causa provável                                                        | Correção                                                                                                                                                          |
| -------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Não consegue ver o **Já configurei isto** botão                      | A sua função não pode editar brand kits                               | Peça a um administrador do workspace para confirmar a ligação por si.                                                                                             |
| Drain guardado na Netlify, mas não aparecem dados no Agent Analytics | Nenhum bot de IA atingiu ainda o site, ou "Excluir PII" está ativado  | Confirme que o tráfego real está a chegar ao site e desative "Excluir PII" no drain.                                                                              |
| O tráfego bruto aparece, mas nada é classificado                     | "Excluir PII" está ativado, por isso o User-Agent está em falta       | Edite o drain na Netlify e desative a exclusão de PII. O AirOps precisa do User-Agent para identificar bots.                                                      |
| Faltam dados ao nível da página no Page360                           | O domínio do seu brand kit não corresponde ao site                    | No AirOps, abra as definições do Brand Kit e confirme que o Brand URL corresponde ao domínio servido pelo seu site Netlify.                                       |
| Drain configurado, mas sem linhas após alguns minutos                | Testou um caminho que devolve 404, ou o tipo de registo não é Tráfego | Visite um caminho conhecido e existente na sua implementação e confirme que o tipo de registo do drain está definido como **Tráfego** (não apenas function/edge). |
| Não consegue encontrar Log Drains na Netlify                         | A sua equipa não está num plano Enterprise                            | Os Log Drains requerem **Netlify Enterprise**. Faça o upgrade antes de configurar.                                                                                |

***

## Requisitos de plano

Os Netlify Log Drains estão disponíveis apenas no plano **Netlify Enterprise** . Os planos Free, Personal e Pro não podem criar drains; a sua equipa precisa de Enterprise antes de configurar isto.

A Netlify não publica um custo separado por GB para a saída do Log Drain; qualquer custo de dados faz parte do seu acordo Netlify Enterprise. Para manter o volume baixo, direcione apenas **registos de tráfego**.

***

## Configuração de segurança e de menor privilégio

### Permissões necessárias para configurar

**Na Netlify:** um membro da equipa capaz de gerir Log Drains na sua equipa Enterprise pode adicionar o drain.

**No AirOps:** o utilizador tem de ter sessão iniciada no AirOps e ser membro do workspace de destino; qualquer função do AirOps funciona.

### Autenticação em tempo de execução

Nenhuma sessão de utilizador está envolvida em qualquer entrega do drain. Cada entrega autentica-se com um **Token Bearer** no `Authorization` cabeçalho, que é o seu **chave de API do AirOps do workspace**, introduzido na configuração do drain durante a configuração. O token é ao nível do workspace, não ao nível do utilizador. Não existe nenhum segredo de assinatura separado para gerir.

### Rotação de tokens

A chave API do workspace pode ser rodada na aplicação em **Account > Workspace > API Key** (requer a função de administrador do workspace do AirOps). Há duas coisas a entender antes de rodar:

* O drain da Netlify tem o token anterior no seu `Authorization` cabeçalho de saída. Após a rotação, atualize o cabeçalho do drain na Netlify com o novo token, caso contrário as entregas começarão a falhar na autenticação.
* A mesma chave de API do workspace autentica outras APIs do AirOps (API pública, servidor MCP, SDK). A sua rotação afeta todas elas, não apenas a Netlify.

### O que esta integração não faz

* Apenas recebe os registos de tráfego que o drain envia. Não tem acesso à sua conta Netlify, variáveis de ambiente, registos de build ou deploys.
* Não escreve de volta na sua conta Netlify. Após a configuração, o AirOps apenas recebe dados do drain.

Se a sua revisão de segurança precisar de detalhes adicionais, contacte o Customer Success do AirOps e podemos acompanhar a sua equipa através do fluxo de dados ao nível da implementação.

***

## Desligar

Para remover a integração Netlify:

1. Na Netlify, abra **Logs & Metrics > Log Drains** e remova o drain do AirOps.
2. No AirOps, desligue **Netlify** do seletor de origem de dados.

Os seus dados históricos da Netlify permanecem no AirOps após a desconexão. Para retomar o rastreamento, configure novamente o drain.

***

## O que o AirOps monitoriza

Depois de ligado, o AirOps automaticamente:

* **Ingere todos os pedidos servidos pela Netlify** incluídos nos registos de tráfego: visualizações de página, recursos, chamadas de API
* **Classifica o tráfego de bots de IA:** identifica visitas do ChatGPT, Claude, Google, Perplexity, Meta, Apple, Bing, Bytedance, Common Crawl e outros
* **Categoriza o comportamento de rastreio:** distingue rastreadores de treino de IA (GPTBot, ClaudeBot, etc.), pesquisas de IA (PerplexityBot, OAI-SearchBot, etc.) e navegação de IA iniciada pelo utilizador (ChatGPT-User, Claude-User, etc.)
* **Apresenta análises:** desdobramentos de tráfego, rácios bot vs. humano 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/netlify-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.
