Fastly

Descripción general

Envía los registros de acceso de Fastly a tu destino de S3 asignado por Profound para ver el tráfico de agentes en Agent Analytics. Esta guía cubre los servicios de CDN de Fastly que usan VCL y cifrado SSE-S3.

Contacta con el soporte de Profound para recibir el nombre de tu bucket, el prefijo de destino, la región y el ARN del rol de IAM antes de habilitar la entrega.

Para la entrega por HTTP, usa la integración HTTPS de Fastly. Para un servicio de Fastly Compute, contacta con soporte para confirmar la configuración de registro.

Requisitos previos

Acceso al servicio de Fastly que gestiona el tráfico de tu sitio web.
Permiso para editar endpoints de registro y activar una versión del servicio.
Tu ID de cuenta de Fastly, que Profound necesita para configurar los permisos de entrega.

Cifrado

Esta guía usa SSE-S3 (AES256) para cifrar tus registros en reposo con claves gestionadas por Amazon S3.

Configuración

Obtén la configuración de tu destino

Contacta con el soporte de Profound e indica tu dominio y tu ID de cuenta de Fastly. Profound configura el origen y un rol que permite a Fastly escribir en tu destino asignado.Recibirás un nombre de bucket, un prefijo de destino, una región y un ARN de rol. Usa el prefijo exactamente como se proporciona, incluida la barra final. El prefijo identifica tu origen.

s3://<assigned-bucket>/<assigned-prefix>/

El ARN del rol es el valor de autorización para esta configuración. No necesitas claves de acceso de AWS ni un token de ingesta HTTP de Profound.

Crea un endpoint de registro de S3

Abre tu servicio de Fastly y edita una versión del servicio. En su configuración de registro, crea un endpoint de Amazon S3.

Configuración	Valor
Name	Un nombre descriptivo
Bucket name	El bucket proporcionado por Profound
Path	Tu prefijo asignado completo, incluida la barra final
Domain	El endpoint de S3 de la región proporcionada; para `us-west-2`, usa `s3.us-west-2.amazonaws.com`
Access method	IAM Role
IAM role ARN	El rol proporcionado por Profound
Server side encryption	Amazon S3-managed keys (SSE-S3 / AES256)

Mantén la ubicación de registro predeterminada. Sigue la guía de endpoints de S3 de Fastly para ver el diseño actual del panel de control.

Establece el formato de registro

Pega esta plantilla en Log format como una sola línea. Emite los campos que espera el procesador de Fastly de Profound.

{"timestamp":"%{begin:%Y-%m-%dT%H:%M:%S%z}t","client_ip":"%{req.http.Fastly-Client-IP}V","host":"%{json.escape(req.http.Host)}V","url":"%{json.escape(req.url)}V","request_method":"%{json.escape(req.method)}V","request_referer":"%{json.escape(req.http.Referer)}V","request_user_agent":"%{json.escape(req.http.User-Agent)}V","response_status":%{resp.status}V,"response_body_size":%{resp.body_bytes_written}V}

Campos	Se usan para
`timestamp`	Hora de la solicitud
`client_ip`	Dirección del cliente
`host`	Dominio solicitado
`url`, `request_method`	Recurso solicitado
`request_referer`, `request_user_agent`	Análisis de referencias y agentes
`response_status`, `response_body_size`	Detalles de la respuesta

Usa Blank como formato de línea de registro (message_type=blank) para que no se añada ningún prefijo de syslog. Cada línea debe contener un objeto JSON. Profound no acepta el formato de registro predeterminado separado por espacios ni un array JSON para esta integración de S3.Usa salida sin comprimir o gzip. Los nombres de archivo gzip deben terminar en .gz para que Profound pueda descomprimirlos. No habilites el cifrado PGP, Snappy ni Zstandard para esta configuración.

Filtra por tu dominio

Adjunta una condición de registro que coincida con el nombre de host que quieres supervisar. Por ejemplo:

req.http.host == "example.com"

Reemplaza example.com con tu nombre de host. Incluye en tu condición cualquier nombre de host adicional que quieras supervisar.

Habilita la entrega

Una vez que Profound confirme que tu origen está listo, guarda el endpoint y activa la versión del servicio. Genera tráfico hacia el dominio configurado y espera a que Fastly entregue un archivo de registro.La configuración Period del endpoint controla con qué frecuencia se finalizan los archivos. Revisa esa configuración al estimar cuándo llegará tu tráfico de prueba.

Verificar la ingesta

Abre Agent Analytics para tu dominio y selecciona un rango de fechas que cubra tus solicitudes de prueba. Confirma que el tráfico de agentes esperado aparece después de la entrega y el procesamiento. Si faltan datos, contacta con soporte e indica tu dominio, el ID del servicio de Fastly, el nombre del endpoint, la hora de la solicitud y cualquier error de entrega o ruta de archivo de S3. No incluyas credenciales.

Solución de problemas

Problema	Qué comprobar
Fastly no puede asumir el rol	Verifica el ARN del rol y el ID de cuenta de Fastly proporcionados durante la configuración. Pide a Profound que revise la configuración de confianza del rol.
S3 informa AccessDenied	Compara el bucket, el prefijo, el endpoint regional y la configuración de cifrado con tus valores asignados.
La entrega se realiza correctamente, pero faltan datos	Confirma que el origen está listo, el campo `host` y el rango de fechas seleccionado.
Los registros no se pueden procesar	Usa la plantilla JSON de una sola línea y el formato de línea de registro Blank. Revisa la configuración de compresión.
No llega ningún archivo	Confirma que la versión del servicio está activa, que el tráfico coincide con la condición y que ha transcurrido el período de entrega de archivos.

General

Agent Analytics

Bots

Renderizado dinámico para bots

Profound Pixel

Descripción general

Requisitos previos

Cifrado

Configuración

Verificar la ingesta

Solución de problemas

Recursos adicionales

​Descripción general

​Requisitos previos

​Cifrado

​Configuración

​Verificar la ingesta

​Solución de problemas

​Recursos adicionales

Descripción general

Requisitos previos

Cifrado

Configuración

Verificar la ingesta

Solución de problemas

Recursos adicionales