> 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/cloudflare-worker-agent-analytics.md). # Worker de Cloudflare Esta guía te muestra cómo configurar un Cloudflare Worker para transmitir registros de solicitudes a AirOps para Agent Analytics. Esta guía te muestra cómo configurar Cloudflare para transmitir a AirOps mediante **Workers**. Una vez conectado, AirOps analiza automáticamente tu tráfico, clasifica las visitas de bots de IA (ChatGPT, Claude, Perplexity, Google y más) y muestra información en tu panel de Agent Analytics. {% hint style="info" %} **¿Logpush o Worker?** Si estás en un plan Enterprise de Cloudflare, te recomendamos [Cloudflare Logpush](/docs/es/insights/onsite/traffic/cloudflare-logpush-agent-analytics.md) en su lugar. Es la opción más sencilla y no requiere código. Usa Workers cuando Logpush no esté disponible, como en planes que no sean Enterprise. {% endhint %} *** ## Prerrequisitos * Una **AirOps** cuenta con Agent Analytics habilitado * Una **Cloudflare** cuenta que sirve tu sitio web y que está en el nivel Enterprise o tiene el complemento Workers Paid * Una máquina de desarrollo con Node.js instalado * Tu **clave API del espacio de trabajo**, disponible en `Configuración → Espacio de trabajo` * Tu **ID de Brand Kit**, disponible en la URL al navegar a `Contexto → Kits de marca`. La URL tiene el formato `https://app.airops.com//data/brand_kits/` *** ## Workers por lotes La integración de procesamiento por lotes es el **recomendado** enfoque para la mayoría de los sitios web. Usa una Cloudflare Queue para almacenar en búfer los eventos de registro por solicitud y enviarlos a AirOps en lotes, manteniéndote muy por debajo del límite de tasa de AirOps incluso con volúmenes altos de tráfico. ### Paso 1: Inicializa el Worker de Cloudflare Para este proceso, usaremos la versión `2.68.2` de la CLI de Cloudflare. Otras versiones menores pueden funcionar, pero puede haber diferencias en las indicaciones de la CLI. {% hint style="info" %} Dependiendo de tu entorno de desarrollo, es posible que tengas que instalar manualmente los siguientes paquetes de Node: `node-addon-api`, `node-gyp`, y `sharp`. {% endhint %} ```bash npm create cloudflare@2.68.2 ``` Establece el directorio en `airops-log-collector`.
Establece el ejemplo inicial en `ejemplo de Hola Mundo`.
Establece la plantilla en `Worker consumidor y productor de cola`.
Establece el idioma en `TypeScript`.
Elige **Sí** para usar git para el control de versiones.
Elige **No** para desplegar tu aplicación (haremos esto más adelante).
### Paso 2: Configura la ruta del Worker de Cloudflare Edita el `wrangler.json` archivo y configura tu `pattern`, `zone_name`, las vinculaciones de cola y `AIROPS_API_URL`. {% hint style="info" %} La `pattern` debe ser tu dominio real o la URL del sitio de destino, mientras que el `zone_name` debe ser el dominio canónico. Por ejemplo, si tu sitio de destino es `https://blog.example.com`, el `pattern` debe ser `blog.example.com` y tu `zone_name` debe ser `example.com`. {% endhint %} ```json { "$schema": "node_modules/wrangler/config-schema.json", "name": "airops-log-collector", "main": "src/index.ts", "compatibility_date": "2026-05-18", "observability": { "enabled": true }, "queues": { "consumers": [ { "queue": "airops-log-collector-queue", "max_batch_size": 1000, "max_batch_timeout": 60 } ], "producers": [ { "binding": "AIROPS_LOG_COLLECTOR_QUEUE", "queue": "airops-log-collector-queue" } ] }, "upload_source_maps": true, "compatibility_flags": [ "nodejs_compat" ], "route": { "pattern": "example.com/*", "zone_name": "example.com" }, "vars": { "AIROPS_API_URL": "https://ingest.airops.com/api/v1/cloudflare-worker//ingest" } } ``` ### Paso 3: Configura el código del Worker de Cloudflare Reemplaza el contenido de `src/index.ts` archivo con el siguiente código. ```typescript export interface Env { AIROPS_API_URL: string; AIROPS_API_KEY: string; AIROPS_LOG_COLLECTOR_QUEUE: Queue; } export default { // El productor de cola se invoca en cada visita de página y guarda los metadatos de la solicitud en la cola async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise { // Guarda el momento en que comenzó la solicitud const startTime = Date.now(); // Realiza la solicitud const response = await fetch(request); // Clona la respuesta para poder reutilizarla const responseClone = response.clone(); ctx.waitUntil(handleRequest(startTime, request, responseClone, env)); return response; }, // El consumidor de cola lee mensajes de la cola y envía lotes periódicos a AirOps async queue(batch: MessageBatch, env: Env): Promise { const body = batch.messages.map(m => m.body).join('\n'); await fetch(env.AIROPS_API_URL, { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': env.AIROPS_API_KEY, }, body, }).catch(error => console.error('No se pudieron enviar los registros:', error)) } } satisfies ExportedHandler; async function handleRequest(startTime: number, request: Request, response: Response, env: Env) { const logData = { request_start_time: startTime, request_end_time: Date.now(), status_code: response.status, response_bytes: response.bytes.length, method: request.method, url: request.url, user_agent: request.headers.get('user-agent'), referer: request.headers.get('referer'), }; await env.AIROPS_LOG_COLLECTOR_QUEUE.send(JSON.stringify(logData)); } ``` ### Paso 4: Configura la clave API de AirOps {% hint style="info" %} Tu `AIROPS_API_KEY` debe establecerse con el mismo valor que tu clave API del espacio de trabajo, disponible en `Configuración → Espacio de trabajo`. {% endhint %} ```bash # Inicia sesión en Cloudflare npx wrangler login # Configura la clave API npx wrangler secret put AIROPS_API_KEY ``` ### Paso 5: Crea la cola de Cloudflare ```bash npx wrangler queues create airops-log-collector-queue ``` ### Paso 6: Despliega el Worker de Cloudflare ```bash # Despliega el Worker de Cloudflare npx wrangler deploy ``` ### Paso 7: Verifica la conexión Después de desplegar el Worker de Cloudflare, los datos deberían comenzar a fluir en **2-5 minutos**. 1. Genera algo de tráfico en tu sitio web. 2. En tu **panel de AirOps**, navega a **Agent Analytics**. Los datos de tráfico deberían aparecer pronto. *** ## Alternativa de Workers El enfoque alternativo de integración envía un evento a AirOps en cada visita de página. Esto es más adecuado para sitios web con menos visitas de página para evitar superar los límites de tasa y, por lo tanto, no se recomienda para la mayoría de los sitios web. ### Paso 1: Inicializa el Worker de Cloudflare Para este proceso, usaremos la versión `2.68.2` de la CLI de Cloudflare. Otras versiones menores pueden funcionar, pero puede haber diferencias en las indicaciones de la CLI. {% hint style="info" %} Dependiendo de tu entorno de desarrollo, es posible que tengas que instalar manualmente los siguientes paquetes de Node: `node-addon-api`, `node-gyp`, y `sharp`. {% endhint %} ```bash npm create cloudflare@2.68.2 ``` Establece el directorio en `airops-log-collector`.
Establece el ejemplo inicial en `ejemplo de Hola Mundo`.
Establece la plantilla en `Solo Worker`.
Establece el idioma en `TypeScript`.
Elige **Sí** para usar git para el control de versiones.
Elige **No** para desplegar tu aplicación (haremos esto más adelante).
### Paso 2: Configura la ruta del Worker de Cloudflare Edita el `wrangler.json` archivo y configura tu `pattern`, `zone_name`, y `AIROPS_API_URL`. {% hint style="info" %} La `pattern` debe ser tu dominio real o la URL del sitio de destino, mientras que el `zone_name` debe ser el dominio canónico. Por ejemplo, si tu sitio de destino es `https://blog.example.com`, el `pattern` debe ser `blog.example.com` y tu `zone_name` debe ser `example.com`. {% endhint %} ```json { "$schema": "node_modules/wrangler/config-schema.json", "name": "airops-log-collector", "main": "src/index.ts", "compatibility_date": "2026-05-18", "observability": { "enabled": true }, "upload_source_maps": true, "compatibility_flags": [ "nodejs_compat" ], "route": { "pattern": "example.com/*", "zone_name": "example.com" }, "vars": { "AIROPS_API_URL": "https://ingest.airops.com/api/v1/cloudflare-worker//ingest" } } ``` ### Paso 3: Configura el código del Worker de Cloudflare Reemplaza el contenido de `src/index.ts` archivo con el siguiente código. ```typescript export interface Env { AIROPS_API_URL: string; AIROPS_API_KEY: string; } export default { async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise { // Guarda el momento en que comenzó la solicitud const startTime = Date.now(); // Realiza la solicitud const response = await fetch(request); // Clona la respuesta para poder reutilizarla const responseClone = response.clone(); ctx.waitUntil(handleRequest(startTime, request, responseClone, env)); return response; } } satisfies ExportedHandler; async function handleRequest(startTime: number, request: Request, response: Response, env: Env) { const logData = { request_start_time: startTime, request_end_time: Date.now(), status_code: response.status, response_bytes: response.bytes.length, method: request.method, url: request.url, user_agent: request.headers.get('user-agent'), referer: request.headers.get('referer'), } await fetch(env.AIROPS_API_URL, { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': env.AIROPS_API_KEY }, body: JSON.stringify(logData) }).catch(error => console.error('No se pudieron enviar los registros:', error)) } ``` ### Paso 4: Configura la clave API de AirOps {% hint style="info" %} Tu `AIROPS_API_KEY` debe establecerse con el mismo valor que tu clave API del espacio de trabajo, disponible en `Configuración → Espacio de trabajo`. {% endhint %} ```bash # Inicia sesión en Cloudflare npx wrangler login # Configura la clave API npx wrangler secret put AIROPS_API_KEY ``` ### Paso 5: Despliega el Worker de Cloudflare ```bash # Despliega el Worker de Cloudflare npx wrangler deploy ``` ### Paso 6: Verifica la conexión Después de desplegar el Worker de Cloudflare, los datos deberían comenzar a fluir en **2-5 minutos**. 1. Genera algo de tráfico en tu sitio web. 2. En tu **panel de AirOps**, navega a **Agent Analytics**. Los datos de tráfico deberían aparecer pronto. *** ## Límites de tasa El ingeridor de AirOps aplica un límite de tasa de **5 solicitudes por minuto por clave API**. El Worker en tiempo real envía una solicitud por cada visita de página, por lo que esta opción es más adecuada para sitios con poco tráfico. Para sitios con mucho tráfico, usa solicitudes por lotes o una opción de ingesta con búfer. *** ## Qué rastrea AirOps Una vez conectado, AirOps automáticamente: * **Ingiere todas las solicitudes de Cloudflare**: vistas de página, activos y 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, capturas de búsqueda de IA, indexación de IA y navegación de IA iniciada por el usuario * **Muestra analíticas**: desglose del tráfico, proporciones de bots frente a humanos 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/cloudflare-worker-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.