> 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/es/insights/onsite/traffic/netlify-agent-analytics.md). # Netlify Conecta tu sitio de Netlify a AirOps para rastrear el tráfico de bots de IA mediante Netlify Log Drains. Conecta tu sitio de Netlify a AirOps para rastrear el tráfico de bots de IA. Añades un **Log Drain de Netlify** que transmite los registros de tráfico de edge a AirOps, que clasifica las visitas de bots de IA (ChatGPT, Claude, Perplexity, Google y más) y muestra información en tu panel de Agent Analytics. La configuración es un paso manual único en el panel de Netlify. Los Log Drains son una **Netlify Enterprise** función. No se requiere etiqueta del sitio ni script del lado del cliente. *** ## Prerrequisitos * Una **AirOps** cuenta con Agent Analytics habilitado * Una **Netlify Enterprise** cuenta (los Log Drains no están disponibles en los planes Free, Personal o Pro) * Una **sitio de Netlify** que sirve tu sitio web * Una **Brand Kit** en AirOps para ese sitio. Establece su Brand URL con el dominio de tu sitio para que se resuelvan los desglose a nivel de página (configurable en Context > Brand Kits > Brand URL) Si no estás seguro de si tu brand kit está configurado correctamente, consulta con tu contacto de Customer Success de AirOps antes de configurar el drain. *** ## Paso 1: Obtén el endpoint y el token de AirOps En AirOps, abre **Información → En el sitio → Agent Analytics**, haz clic en **Configurar Agent Analytics** y elige **Netlify**. El panel muestra ambos valores que necesitas: * el **URL del endpoint de ingestión** para tu brand kit * tu **token de API del espacio de trabajo**, oculto de forma predeterminada. Haz clic en **Mostrar** para revelarlo, o **Copiar** para copiarlo directamente a tu portapapeles. El token es el `Authorization: Bearer` valor en el Paso 2. {% hint style="info" %} Si el token no se muestra, tu rol no tiene acceso a la clave API del espacio de trabajo. Pídeselo a un administrador del espacio de trabajo. También puedes construir el endpoint tú mismo: `https://ingest.airops.com/api/v1/netlify//ingest`. El ID de tu Brand Kit está en la URL bajo Context > Brand Kits, en la forma `https://app.airops.com//data/brand_kits/`. El token también se encuentra en Settings > Workspace. {% endhint %} ## Paso 2: Añade un Log Drain en Netlify En Netlify, ve a la **Logs & Metrics > Log Drains > Add log drain**, luego: 1. **Servicio:** Endpoint HTTP general 2. **Tipos de registro:** Solo tráfico (deja desactivados los registros de funciones, edge, despliegue y firewall) 3. **Formato:** NDJSON 4. **URL del endpoint:** el endpoint de AirOps del Paso 1 5. **Encabezado:** add `Authorization: Bearer ` 6. **Excluir PII:** deja esto **desactivado** (consulta la advertencia abajo) 7. Haz clic en **Conectar** para guardar el drain. {% hint style="warning" %} Deja **"Excluir PII" desactivado**. La opción de exclusión de PII de Netlify elimina el User-Agent y la IP del cliente de los registros de tráfico. AirOps identifica los agentes de IA a partir del User-Agent, así que con la PII excluida no se puede clasificar ningún tráfico de bots y tu panel permanecerá vacío. Mantenlo desactivado para Agent Analytics. {% endhint %} ## Paso 3: Verifica la conexión De vuelta en AirOps, vuelve a abrir **Configurar Agent Analytics** y elige **Netlify**, luego haz clic en **Ya lo he configurado**. Netlify ahora muestra una insignia verde **Conectado** en la lista de fuentes. Tu drain está activo en cuanto Netlify lo acepta, y el tráfico aparece en el panel a medida que los agentes de IA rastrean tus páginas monitoreadas. {% hint style="info" %} Prueba con una ruta real y existente en tu sitio. Las solicitudes a páginas inexistentes pueden servirse desde la caché edge de Netlify sin llegar al drain, así que una prueba de 404 no producirá datos. También confirma que el tipo de registro del drain esté configurado en **Tráfico**. {% endhint %} *** ## Solución de problemas | Síntoma | Causa probable | Solución | | ------------------------------------------------------------------------ | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | | No puedes ver el **Ya lo he configurado** botón | Tu rol no puede editar brand kits | Pídele a un administrador del espacio de trabajo que confirme la conexión por ti. | | El drain se guardó en Netlify, pero no aparecen datos en Agent Analytics | Ningún bot de IA ha visitado aún el sitio, o "Excluir PII" está activado | Confirma que el tráfico real esté llegando al sitio y desactiva "Excluir PII" en el drain. | | El tráfico sin procesar aparece, pero no se clasifica nada | "Excluir PII" está activado, por lo que falta el User-Agent | Edita el drain en Netlify y desactiva la exclusión de PII. AirOps necesita el User-Agent para identificar bots. | | Faltan datos a nivel de página en Page360 | El dominio de tu brand kit no coincide con el sitio | En AirOps, abre la configuración de Brand Kit y confirma que la Brand URL coincida con el dominio que sirve tu sitio de Netlify. | | El drain está configurado pero no hay filas después de unos minutos | Probaste una ruta que devuelve 404, o el tipo de registro no es Tráfico | Visita una ruta conocida que exista en tu despliegue y confirma que el tipo de registro del drain sea **Tráfico** (no solo función/edge). | | No puedes encontrar Log Drains en Netlify | Tu equipo no está en un plan Enterprise | Los Log Drains requieren **Netlify Enterprise**. Actualiza antes de configurarlo. | *** ## Requisitos del plan Los Log Drains de Netlify están disponibles solo en el **Netlify Enterprise** plan. Los planes Free, Personal y Pro no pueden crear drains; tu equipo necesita Enterprise antes de configurar esto. Netlify no publica un cargo aparte por GB para la salida de Log Drain; cualquier coste de datos forma parte de tu acuerdo de Netlify Enterprise. Para mantener bajo el volumen, envía al drain **solo registros de tráfico**. *** ## Configuración de seguridad y de privilegio mínimo ### Permisos necesarios para configurar **En Netlify:** un miembro del equipo que pueda administrar Log Drains en tu equipo Enterprise puede añadir el drain. **En AirOps:** el usuario debe haber iniciado sesión en AirOps y ser miembro del workspace de destino; cualquier rol de AirOps funciona. ### Autenticación en tiempo de ejecución No interviene ninguna sesión de usuario en ninguna entrega del drain. Cada entrega se autentica con un **token Bearer** en el encabezado `Authorization` encabezado, que es tu **clave API de AirOps de tu espacio de trabajo**, introducido en la configuración del drain durante la instalación. El token es del nivel del workspace, no del usuario. No hay ningún secreto de firma aparte que gestionar. ### Rotación de tokens La clave API del espacio de trabajo se puede rotar en la app en **Cuenta > Espacio de trabajo > Clave API** (requiere rol de administrador del espacio de trabajo de AirOps). Hay dos cosas que entender antes de rotar: * El drain de Netlify tiene el token anterior en su `Authorization` encabezado de salida. Después de la rotación, actualiza el encabezado del drain en Netlify con el nuevo token; de lo contrario, las entregas empezarán a fallar en la autenticación. * La misma clave API del workspace autentica otras API de AirOps (Public API, servidor MCP, SDK). Rotarla afecta a todas ellas, no solo a Netlify. ### Lo que esta integración no hace * Solo recibe los registros de tráfico que envía el drain. No tiene acceso a tu cuenta de Netlify, variables de entorno, registros de compilación ni despliegues. * No escribe nada de vuelta en tu cuenta de Netlify. Después de la configuración, AirOps solo recibe datos del drain. Si tu revisión de seguridad necesita más detalle, contacta con Customer Success de AirOps y podemos guiar a tu equipo a través del flujo de datos a nivel de implementación. *** ## Desconexión Para eliminar la integración de Netlify: 1. En Netlify, abre **Logs & Metrics > Log Drains** y elimina el drain de AirOps. 2. En AirOps, desconecta **Netlify** del selector de fuentes de datos. Tus datos históricos de Netlify permanecen en AirOps después de desconectarlo. Para reanudar el seguimiento, configura de nuevo el drain. *** ## Qué rastrea AirOps Una vez conectado, AirOps automáticamente: * **Ingresa todas las solicitudes servidas por Netlify** incluidas en los registros de tráfico: vistas de página, recursos, llamadas a la API * **Clasifica el tráfico de bots de IA:** identifica visitas de ChatGPT, Claude, Google, Perplexity, Meta, Apple, Bing, Bytedance, Common Crawl y otros * **Categoriza el comportamiento de rastreo:** distingue entre rastreadores de entrenamiento de IA (GPTBot, ClaudeBot, etc.), búsquedas de IA (PerplexityBot, OAI-SearchBot, etc.) y navegación de IA iniciada por el usuario (ChatGPT-User, Claude-User, etc.) * **Muestra analíticas:** desgloses del tráfico, proporciones bot frente a humano y tendencias de rastreo en tu panel --- # 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/es/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.