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 os registros de solicitações da Web para cada um dos seus sites de hospedagem. Esses registros são do CDN fornecido automaticamente pelo Firebase, portanto, todas as solicitações ao seu site e os dados de solicitação associados são registrados.

Aqui estão algumas coisas que você pode fazer com os registros do Cloud Logging. Visite cada seção desta página para saber mais detalhes.

Se você tiver vários sites de hospedagem em seu projeto, poderá selecionar qual dos sites de hospedagem exportará os registros. Você pode então filtrar e visualizar seus dados de log por site de hospedagem e até mesmo por domínio. Ao selecionar sites de hospedagem específicos para exportar logs, você também pode controlar a quantidade de dados processados ​​para o 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 uma das seguintes funções: proprietário ou editor do projeto ou administrador do Firebase Develop .

  2. Siga as instruções na tela para selecionar quais dos seus sites de hospedagem devem exportar registros 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 estimado de uso de dados para registros de cada um dos seus sites do Hosting. Este valor é estimado a partir dos últimos 30 dias.

Depois de vincular ao Cloud Logging, os registros de quaisquer novas solicitações aos seus sites de hospedagem geralmente aparecerão 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 o uso de dados para registros

Depois de vincular ao Cloud Logging, você poderá visualizar o nível de uso de dados dos registros dos seus sites de hospedagem:

Entenda melhor o seu site

A interface do Visualizador de registros no console do Google Cloud oferece ferramentas para visualizar registros e dados específicos usando consultas, filtros integrados e painéis de dados. 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 de uso do seu aplicativo, além de revelar quaisquer picos inesperados no tráfego.

  • Qual é a distribuição de status das solicitações do usuário final?
    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 latency capturado em cada log.

  • O 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 teve que fazer a viagem completa até o back-end do Hosting. Isso pode ajudá-lo a melhorar o desempenho do seu site aproveitando ao máximo o 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 do tráfego para seus vários domínios?
    Se você tiver vários domínios ou sites de hospedagem, poderá filtrar seus registros por domínio ou site. Isso permite que você veja como seu tráfego é distribuído. Ao filtrar por domínio, você pode rastrear 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 do Firebase Hosting)
  • Nome do log ( logName ) — webrequests (Firebase Hosting)

Cada entrada de log possui uma estrutura predefinida e campos consultáveis ​​(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 seguintes campos 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 web anterior a partir da qual foi seguido um link para a página atualmente solicitada (se presente)
remoteIp O IP do cliente de origem da 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 preenchido
status O status da resposta HTTP (por exemplo, 200 ou 404 )
userAgent O cabeçalho user-Agent 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 o 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 para o qual a solicitação foi feita
remoteIpCountry O país de origem da solicitação
remoteIpCity A cidade de origem da solicitação

Use métricas baseadas em registros

Você pode visualizar e criar métricas baseadas em registros e usá-las no Cloud Monitoring para criar gráficos e políticas de alertas.

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

  • Crie métricas definidas pelo usuário para o 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 em entradas de registro. Você pode então usar essas métricas em gráficos e políticas de alertas.

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 de uma entrada de log, mas sim do site de hospedagem específico 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 traçar 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.

  • Usando 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 da resposta, acertos versus erros do cache, etc.).
    • Saiba quais URLs seus usuários realmente solicitam.
    • Combine seus dados do Hosting com outros dados do Firebase exportados para o BigQuery e consulte-os de novas maneiras.