> 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/cloudfront-agent-analytics.md). # CloudFront Esta guía te muestra cómo configurar los registros en tiempo real de Amazon CloudFront para transmitirlos a AirOps mediante Amazon Kinesis Data Firehose. Esta guía te guía paso a paso para configurar Amazon CloudFront **registros en tiempo real** para transmitir a AirOps a través de **Amazon Kinesis Data Firehose**. Una vez conectado, AirOps analizará automáticamente tu tráfico, clasificará las visitas de bots de IA (ChatGPT, Claude, Perplexity, Google y más) y mostrará información en tu panel de Agent Analytics. *** ### Prerrequisitos * Una **AirOps** cuenta con Agent Analytics habilitado * Una **Cuenta de AWS** con acceso a CloudFront, Kinesis Data Firehose e IAM * Una **Distribución de CloudFront** que sirve tu sitio web * Tu **Clave API del Workspace:** disponible en Configuración (barra de navegación izquierda) > Workspace * Tu **ID del Brand Kit:** disponible en la URL navegando a Contexto (barra de navegación izquierda) > BrandKits, algo con la forma de `https://app.airops.com//data/brand_kits/` *** ### Paso 1: Crea un flujo de entrega de Kinesis Data Firehose 1. Abre el **Amazon Kinesis** consola y navega a **Data Firehose**. 2. Haz clic en **Crear flujo de Firehose**. 3. Configura el origen y el destino: * **Origen:** `PUT directo` * **Destino:** `Punto de conexión HTTP` 4. Nombra tu flujo (por ejemplo, `airops-cloudfront-analytics`). #### Configura el destino del punto de conexión HTTP | Configuración | Valor | | ---------------------------------- | ------------------------------------------------------------------------ | | **URL del punto de conexión HTTP** | `https://ingest.airops.com/api/v1/cloudfront//ingest` | | **Clave de acceso** | Tu clave API del Workspace de AirOps | | **Codificación de contenido** | `GZIP` | | **Duración de reintento** | `300` segundos (recomendado) |
#### Configura los parámetros de búfer | Configuración | Valor recomendado | | ----------------------- | ----------------- | | **Tamaño del búfer** | `5 MiB` | | **Intervalo del búfer** | `60` segundos | Estos ajustes controlan con qué frecuencia Firehose entrega lotes a AirOps. Estos son los ajustes recomendados para no recibir errores 429 de nuestros servidores. #### Configura la copia de seguridad * **Bucket S3 de copia de seguridad:** Selecciona o crea un bucket S3 para las copias de seguridad de entregas fallidas. * **Modo de copia de seguridad:** `Solo datos fallidos` (recomendado). 5. Haz clic en **Crear flujo de Firehose**. *** ### Paso 2: Crea una configuración de registro en tiempo real de CloudFront 1. Abre el **CloudFront** consola. 2. En la navegación izquierda, ve a **Registro > Agregar > Amazon Cloudwatch Logs**. 3. Selecciona Entregar a Amazon Kinesis Firehose. 4. Selecciona Flujo de destino: tu Firehose configurado 5. Configura los siguientes ajustes adicionales: | Configuración | Valor | | --------------------- | ------- | | **Campos** | `todos` | | **Formato de salida** | `JSON` | #### Selecciona campos de registro Selecciona **todos** de los siguientes campos. Todos son obligatorios, y los registros que falten alguno de ellos no pueden procesarse: | Campo | Obligatorio | | ----------------------------- | ----------- | | `timestamp(fecha)` | Sí | | `timestamp(hora)` | Sí | | `cs-method` | Sí | | `cs-uri-stem` | Sí | | `cs(User-Agent)` | Sí | | `cs(Referer)` | Sí | | `cs-protocol-version` | Sí | | `cs-protocol` | Sí | | `cs-bytes` | Sí | | `sc-status` | Sí | | `sc-bytes` | Sí | | `sc-content-type` | Sí | | `time-taken` | Sí | | `tiempo hasta el primer byte` | Sí | | `ssl-protocol` | Sí | | `ssl-cipher` | Sí | | `x-edge-location` | Sí | | `x-edge-result-type` | Sí | | `x-host-header` | Sí | `c-ip` y `cs-uri-query` no son obligatorios, y AirOps no almacena las direcciones IP de los visitantes ni las cadenas de consulta. Al seleccionar `todos` campos, estos se envían, pero los ignoramos. Si prefieres no compartirlos, déjalos fuera. 5. Haz clic en **Crear configuración**. *** ### Paso 3: Adjunta la configuración de registros a tu distribución 1. Ve a **CloudFront > Distribuciones** y selecciona tu distribución. 2. Ve a la pestaña **Comportamientos** pestaña de la Campaña. 3. Selecciona el comportamiento que quieres rastrear (normalmente `Predeterminado (*)`) y haz clic en **Editar**. 4. En **Configuración de registro en tiempo real**, selecciona la `airops-analytics` configuración que acabas de crear. 5. Haz clic en **Guardar cambios**. Repite esto para cualquier comportamiento de caché adicional que quieras supervisar. *** ### Paso 4: Verifica la conexión Después de adjuntar la configuración, los datos deberían empezar a fluir en un plazo de **2-5 minutos**. 1. Genera algo de tráfico en tu distribución de CloudFront (visita tu sitio web). 2. Revisa la pestaña de Firehose **Monitoreo** en la consola de AWS para confirmar que se están entregando registros. 3. En tu **panel de AirOps**, navega a **Agent Analytics** — deberías ver aparecer datos de tráfico en breve. #### Solución de problemas | Síntoma | Causa probable | Solución | | ----------------------------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | Firehose muestra errores de entrega (401) | Clave API no válida | Verifica tu clave API en AirOps Configuración > Integraciones | | Firehose muestra errores de entrega (429) | Límite de tasa superado | Aumenta el intervalo del búfer o el tamaño del búfer para reducir la frecuencia de entrega | | No hay datos en el monitoreo de Firehose | La configuración de registros no está adjunta | Confirma que la configuración de registro en tiempo real esté adjunta al comportamiento de tu distribución | | Datos en Firehose pero no en AirOps | Retraso de procesamiento | Espera hasta 10 minutos; verifica que el ID de tu Brand Kit sea correcto en la URL del punto de conexión | *** ### Límites de tasa El ingeridor de AirOps aplica un límite de tasa de **5 solicitudes por minuto por clave API**. Con la configuración de búfer recomendada (5 MiB / 60 segundos), te mantendrás muy por debajo de este límite. Si tienes distribuciones con mucho tráfico, aumenta el tamaño del búfer o el intervalo en consecuencia. *** ### Qué rastrea AirOps Una vez conectado, AirOps automáticamente: * **Ingiere todas las solicitudes de CloudFront** — vistas de página, activos, 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, búsquedas 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/cloudfront-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.