Saltar al contenido principal

Descripción general

La integración usa un trabajo de Cloudflare Logpush para enviar los registros de solicitudes HTTP a nuestra API de Agent Analytics. Cloudflare Logpush reenvía los registros de Cloudflare a un destino externo a Cloudflare, como Profound. Está disponible en todos los planes de Cloudflare. Consulta la documentación de Logpush de Cloudflare para obtener más información.

Requisitos previos

  • Una cuenta de Cloudflare
  • Acceso a la configuración de Cloudflare de tu dominio
  • Un Log Ingestion Token de Profound para Agent Analytics
Para usar un Cloudflare Worker en su lugar, consulta nuestra guía de integración con Cloudflare Workers.
Logpush detectado

Configuración

1

Paso 1

Selecciona tu dominio en el panel de Cloudflare. En el menú de la izquierda, ve a Observability > Export > Logpush.
Si tu panel todavía muestra el menú anterior, Logpush se encuentra en Analytics & Logs > Logpush.
Menú de la izquierda de Cloudflare con Observability, Export y Logpush seleccionados
2

Paso 2

Selecciona Create a Logpush job. En Select a destination, selecciona HTTP destination.Destino HTTP de Cloudflare
3

Paso 3

Introduce la URL de la API con el siguiente formato, incluyendo tu Log Ingestion Token de Profound, y selecciona Continue.
4

Paso 4

Selecciona Filtered logs en If logs match… y, a continuación, filtra por el campo ClientRequestHost para que coincida con tu dominio.
Usa tu propio dominio en el filtro. www.tryprofound.com es solo un ejemplo.
Filtro de registros de Cloudflare
5

Paso 5

Selecciona el conjunto de datos HTTP requests y elige los siguientes campos para enviar. Agent Analytics omite cualquier línea de registro a la que le falte un campo obligatorio. Los demás campos son opcionales.
  • Request
    • ClientIP (obligatorio) - Dirección IP del cliente.
    • ClientRequestHost (obligatorio) - Host solicitado por el cliente.
    • ClientRequestMethod (obligatorio) - Método HTTP de la solicitud del cliente.
    • ClientRequestReferer - Referrer de la solicitud HTTP.
    • ClientRequestURI (obligatorio) - URI solicitada por el cliente.
    • ClientRequestUserAgent (obligatorio) - User agent indicado por el cliente.
  • Performance
    • EdgeStartTimestamp (obligatorio) - Marca de tiempo en la que el edge recibió la solicitud del cliente.
    • EdgeEndTimestamp (obligatorio) - 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.

Solución de problemas

  • Si no aparecen los registros, verifica el Log Ingestion Token en la URL de la API.
  • Comprueba el estado del trabajo en Observability > Export > Logpush. Cloudflare muestra ahí el estado de entrega de cada trabajo.
  • Asegúrate de que el filtro de ClientRequestHost coincida con el dominio que registraste en Profound.
  • Asegúrate de que el conjunto de datos sea HTTP requests y de haber seleccionado todos los campos obligatorios del Paso 5. Agent Analytics omite cualquier línea de registro a la que le falte un campo obligatorio.

Recursos adicionales

Consideraciones de seguridad

  • Almacena los Log Ingestion Tokens como secretos en entornos de producción
  • Rota los Log Ingestion Tokens con regularidad
  • Supervisa el estado de tu trabajo de Logpush para detectar patrones inusuales