> ## 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.

# Fastly

> Entrega los registros de acceso de Fastly a Profound a través de Amazon S3.

## 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.

<Info>
  Contacta con el [soporte de Profound](mailto:support@tryprofound.com) 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.
</Info>

Para la entrega por HTTP, usa la [integración HTTPS de Fastly](/es/agent-analytics/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

<Steps>
  <Step title="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.

    ```text theme={null}
    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.
  </Step>

  <Step title="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](https://www.fastly.com/documentation/guides/integrations/logging-endpoints/object-and-cloud-storage/log-streaming-amazon-s3/) de Fastly para ver el diseño actual del panel de control.
  </Step>

  <Step title="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.

    ```text theme={null}
    {"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.
  </Step>

  <Step title="Filtra por tu dominio">
    Adjunta una condición de registro que coincida con el nombre de host que quieres supervisar. Por ejemplo:

    ```text theme={null}
    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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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. |

## Recursos adicionales

* [Fastly: Log streaming to Amazon S3](https://www.fastly.com/documentation/guides/integrations/logging-endpoints/object-and-cloud-storage/log-streaming-amazon-s3/)
* [Configuración del endpoint de S3 de Fastly](https://www.fastly.com/documentation/reference/api/logging/s3/)
* [Integración HTTPS de Fastly](/es/agent-analytics/fastly)
* [Contactar con el soporte de Profound](mailto:support@tryprofound.com)