> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Cloudflare (Logpush)

> Esta documentación explica cómo configurar e implementar un Cloudflare Worker que captura datos de solicitudes HTTP y los reenvía a la plataforma Agent Analytics de Profound mediante Cloudflare Logpush.

## Descripción general

La integración usa Cloudflare Logpush, que se ejecuta como middleware para recopilar metadatos de las solicitudes y enviarlos a nuestra API de Agent Analytics. Cloudflare Logpush es una función de Cloudflare Enterprise que te permite reenviar los registros de Cloudflare a un destino externo a Cloudflare, como Profound. Para obtener más información sobre Cloudflare Logpush, [visita el sitio de documentación](https://developers.cloudflare.com/logs/about/).

## Requisitos previos

* Una cuenta de Cloudflare con el plan Enterprise

* Acceso a la configuración de Cloudflare de tu dominio

* Un Log Ingestion Token de Profound para Agent Analytics

<Tip>
  ¿Usas el plan Free/Pro de Cloudflare? Consulta nuestra <a href="/es/agent-analytics/cloudflare_worker" target="_self">guía de integración con Cloudflare Workers</a>.
</Tip>

<img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/cloudflare_logpush/logpush_setup.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=1f3d1936ae852ac98962c9167a90e126" alt="Logpush detectado" width="3680" height="2390" data-path="images/agent-analytics/cloudflare_logpush/logpush_setup.png" />

## Configuración

<Steps>
  <Step title="Paso 1">
    Selecciona tu dominio en el panel de Cloudflare y ve a **Analytics & Logs -> Logpush**

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/cloudflare_logpush/cloudflare_logpush_nav.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=625b1175af5e6297333789cb96f6da7b" alt="Navegación a Cloudflare Logpush" width="248" height="258" data-path="images/agent-analytics/cloudflare_logpush/cloudflare_logpush_nav.png" />
  </Step>

  <Step title="Paso 2">
    Crea un nuevo trabajo de Logpush y selecciona el destino HTTP

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/cloudflare_logpush/cloudflare_http_destination.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=ed84b38394cdeec008e1ce996f9115d6" alt="Destino HTTP de Cloudflare" width="246" height="296" data-path="images/agent-analytics/cloudflare_logpush/cloudflare_http_destination.png" />
  </Step>

  <Step title="Paso 3">
    Usa el siguiente formato de URL de la API para incluir tu Log Ingestion Token de Profound y continúa

    ```http theme={null}
    https://artemis.api.tryprofound.com/v1/logs/cloudflare_logpush?header_X-API-Key=bot_PROFOUND_LOG_INGESTION_TOKEN
    ```
  </Step>

  <Step title="Paso 4">
    Selecciona `Filtered logs` en **If logs match...**

    Y filtra por el campo `ClientRequestHost` para que coincida con tu dominio

    <Tip>
      Asegúrate de usar tu dominio en el filtro. No uses `www.tryprofound.com`; es solo un ejemplo.
    </Tip>

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/cloudflare_logpush/cloudflare_filter_logs.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=39352a097e7fc3cfd9248d64b684c3ee" alt="Filtro de registros de Cloudflare" width="1297" height="258" data-path="images/agent-analytics/cloudflare_logpush/cloudflare_filter_logs.png" />
  </Step>

  <Step title="Paso 5">
    Selecciona el conjunto de datos HTTP requests y elige los siguientes campos para enviar:

    * Request

      * `ClientIP` - Dirección IP del cliente.

      * `ClientRequestHost` - Host solicitado por el cliente.

      * `ClientRequestMethod` - Método HTTP de la solicitud del cliente.

      * `ClientRequestReferer` - Referrer de la solicitud HTTP.

      * `ClientRequestURI` - URI solicitada por el cliente.

      * `ClientRequestUserAgent` - User agent indicado por el cliente.

    * Performance

      * `EdgeStartTimestamp` - Marca de tiempo en la que el edge recibió la solicitud del cliente.

      * `EdgeEndTimestamp` - Marca de tiempo en la que el edge terminó de enviar la respuesta al cliente.

    * Response

      * `EdgeResponseBytes` - Número de bytes devueltos por el edge al cliente.

      * `EdgeResponseStatus` - Código de estado HTTP devuelto por Cloudflare al cliente.

    ¡Eso es todo! Has configurado correctamente Profound Agent Analytics para tu sitio web. Los datos deberían empezar a aparecer en tu panel en el plazo de una hora.
  </Step>
</Steps>

## Solución de problemas

* Si no aparecen los registros, verifica tu Log Ingestion Token y la URL

* Revisa Workers > Analytics para ver si hay errores de ejecución

* Asegúrate de que el patrón de tu ruta coincida con la configuración de tu dominio

* Verifica que el Worker esté recibiendo solicitudes consultando las métricas del panel de Cloudflare

## Recursos adicionales

* [Documentación de Cloudflare Logpush](https://developers.cloudflare.com/logs/about/)

* [Documentación de Cloudflare para habilitar el destino HTTP](https://developers.cloudflare.com/logs/get-started/enable-destinations/http/)

* Escribe a [support@tryprofound.com](mailto:support@tryprofound.com) si tienes preguntas relacionadas con la API

## Consideraciones de seguridad

* Almacena los Log Ingestion Tokens como secretos en entornos de producción

* Rota los Log Ingestion Tokens con regularidad

* Supervisa el uso y los registros del Worker para detectar patrones inusuales
