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

# Cloudflare Logpush

Esta guía te muestra cómo configurar Cloudflare Logpush para transmitir registros de solicitudes HTTP a AirOps para Agent Analytics.

Esta guía te muestra cómo configurar Cloudflare para transmitir a AirOps mediante **Logpush**. 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.

Logpush es una función nativa, gestionada por Cloudflare, que agrupa los registros de solicitudes y los entrega a un extremo HTTP. A diferencia de la [integración con Workers](/docs/es/insights/onsite/traffic/cloudflare-worker-agent-analytics.md), no requiere código para desplegarse ni mantenerse, pero solo está disponible en el **Enterprise** plan.

{% hint style="info" %}
**¿Logpush o Worker?** Usar **Logpush** si tienes un plan Cloudflare Enterprise. Es la opción más sencilla y no requiere código. Si tienes cualquier otro plan, usa la [integración con Cloudflare Worker](/docs/es/insights/onsite/traffic/cloudflare-worker-agent-analytics.md) en su lugar, donde despliegas y mantienes un Worker pequeño.
{% endhint %}

***

## Prerrequisitos

* Una **AirOps** cuenta con Agent Analytics habilitado
* Una **Cloudflare** cuenta en el **Enterprise** plan (Logpush solo está disponible para Enterprise)
* Acceso de administrador a la zona de Cloudflare que sirve tu sitio web
* 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/<YOUR_WORKSPACE_SLUG>/data/brand_kits/<YOUR_BRAND_KIT_ID>`

***

## Configuración del panel

La configuración del panel es el **recomendado** enfoque para la mayoría de los sitios web. Logpush almacena temporalmente los eventos de registro por solicitud y los entrega a AirOps en lotes comprimidos según su propio ritmo.

### Paso 1: Crear un trabajo de Logpush

1. Abre el **panel de Cloudflare** y selecciona el dominio que sirve tu sitio web. Los trabajos de Logpush son específicos de cada dominio, así que debes estar dentro del dominio (zona) específico que quieres supervisar, no en la vista a nivel de cuenta.
2. En la navegación izquierda, despliega **Investigar** y selecciona **Logpush**.
3. Haz clic en **Crear un trabajo de Logpush**.
4. Para el conjunto de datos, selecciona **Solicitudes HTTP**.

### Paso 2: Seleccionar campos de registro

Selecciona los siguientes campos. AirOps los usa para análisis completos, y enviar campos adicionales no causa ningún problema.

| Campo                    | Obligatorio |
| ------------------------ | ----------- |
| `EdgeStartTimestamp`     | Sí          |
| `EdgeEndTimestamp`       | Sí          |
| `EdgeResponseStatus`     | Sí          |
| `EdgeResponseBytes`      | Sí          |
| `ClientRequestMethod`    | Sí          |
| `ClientRequestScheme`    | Sí          |
| `ClientRequestHost`      | Sí          |
| `ClientRequestURI`       | Sí          |
| `ClientRequestUserAgent` | Sí          |
| `ClientRequestReferer`   | Sí          |
| `ClientCountry`          | Sí          |
| `ClientDeviceType`       | Sí          |

### Paso 3: Configurar el destino HTTP

Configura el tipo de destino como **destino HTTP** e introduce el extremo de ingesta de AirOps como URL de destino. La clave API de tu Workspace se envía como un encabezado personalizado de la solicitud.

| Configuración      | Valor                                                                                                                      |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| **URL de destino** | `https://ingest.airops.com/api/v1/cloudflare-logpush/<YOUR_BRAND_KIT_ID>/ingest?header_X-API-Key=<YOUR_WORKSPACE_API_KEY>` |

{% hint style="info" %}
Cloudflare adjunta los encabezados personalizados de la solicitud como parámetros de consulta con el formato `header_<Name>=<Value>`. El `header_X-API-Key=<YOUR_WORKSPACE_API_KEY>` parámetro es la forma en que Cloudflare envía la clave API de tu Workspace de AirOps con cada entrega.
{% endhint %}

### Paso 4: Completa el desafío de propiedad

Antes de que se pueda crear el trabajo, Cloudflare verifica que eres el propietario del destino. Cloudflare envía mediante POST un token de propiedad a la URL de destino. Recupera ese token y pégalo de nuevo en el panel de Cloudflare para completar la verificación.

### Paso 5: Activar el trabajo

1. Revisa la configuración del trabajo.
2. Activa el trabajo para comenzar a entregar los registros.

### Paso 6: Verifica la conexión

Después de activar el trabajo de Logpush, los datos deberían empezar a fluir en **unos minutos** (Logpush agrupa por lotes antes de enviar).

1. En el **panel de Cloudflare**, revisa el estado de entrega del trabajo de Logpush. Una entrega exitosa reciente significa que los datos están llegando a AirOps.
2. En tu **panel de AirOps**, navega a **Agent Analytics**. La fuente de Cloudflare pasa a un estado conectado, y el tráfico de bots se llena una vez que los rastreadores visitan tu sitio.

***

## Configuración de la API

También puedes crear el trabajo de Logpush mediante programación usando la API de Cloudflare. Esto es útil para automatizar scripts o administrar muchas zonas. Necesitarás un token de API de Cloudflare con el **Edición de registros** permiso y tu **ID de zona**.

```bash
curl --request POST \
  "https://api.cloudflare.com/client/v4/zones/<YOUR_ZONE_ID>/logpush/jobs" \
  --header "Authorization: Bearer <YOUR_CLOUDFLARE_API_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "airops-log-collector",
    "dataset": "http_requests",
    "destination_conf": "https://ingest.airops.com/api/v1/cloudflare-logpush/<YOUR_BRAND_KIT_ID>/ingest?header_X-API-Key=<YOUR_WORKSPACE_API_KEY>",
    "output_options": {
      "field_names": [
        "EdgeStartTimestamp",
        "EdgeEndTimestamp",
        "EdgeResponseStatus",
        "EdgeResponseBytes",
        "ClientRequestMethod",
        "ClientRequestScheme",
        "ClientRequestHost",
        "ClientRequestURI",
        "ClientRequestUserAgent",
        "ClientRequestReferer",
        "ClientCountry",
        "ClientDeviceType"
      ],
      "timestamp_format": "rfc3339"
    },
    "enabled": true
  }'
```

{% hint style="info" %}
La `<YOUR_WORKSPACE_API_KEY>` pasado en el `destination_conf` debe tener el mismo valor que tu clave API de Workspace, disponible en `Configuración → Espacio de trabajo`. Cuando creas el trabajo mediante la API, Cloudflare todavía requiere el paso del desafío de propiedad descrito arriba antes de que comiencen las entregas.
{% endhint %}

***

## Qué esperar después de la configuración

* Los registros comienzan a llegar al **destino HTTP** que configuraste en **minutos**. Logpush agrupa los eventos de registro según su propio ritmo antes de entregarlos. Este es el tiempo de entrega a ese extremo, no cuándo aparece el tráfico en tu panel.
* Agent Analytics muestra **solo tráfico de bots de IA y rastreadores**. No se muestra la navegación humana.
* Un brand kit aparece como configurado una vez que Logpush entrega su primer lote. Las páginas específicas aparecen una vez que un bot rastrea una página supervisada.

***

## Si no ves datos

| Síntoma                                                                 | Causa probable                                              | Solución                                                                                                                   |
| ----------------------------------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| El trabajo de Cloudflare muestra errores de entrega / respuestas no 2xx | La URL de destino o la autenticación están mal configuradas | Vuelve a comprobar el ID de Brand Kit en la URL y confirma `?header_X-API-Key=` es tu clave API actual de AirOps Workspace |
| Cloudflare muestra `401` / `403` respuestas                             | Clave incorrecta o rotada, o espacio de trabajo incorrecto  | Verifica que la clave API esté vigente y que el Brand Kit pertenezca a ese espacio de trabajo                              |
| Entrega exitosa, pero Agent Analytics está vacío                        | Esperado: solo se muestra tráfico de bots                   | Espera a que un rastreador visite; las visitas humanas no se muestran                                                      |
| Las primeras filas de bots aún no han aparecido                         | Momento del rastreo                                         | Las primeras filas visibles aparecen cuando un rastreador vuelve a visitar, lo que depende de la frecuencia de rastreo     |

Si sigues atascado, contacta con el soporte de AirOps con tu **ID de Brand Kit** y el **estado de entrega**.

***

## Detener o desconectar

Para dejar de enviar datos a AirOps, desactiva o elimina el trabajo de Logpush en el panel de Cloudflare. Rotar tu clave API de AirOps Workspace también detiene la entrega, ya que Cloudflare seguirá enviando la clave antigua.

***

## Qué rastrea AirOps

Una vez conectado, AirOps automáticamente:

* **Ingresa tus registros de solicitudes de Cloudflare** mediante Logpush
* **Clasifica el tráfico de bots de IA**: identifica visitas de ChatGPT, Claude, Google, Perplexity, Gemini, 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**: desgloses del tráfico de bots de IA y rastreadores 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-logpush-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.