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

# Endpoint HTTPS de Fastly

> Esta documentación explica cómo configurar la entrega de registros en tiempo real de Fastly a la plataforma Profound Agent Analytics mediante un endpoint HTTPS personalizado de Fastly

## Descripción general

La integración usa el endpoint HTTPS personalizado de Fastly para reenviar los registros en tiempo real de Fastly a nuestra API de Agent Analytics. La transmisión de registros en tiempo real de Fastly ofrece visibilidad instantánea del tráfico, el rendimiento, las amenazas y la resolución de problemas, y transmite registros a diversos destinos, incluidos endpoints HTTP. Para obtener más información sobre los registros en tiempo real de Fastly, [visita la documentación de Fastly](https://docs.fastly.com/en/guides/streaming-logs).

## Requisitos previos

* Una cuenta de Fastly

* Acceso o permiso para editar Logging Endpoints

* Un Log Ingestion Token de Profound para Agent Analytics

## Configuración

<img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/fastly_setup.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=376e9c92e922aed26a434d2028bc0af0" alt="Fastly detectado" width="3680" height="2390" data-path="images/agent-analytics/fastly/fastly_setup.png" />

<Steps>
  <Step title="Paso 1">
    Inicia sesión en la consola de Fastly, selecciona tu servicio y ve a la pestaña Service configuration.

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/service_configuration.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=9f5c9b84ec0be5034c9e3d29a998bc68" alt="Pestaña Service configuration" width="2542" height="348" data-path="images/agent-analytics/fastly/service_configuration.png" />
  </Step>

  <Step title="Paso 2">
    Selecciona "Edit configuration" y ve a la sección Logging.

    Busca "HTTPS" y haz clic en `+ Create endpoint`

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/logging_endpoint.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=1fdf94eb3baeea16c21a0b2d651602f7" alt="Logging Endpoint" width="2490" height="2018" data-path="images/agent-analytics/fastly/logging_endpoint.png" />
  </Step>

  <Step title="Paso 3">
    Configura tu endpoint HTTPS con los siguientes ajustes:

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/create_https_endpoint.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=f229d92714f0e359e77fe14b9e625acf" alt="Configuración" width="1348" height="1840" data-path="images/agent-analytics/fastly/create_https_endpoint.png" />

    * **Name:** añade un nombre descriptivo

    * **Placement:** usa el valor predeterminado

    * **URL:** introduce `https://artemis.api.tryprofound.com/v1/logs/fastly`

    * **Maximum logs & Maximum bytes:** opcional, configúralo según sea necesario.

    * **Log format**: pega el siguiente formato de registro. Este determina qué información se enviará a la API de Agent Analytics. Si usas un formato diferente, la API podría rechazar tus registros.

      ```
        {
            "timestamp": "%{strftime(\{"%Y-%m-%dT%H:%M:%S%z"\}, time.start)}V",
            "client_ip": "%{req.http.Fastly-Client-IP}V",
            "start_time": "%{begin:%Y-%m-%dT%H:%M:%S%z}t",
            "end_time": "%{end:%Y-%m-%dT%H:%M:%S%z}t",
            "host": "%{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
        }
      ```

      * Hora e IP

        * `timestamp`: hora en que se completó la solicitud

        * `client_ip`: dirección IP del cliente

      * Detalles de la solicitud

        * `request_method`: método de la solicitud HTTP

            \* `host`: encabezado host solicitado

    * `url`: ruta URL de la solicitud

    * `request_referer`: referente de la solicitud

    * `request_user_agent`: agente de usuario del cliente

    * Detalles de la respuesta

      * `start_time`: hora en que comenzó la solicitud

      * `end_time`: hora en que finalizó la solicitud

      * `response_status`: estado de la respuesta HTTP

      * `response_body_size`: tamaño de la respuesta en bytes

    *Para obtener más información, consulta la [documentación](https://docs.fastly.com/en/guides/useful-variables-to-log)*

    <Note>
      Es posible que veas una advertencia como esta:

      <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/warning_message.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=05aab745a4e1946bb2ae3cec2df9527c" alt="Mensaje de advertencia" width="1908" height="130" data-path="images/agent-analytics/fastly/warning_message.png" />

      Puedes ignorar este mensaje sin problema. La validación ya está configurada por ti.
    </Note>
  </Step>

  <Step title="Paso 4">
    A continuación, haz clic en "Attach a condition"

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/attach_a_condition1.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=70409e193f42a771baa45bb24c161099" alt="Attach a condition 1" width="934" height="104" data-path="images/agent-analytics/fastly/attach_a_condition1.png" />

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/attach_a_condition2.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=a9c05f001e10b3e81e3b9d7e63bd3817" alt="Attach a condition 2" width="1842" height="264" data-path="images/agent-analytics/fastly/attach_a_condition2.png" />

    Introduce lo siguiente usando tu nombre de dominio:

    `req.http.host == "my-website.com"`

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/filter_to_host.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=70fb508bcb2ebfc02de72b1603b7ee9b" alt="Filtrar por host" width="990" height="1100" data-path="images/agent-analytics/fastly/filter_to_host.png" />

    Este filtro garantiza que solo se envíen a Profound los registros del dominio seleccionado. Selecciona `Save and apply`.
  </Step>

  <Step title="Paso 5">
    Desplázate hacia abajo hasta "Advanced options"

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/advanced_options.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=f604cc2170c571c08d0f610874d8c6c2" alt="Opciones avanzadas" width="1942" height="1498" data-path="images/agent-analytics/fastly/advanced_options.png" />

    Configura:

    * **Content type**: `application/json`

    * **Custom header name**: `X-API-Key`

    * **Custom header value**: el Log Ingestion Token que se te asignó para la plataforma Agent Analytics de Profound (`bot_PROFOUND_LOG_INGESTION_TOKEN`)

    * **Method**: `POST`

    * **JSON log entry format**: `Array of JSON`

    * **Select a log line format**: `Blank`
  </Step>

  <Step title="Finalizado">
    Guarda tu configuración y activa la nueva versión del servicio.
  </Step>
</Steps>

<Check>¡Listo! Fastly ahora enviará registros en tiempo real a Profound. Los datos deberían empezar a aparecer en tu panel en pocos minutos.</Check>

## Solución de problemas

* Si no aparecen registros, verifica la configuración de tu endpoint HTTPS

* Revisa si hay errores de entrega en Fastly

* Verifica que tu Log Ingestion Token sea correcto

* Verifica que tu endpoint de la API sea correcto

## Recursos adicionales

* [Transmisión de registros en tiempo real de Fastly](https://docs.fastly.com/en/guides/about-fastlys-realtime-log-streaming-features)

* [Transmisión de registros: HTTPS](https://docs.fastly.com/en/guides/log-streaming-https)

* [Formatos de registro](https://docs.fastly.com/en/guides/useful-log-formats)

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