Vea, busque y filtre los registros de solicitudes web de su sitio con Cloud Logging

Puede vincular su proyecto de Firebase a Cloud Logging para ver, buscar y filtrar sus registros de solicitudes web para cada uno de sus sitios de hospedaje. Estos registros provienen de la CDN que Firebase proporciona automáticamente, por lo que se registran todas las solicitudes a su sitio y los datos de solicitud asociados.

Estas son algunas de las cosas que puede hacer con los registros de Cloud Logging. Visite cada sección de esta página para conocer los detalles.

Si tiene varios sitios de hospedaje en su proyecto, puede seleccionar cuál de sus sitios de hospedaje exportará registros. Luego puede filtrar y ver sus datos de registros por sitio de alojamiento e incluso por dominio. Al seleccionar sitios de alojamiento específicos para exportar registros, también puede controlar la cantidad de datos procesados ​​para su proyecto.

  1. Haga clic en Enlace en la tarjeta de integración de Cloud Logging en Firebase console.

    Para vincular o desvincular Cloud Logging, necesita los permisos incluidos en cualquiera de los siguientes roles: propietario o editor del proyecto o administrador de desarrollo de Firebase .

  2. Siga las instrucciones en pantalla para seleccionar cuál de sus sitios de alojamiento debe exportar registros a Cloud Logging.

    Si ya tiene uno o más sitios de hospedaje activos, el flujo de trabajo de vinculación muestra un nivel de uso de datos estimado para los registros de cada uno de sus sitios de hospedaje. Este valor se estima a partir de los últimos 30 días.

Después de vincularse a Cloud Logging, los registros de cualquier solicitud nueva a sus sitios de alojamiento generalmente aparecerán dentro de los 30 minutos posteriores a la realización de la solicitud.

También puede desvincular Firebase Hosting de Cloud Logging, lo que detiene las exportaciones de registros de solicitudes web a Cloud Logging.

Supervise su uso de datos para registros

Después de vincularse a Cloud Logging, puede ver el nivel de uso de datos para los registros de sus sitios de alojamiento:

Comprenda mejor su sitio

La interfaz del Visor de registros en Google Cloud Console ofrece herramientas para ver sus registros y datos específicos mediante consultas y filtros integrados y paneles de datos. Obtenga más información sobre cómo filtrar sus registros con consultas en la siguiente sección a continuación.

  • ¿De dónde proviene el tráfico de su sitio a nivel granular?
    Puede ver información sobre cada solicitud, incluida la IP de origen, la referencia, la ciudad y el estado.

  • ¿Cuándo visitan los usuarios su sitio?
    Puede usar el panel Histograma para ver la distribución por intervalos de tiempo específicos. Esto puede brindarle información sobre los picos y caídas normales del uso de su aplicación, así como también revelar picos inesperados en el tráfico.

  • ¿Cuál es la distribución del estado de las solicitudes de los usuarios finales?
    Puede ver el estado de cada solicitud e incluso diagnosticar las solicitudes que reciben errores. Puede filtrar sus registros por Critical , Error o Warning .

  • ¿Cuánto tarda su sitio en responder a una solicitud?
    Puede ver la latencia de su sitio para cada solicitud utilizando el valor de latency capturado en cada registro.

  • ¿Su sitio está aprovechando el almacenamiento en caché de contenido?
    Cada registro contiene un campo cacheHit para informarle si el recurso de su sitio se sirvió rápidamente desde el caché CDN de Hosting, o si tuvo que hacer el viaje completo al backend de Hosting. Esto puede ayudarlo a mejorar el rendimiento de su sitio web al aprovechar al máximo la CDN global de Firebase. Por ejemplo, puede usar los datos para ajustar los hábitos de almacenamiento en caché de sus activos estáticos y contenido dinámico .

  • ¿Cuál es la distribución del tráfico a sus diversos dominios?
    Si tiene varios dominios o sitios de alojamiento, puede filtrar sus registros por dominio o por sitio. Esto le permite ver cómo se distribuye su tráfico. Cuando filtra por dominio, puede rastrear qué dominio se visita con más frecuencia.

Filtra tus registros con consultas

Para obtener información sobre cómo filtrar sus registros con consultas, visite Consultas de muestra con el Visor de registros y Creación de consultas de registros . La siguiente tabla describe los campos disponibles para esas consultas.

Para Hosting, aquí hay algunos filtros iniciales para una consulta:

  • Recurso ( resource.type ) — firebase_domain (Dominio del sitio de alojamiento de Firebase)
  • Nombre de registro ( logName ) — webrequests (Firebase Hosting)

Cada entrada de registro tiene una estructura predefinida y campos consultables (consulte LogEntry ). Para Hosting, algunos campos son estándar para una solicitud HTTP, pero hay otros valores de campo que provienen del procesamiento que Hosting ejecuta en cada solicitud.

Campo Descripción
Firebase Hosting almacena los siguientes campos en el objeto httpRequest de la entrada de registro.
Estos campos se definen en la especificación HTTP.
cacheHit Si el Hosting CDN tenía o no el recurso de la respuesta en caché
latency La duración de la solicitud, en segundos con el sufijo s (por ejemplo, 1.256s )
protocol El protocolo utilizado para la solicitud (por ejemplo, HTTP/1.1 , HTTP/2 , websocket )
referer La dirección de la página web anterior desde la que se siguió un enlace a la página solicitada actualmente (si está presente)
remoteIp La IP del cliente de origen para la solicitud
requestMethod El método de solicitud ( GET , POST , PUT , etc.)
requestSize El tamaño de la solicitud en bytes.
requestUrl La URL completa de la solicitud (por ejemplo,
https://foo.web.app/bar o https://custom.domain.com?query=param )
responseSize El tamaño de la respuesta HTTP en bytes
serverIp No poblado
status El estado de la respuesta HTTP (por ejemplo, 200 o 404 )
userAgent El encabezado del agente de usuario de la solicitud.
Firebase Hosting almacena campos adicionales en el objeto jsonPayload de la entrada de registro.
acceptEncoding (de la solicitud HTTP) Qué codificación de contenido, generalmente un algoritmo de compresión, admite el cliente (por ejemplo, gzip o compress )
billable Si su proyecto fue facturado o no por la solicitud
customDomain Si la solicitud se realizó o no contra un dominio personalizado
hostname El nombre de host contra el que se realizó la solicitud
remoteIpCountry El país de origen de la solicitud.
remoteIpCity La ciudad de origen de la solicitud.

Usar métricas basadas en registros

Puede ver y crear métricas basadas en registros y luego usar estas métricas en Cloud Monitoring para crear gráficos y políticas de alerta.

  • Aproveche las métricas del sistema predefinidas que se registran automáticamente, como la cantidad de eventos de registro que ocurrieron dentro de un período de tiempo específico.

  • Cree métricas definidas por el usuario para su proyecto. Puede contar la cantidad de entradas de registro que coinciden con una consulta determinada o realizar un seguimiento de valores particulares con las entradas de registro coincidentes. Puede filtrar usando expresiones regulares.

  • Use Cloud Monitoring para registrar la cantidad de entradas de registro que contienen mensajes particulares o extraiga la información de latencia informada en las entradas de registro. Luego puede usar estas métricas en gráficos y políticas de alerta.

Firebase Hosting también genera las siguientes métricas de registro específicas de Hosting. Estas métricas no son específicas de una entrada de registro, sino del sitio de alojamiento específico en su conjunto.

  • log_bytes : bytes totales de uso de datos para cada sitio

  • response_count : Recuento total de respuestas escritas para el sitio

    Esta métrica incluye el campo de estado HTTP, por lo que puede trazar respuestas HTTP por estado (como ejemplo).

Exportar registros a otras herramientas de Google Cloud

También puedes exportar los registros de tu sitio a otras herramientas de Google Cloud, como Cloud Monitoring o BigQuery, por ejemplo:

  • Con Cloud Monitoring , puede crear métricas basadas en registros que puede usar en gráficos y políticas de alerta.

  • Con BigQuery , puede hacer cualquiera de las siguientes cosas:

    • Use Data Studio para generar tableros de sus datos de Hosting.
    • Ejecute consultas para obtener más información sobre sus solicitudes (tamaño de respuesta promedio, aciertos de caché frente a errores, etc.).
    • Descubra qué URL solicitan realmente sus usuarios.
    • Combine sus datos de Hosting con otros datos de Firebase que exportó a BigQuery y consúltelos de nuevas formas.