Visualiza, busca y filtra los registros de solicitudes web de tu sitio con Cloud Logging

Puedes vincular tu proyecto de Firebase a Cloud Logging para visualizar, buscar y filtrar los registros de solicitudes web de cada uno de tus sitios de Hosting. Estos registros provienen de la CDN que Firebase proporciona de forma automática, por lo que se registran todas las solicitudes a tu sitio y los datos asociados con ellas.

Estas son algunas de las acciones que puedes realizar con los registros de Cloud Logging. Revisa cada sección de esta página para obtener más información.

Si tienes varios sitios de Hosting en tu proyecto, puedes seleccionar cuál de ellos exportará registros. Luego puedes filtrar y visualizar tus datos de registros por sitio de Hosting o, incluso, por dominio. Si seleccionas sitios de Hosting específicos para exportar registros, también puedes controlar la cantidad de datos procesados para tu proyecto.

  1. En Firebase console, haz clic en Vincular en la tarjeta de integración de Cloud Logging.

    Para vincular o desvincular Cloud Logging, debes tener los permisos agrupados en los siguientes roles: Propietario o Editor del proyecto, o Administrador de Firebase Develop.

  2. Sigue las instrucciones en pantalla para seleccionar cuáles de tus sitios de Hosting deben exportar registros a Cloud Logging.

    Si ya tienes uno o más sitios de Hosting activos, el flujo de trabajo de vinculación muestra un nivel estimado de uso de datos para los registros de cada uno de tus sitios de Hosting. Este valor se calcula con los datos de los últimos 30 días.

Después de vincular a Cloud Logging, los registros de cualquier solicitud nueva a tus sitios de Hosting suelen aparecer en el plazo de 30 minutos posteriores a la solicitud.

También puedes desvincular Firebase Hosting de Cloud Logging, lo que detiene la exportación de registros de solicitudes web a Cloud Logging.

Supervisa el uso de datos de los registros

Después de vincular a Cloud Logging, en las siguientes ubicaciones puedes visualizar el nivel de uso de datos de los registros de tus sitios de Hosting:

Comprende mejor el sitio

La interfaz del visor de registros en la consola de Google Cloud ofrece herramientas para visualizar registros y datos específicos mediante consultas y filtros y paneles de datos integrados. Obtén más detalles en la siguiente sección para filtrar los registros con consultas.

  • ¿De dónde proviene el tráfico de tu sitio en detalle?
    Puedes ver información sobre cada solicitud, como la IP de origen, la referencia, la ciudad y el estado.

  • ¿Cuándo visitan tu sitio los usuarios?
    Puedes usar el panel de histograma para ver la distribución por intervalos de tiempo específicos. Esto puede brindarte estadísticas sobre los incrementos y descensos normales del uso de tu app, además de revelar los aumentos repentinos del tráfico.

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

  • ¿Cuánto tiempo tarda el sitio en responder a una solicitud?
    Puedes ver la latencia del sitio para cada solicitud mediante el valor latency capturado en cada registro.

  • ¿Tu sitio aprovecha el almacenamiento en caché del contenido?
    Cada registro contiene un campo cacheHit, que indica si el recurso de tu sitio se entregó con rapidez desde la caché de CDN de Hosting o si tuvo que hacer todo el recorrido hacia el backend de Hosting. Esto puede ayudarte a mejorar el rendimiento del sitio web, ya que aprovechas al máximo la CDN global de Firebase. Por ejemplo, puedes usar los datos para ajustar los hábitos de almacenamiento en caché de tus elementos estáticos y del contenido dinámico.

  • ¿Cuál es la distribución del tráfico a tus diversos dominios?
    Si tienes varios dominios o sitios de Hosting, puedes filtrar los registros por dominio o sitio. Esto te permite ver cómo se distribuye el tráfico. Cuando filtras por dominio, puedes realizar un seguimiento del dominio que se visita con mayor frecuencia.

Filtra los registros con consultas

Si quieres aprender a filtrar tus registros con consultas, visita las seccionesConsultas de muestra mediante el visor de registros y Compila consultas de registros. En la siguiente tabla se describen los campos disponibles para esas consultas.

En el caso de Hosting, estos son algunos filtros iniciales para una consulta:

  • Resource (Recurso) (resource.type): firebase_domain (dominio del sitio de Firebase Hosting)
  • Log name (Nombre del registro) (logName): webrequests (Firebase Hosting)

Cada entrada de registro tiene una estructura predefinida y campos que se pueden consultar (revisa LogEntry). En el caso de 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 Indica si la CDN de Hosting tuvo o no el recurso de la respuesta en la caché
latency Duración de la solicitud en segundos con el sufijo s (por ejemplo, 1.256s)
protocol Protocolo usado para la solicitud (por ejemplo, HTTP/1.1, HTTP/2, websocket)
referer Dirección de la página web anterior desde la que se siguió un vínculo a la página solicitada actualmente (si está presente)
remoteIp IP de cliente de origen de la solicitud
requestMethod Método de solicitud (GET, POST, PUT, etc.)
requestSize Tamaño de la solicitud en bytes
requestUrl URL completa de la solicitud (por ejemplo,
https://foo.web.app/bar o https://custom.domain.com?query=param)
responseSize Tamaño de la respuesta HTTP en bytes
serverIp no propagado
status Estado de la respuesta HTTP (por ejemplo, 200 o 404)
userAgent Encabezado de usuario-agente de la solicitud
Firebase Hosting almacena campos adicionales en el objeto jsonPayload de la entrada de registro.
acceptEncoding (de la solicitud HTTP) Indica la codificación de contenido (en general un algoritmo de compresión) que admite el cliente, como gzip o compress
billable Indica si el proyecto se facturó o no para la solicitud
customDomain Indica si la solicitud se realizó o no a un dominio personalizado
hostname Nombre de host al que se realizó la solicitud
remoteIpCountry País de origen de la solicitud
remoteIpCity Ciudad de origen de la solicitud

Usa métricas basadas en registros

Visualiza y compila métricas basadas en registros y, luego, úsalas en Cloud Monitoring para crear gráficos y políticas de alertas.

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

  • Crea métricas definidas por el usuario para tu proyecto. Puedes contar la cantidad de entradas de registros que coinciden con una consulta determinada o realizar un seguimiento de valores específicos con las entradas de registro coincidentes. Puedes filtrar mediante expresiones regulares.

  • Usa Cloud Monitoring para conservar la cantidad de entradas de registro que contienen mensajes específicos o para extraer información sobre la latencia informada en entradas de registro. Puedes usar estas métricas en gráficos y políticas de alertas.

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 Hosting correspondiente en su totalidad.

  • log_bytes: total de bytes 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 de HTTP, por lo que puedes trazar respuestas HTTP por estado (como ejemplo).

Exporta 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:

  • Con Cloud Monitoring, puedes crear métricas basadas en registros para usarlas en gráficos y políticas de alertas

  • Con BigQuery, puedes hacer lo siguiente:

    • Usar Data Studio para generar paneles de datos de Hosting
    • Ejecutar consultas para obtener más estadísticas sobre las solicitudes (tamaño promedio de respuesta, comparaciones entre los aciertos de caché y los errores, etcétera)
    • Obtener información sobre las URL que tus usuarios realmente solicitan
    • Combinar tus datos de Hosting con otros datos de Firebase que exportaste a BigQuery y consultarlos de formas nuevas