> 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 acompanhar o tráfego de bots de IA. Você adiciona 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 Netlify Enterprise** . Não é necessária qualquer etiqueta do site nem script do lado do cliente. *** ## Pré-requisitos * Uma **AirOps** conta ativa com o Agent Analytics ativado * Uma **funcionalidade Netlify Enterprise** conta (os Log Drains não estão disponíveis nos planos Free, Personal ou Pro) * Uma **site Netlify** que serve o seu website * Uma **Brand Kit** no AirOps para esse site. Defina o respetivo Brand URL como o domínio do seu site para que os detalhamentos ao nível da página sejam resolvidos (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 da AirOps antes de configurar o drain. *** ## Passo 1: Obtenha o endpoint e o token do seu AirOps No AirOps, abra **Informações → No site → Análise de Agentes**, clique em **Configurar Agent Analytics** e escolha **Netlify**. O painel mostra ambos os valores de que precisa: * o **URL do endpoint de ingestão** para o seu brand kit * o seu **token da API do espaço de trabalho**, oculto por predefinição. Clique em **Mostrar** para o revelar, ou **Copiar** para o copiar diretamente para a sua área de transferência. O token é o valor `Authorization: Bearer` no Passo 2. {% hint style="info" %} Se o token não for apresentado, a sua função não tem acesso à chave API do espaço de trabalho. Peça a um administrador do espaço de trabalho. Também pode montar o endpoint manualmente: `https://ingest.airops.com/api/v1/netlify//ingest`. O ID do seu Brand Kit está na URL em Context > Brand Kits, no formato `https://app.airops.com//data/brand_kits/`. O token também está em Settings > Workspace. {% endhint %} ## Passo 2: Adicione um Log Drain na Netlify Na Netlify, vá para o **Logs & Metrics > Log Drains > Add log drain**, depois: 1. **Serviço:** Endereço HTTP genérico 2. **Tipos de registo:** Apenas tráfego (deixe os registos de função, 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 ` 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 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-a desativada para o Agent Analytics. {% endhint %} ## Passo 3: Verificar a Ligação De volta ao AirOps, reabra **Configurar Agent Analytics** e escolha **Netlify**, depois clique em **Já configurei isto**. A Netlify mostra agora um emblema verde **Connected** na lista de origens. O seu drain fica ativo assim que a Netlify o aceita, 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 a 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 espaço de trabalho para confirmar a ligação por si. | | Drain guardado na Netlify, mas não aparecem dados no Agent Analytics | Ainda nenhum bot de IA atingiu 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 válido conhecido que exista na sua implementação e confirme que o tipo de registo do drain está **Tráfego** (não apenas função/edge). | | Não consegue encontrar Log Drains na Netlify | A sua equipa não está num plano Enterprise | Os Log Drains requerem **funcionalidade Netlify Enterprise**. Faça upgrade antes de configurar. | *** ## Requisitos do plano Os Netlify Log Drains estão disponíveis apenas no plano **funcionalidade 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 uma cobrança separada por GB para a saída dos Log Drains; qualquer custo de dados faz parte do seu acordo Netlify Enterprise. Para manter o volume baixo, envie 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 que possa 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 espaço de trabalho de destino; qualquer função do AirOps serve. ### 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 cabeçalho `Authorization` cabeçalho, que é o seu **chave de API do AirOps do seu espaço de trabalho**, introduzido na configuração do drain durante a configuração. O token é ao nível do espaço de trabalho, não ao nível do utilizador. Não existe nenhum segredo de assinatura separado para gerir. ### Rotação de token A chave de API do espaço de trabalho pode ser rodada na aplicação em **Account > Workspace > API Key** (requer a função de administrador do espaço de trabalho 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 API do espaço de trabalho 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 compilação ou implementações. * 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 mais detalhes, contacte o Customer Success do AirOps e podemos orientar a sua equipa através do fluxo de dados ao nível da implementação. *** ## Desligar Para remover a integração da Netlify: 1. Na Netlify, abra **Logs & Metrics > Log Drains** e remova o drain do AirOps. 2. No AirOps, desconecte **Netlify** do seletor de fonte de dados. Os seus dados históricos da Netlify permanecem no AirOps após a desconexão. Para retomar o acompanhamento, configure o drain novamente. *** ## O que o AirOps rastreia Depois de conectado, o AirOps automaticamente: * **Ingere todos os pedidos servidos pela Netlify** transportados nos registos de tráfego: visualizações de página, ativos, 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.), recuperações de pesquisa de IA (PerplexityBot, OAI-SearchBot, etc.) e navegação em IA iniciada pelo utilizador (ChatGPT-User, Claude-User, etc.) * **Apresenta análises:** distribuição do 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=&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.