Visualize, pesquise e filtre os registros de solicitações da Web do seu site com o Cloud Logging

Você pode vincular seu projeto do Firebase ao Cloud Logging para visualizar, pesquisar e filtrar seus registros de solicitações da Web para cada um dos seus sites do Hosting. Esses registros são da CDN fornecida automaticamente pelo Firebase, portanto, todas as solicitações ao seu site e os dados de solicitações associados são registrados.

Veja algumas coisas que você faz com os registros do Cloud Logging. Visite cada seção desta página para saber detalhes.

Se você tiver vários sites do Hosting em seu projeto, poderá selecionar quais dos seus sites do Hosting exportarão os logs. Você pode filtrar e visualizar seus dados de logs por site de hospedagem e até mesmo por domínio. Ao selecionar sites de Hosting específicos para exportar logs, você também pode controlar a quantidade de dados processados ​​para seu projeto.

  1. Clique em Link no cartão de integração do Cloud Logging no console do Firebase.

    Para vincular ou desvincular o Cloud Logging, você precisa das permissões agrupadas em qualquer um dos seguintes papéis: proprietário ou editor do projeto ou administrador de desenvolvimento do Firebase .

  2. Siga as instruções na tela para selecionar quais dos seus sites de hospedagem devem exportar logs para o Cloud Logging.

    Se você já tiver um ou mais sites do Hosting ativos, o fluxo de trabalho de vinculação exibirá um nível de uso de dados estimado para os logs de cada um dos seus sites do Hosting. Este valor é estimado a partir dos últimos 30 dias.

Depois de vincular ao Cloud Logging, os logs de quaisquer novas solicitações para seus sites de hospedagem geralmente serão exibidos dentro de 30 minutos após a solicitação ser feita.

Você também pode desvincular o Firebase Hosting do Cloud Logging, o que interrompe as exportações de registros de solicitações da Web para o Cloud Logging.

Monitore seu uso de dados para logs

Depois de vincular ao Cloud Logging, você pode visualizar o nível de uso de dados dos logs dos seus sites do Hosting:

Entenda melhor seu site

A interface do Visualizador de registros no Console do Google Cloud oferece ferramentas para visualizar seus registros e dados específicos usando consultas e filtros e painéis de dados integrados. Saiba mais sobre como filtrar seus registros com consultas na próxima seção abaixo.

  • De onde vem o tráfego do seu site em um nível granular?
    Você pode visualizar informações sobre cada solicitação, incluindo IP de origem, referenciador, cidade e status.

  • Quando os usuários visitam seu site?
    Você pode usar o painel Histograma para ver a distribuição por intervalos de tempo específicos. Isso pode fornecer informações sobre os picos e quedas normais do uso do seu aplicativo, bem como revelar quaisquer picos inesperados no tráfego.

  • Qual é a distribuição de status para solicitações de usuários finais?
    Você pode visualizar o status de cada solicitação e até diagnosticar solicitações que recebem erros. Você pode filtrar seus logs por Critical , Error ou Warning .

  • Quanto tempo seu site leva para responder a uma solicitação?
    Você pode visualizar a latência do seu site para cada solicitação usando o valor de latency capturado em cada log.

  • Seu site está aproveitando o cache de conteúdo?
    Cada log contém um campo cacheHit para informar se o recurso do seu site foi servido rapidamente a partir do cache CDN do Hosting ou se ele teve que fazer a viagem completa até o back-end do Hosting. Isso pode ajudar você a melhorar o desempenho do seu site aproveitando ao máximo a CDN global do Firebase. Por exemplo, você pode usar os dados para ajustar os hábitos de armazenamento em cache de seus ativos estáticos e conteúdo dinâmico .

  • Qual é a distribuição de tráfego para seus vários domínios?
    Se você tiver vários domínios ou sites de hospedagem, poderá filtrar seus logs por domínio ou por site. Isso permite que você veja como seu tráfego é distribuído. Ao filtrar por domínio, você pode acompanhar qual domínio é visitado com mais frequência.

Filtre seus registros com consultas

Para saber como filtrar seus logs com consultas, visite Consultas de exemplo usando o Visualizador de logs e Criando consultas de log . A tabela abaixo descreve os campos disponíveis para essas consultas.

Para Hospedagem, aqui estão alguns filtros iniciais para uma consulta:

  • Recurso ( resource.type ) — firebase_domain (domínio do site de hospedagem do Firebase)
  • Nome do log ( logName ) — webrequests (Firebase Hosting)

Cada entrada de log tem uma estrutura predefinida e campos que podem ser consultados (consulte LogEntry ). Para o Hosting, alguns campos são padrão para uma solicitação HTTP, mas existem outros valores de campo que vêm do processamento que o Hosting executa em cada solicitação.

Campo Descrição
O Firebase Hosting armazena os campos a seguir no objeto httpRequest da entrada de registro.
Esses campos são definidos na especificação HTTP.
cacheHit Se o Hosting CDN tinha ou não o recurso da resposta em cache
latency A duração da solicitação, em segundos com s postfix (por exemplo, 1.256s )
protocol O protocolo usado para a solicitação (por exemplo, HTTP/1.1 , HTTP/2 , websocket )
referer O endereço da página da web anterior a partir da qual foi seguido um link para a página atualmente solicitada (se houver)
remoteIp O IP do cliente de origem para a solicitação
requestMethod O método de solicitação ( GET , POST , PUT , etc.)
requestSize O tamanho da solicitação em bytes
requestUrl O URL completo da solicitação (por exemplo,
https://foo.web.app/bar ou https://custom.domain.com?query=param )
responseSize O tamanho da resposta HTTP em bytes
serverIp não povoado
status O status da resposta HTTP (por exemplo, 200 ou 404 )
userAgent O cabeçalho do agente do usuário da solicitação
O Firebase Hosting armazena campos adicionais no objeto jsonPayload da entrada de registro.
acceptEncoding (da solicitação HTTP) Qual codificação de conteúdo, geralmente um algoritmo de compactação, o cliente suporta (por exemplo, gzip ou compress )
billable Se seu projeto foi ou não cobrado pela solicitação
customDomain Se a solicitação foi feita ou não em um domínio personalizado
hostname O nome do host em que a solicitação foi feita
remoteIpCountry O país de origem do pedido
remoteIpCity A cidade de origem do pedido

Use métricas baseadas em registros

Você pode visualizar e criar métricas com base em registros e usar essas métricas no Cloud Monitoring para criar gráficos e políticas de alertas.

  • Aproveite as métricas de sistema predefinidas que são registradas automaticamente, como o número de eventos de log que ocorreram em um período de tempo específico.

  • Crie métricas definidas pelo usuário para seu projeto. Você pode contar o número de entradas de log que correspondem a uma determinada consulta ou acompanhar valores específicos com as entradas de log correspondentes. Você pode filtrar usando expressões regulares.

  • Use o Cloud Monitoring para registrar o número de entradas de registro que contêm mensagens específicas ou extrair informações de latência relatadas nas entradas de registro. Você pode usar essas métricas em gráficos e políticas de alerta.

O Firebase Hosting também gera as seguintes métricas de registro específicas do Hosting. Essas métricas não são específicas para uma entrada de log, mas sim para o site específico do Hosting como um todo.

  • log_bytes : Total de bytes de uso de dados para cada site

  • response_count : contagem total de respostas escritas para o site

    Essa métrica inclui o campo de status HTTP, para que você possa plotar as respostas HTTP por status (como exemplo).

Exportar registros para outras ferramentas do Google Cloud

Você também pode exportar os registros do seu site para outras ferramentas do Google Cloud, como Cloud Monitoring ou BigQuery, por exemplo:

  • Usando o Cloud Monitoring , você pode criar métricas baseadas em registros que podem ser usadas em gráficos e políticas de alertas.

  • Com o BigQuery , você pode fazer o seguinte:

    • Use o Data Studio para gerar painéis de seus dados de hospedagem.
    • Execute consultas para obter mais informações sobre suas solicitações (tamanho médio de resposta, acertos de cache versus erros, etc.).
    • Saiba quais URLs seus usuários realmente solicitam.
    • Combine seus dados do Hosting com outros dados do Firebase que você exportou para o BigQuery e consulte-os de novas maneiras.