Acessar, pesquisar e filtrar os registros de solicitações da Web do seu site com o Cloud Logging

É possível vincular seu projeto do Firebase ao Cloud Logging para ver, pesquisar e filtrar os registros de solicitações da Web para cada um dos sites do Hosting. Esses registros são provenientes do CDN fornecido automaticamente pelo Firebase. Assim, todas as solicitações ao seu site e os dados da solicitação associados são registrados.

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

Se você tiver vários sites do Hosting no seu projeto, selecione qual dos sites do Hosting exportará registros. Em seguida, você pode filtrar e visualizar seus dados de registros por site do Hosting e até mesmo por domínio. Ao selecionar sites específicos do Hosting para exportar registros, você também pode controlar a quantidade de dados processados para seu projeto.

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

    Para vincular ou desvincular o Cloud Logging, você precisa das permissões incluídas em 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 sites do Hosting exportarão 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. Esse valor é estimado com base nos últimos 30 dias.

Depois de vincular ao Cloud Logging, os registros de qualquer nova solicitação aos sites do Hosting geralmente aparecem até 30 minutos após a solicitação.

Também é possível desvincular o Firebase Hosting do Cloud Logging, o que interrompe as exportações de registros de solicitação da Web para o Cloud Logging.

Monitorar o uso de dados para gerar registros

Depois de vincular ao Cloud Logging, é possível visualizar o nível de uso de dados para registros dos seus sites do Hosting:

Entender 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, filtros e painéis de dados integrados. Saiba mais sobre como filtrar seus registros com consultas na próxima seção.

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

  • Quando os usuários acessam seu site?
    É possível usar o painel Histograma para ver a distribuição por períodos específicos. Isso pode fornecer insights sobre os picos e quedas normais do uso do seu app, bem como revelar picos inesperados no tráfego.

  • Qual é a distribuição de status para solicitações de usuários finais?
    É possível ver o status de cada solicitação e até diagnosticar solicitações que recebem erros. É possível filtrar os registros por Critical, Error ou Warning.

  • Quanto tempo leva para que seu site responda a uma solicitação?
    É possível ver a latência do seu site para cada solicitação usando o valor latency capturado em cada registro.

  • Seu site está aproveitando o armazenamento de conteúdo em cache?
    Cada registro contém um campo cacheHit para informar se o recurso do seu site foi veiculado rapidamente do cache da CDN do Hosting ou se foi necessário fazer a viagem completa para 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, é possível usar os dados para ajustar os hábitos de armazenamento em cache dos seus recursos estáticos e do 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 por site. Isso permite que você veja como seu tráfego é distribuído. Ao filtrar por domínio, você pode ver qual domínio é acessado com mais frequência.

Filtrar seus registros com consultas

Para saber como filtrar seus registros com consultas, acesse Amostra de consultas usando o visualizador de registros e Como criar consultas de registros. A tabela abaixo descreve os campos disponíveis para essas consultas.

Para o Hosting, veja alguns filtros iniciais para uma consulta:

  • Recurso (resource.type) - firebase_domain (domínio do site do Firebase Hosting)
  • Nome do registro (logName) - webrequests (Firebase Hosting)

Cada entrada de registro 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 há outros valores de campo provenientes 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 a CDN do Hosting tinha ou não o recurso da resposta em cache
latency A duração da solicitação, em segundos, com o postfix s (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 um link para a página solicitada foi seguido (se houver)
remoteIp O IP do cliente que originou 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 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 outros campos no objeto jsonPayload da entrada de registro.
acceptEncoding (da solicitação HTTP) Qual codificação de conteúdo, normalmente um algoritmo de compactação, o cliente aceita (por exemplo, gzip ou compress)
billable Se o projeto foi faturado pela solicitação ou não.
customDomain Se a solicitação foi feita em um domínio personalizado
hostname O nome do host para que a solicitação foi feita
remoteIpCountry O país de origem da solicitação
remoteIpCity A cidade de origem da solicitação

Usar métricas com base em registros

É possível visualizar e criar métricas com base em registros e usá-las no Cloud Monitoring para criar gráficos e políticas de alertas.

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

  • Crie métricas definidas pelo usuário para o projeto. Você pode contar o número de entradas de registro que correspondem a uma determinada consulta ou acompanhar valores específicos com as entradas de registro 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 alertas.

O Firebase Hosting também gera as seguintes métricas de geração de registros específicas do Hosting. Essas métricas não são específicas a uma entrada de registro, mas ao site do Hosting 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 e é possível mostrar respostas HTTP por status (como exemplo).

Exportar registros para outras ferramentas do Google Cloud

Também é possível exportar os registros do seu site para outras ferramentas do Google Cloud, como o Cloud Monitoring ou o BigQuery, por exemplo:

  • Com o Cloud Monitoring, é possível criar métricas com base em registros que podem ser usadas em gráficos e políticas de alertas.

  • Com o BigQuery, é possível realizar qualquer um dos seguintes procedimentos:

    • Usar o Data Studio para gerar painéis dos seus dados do Hosting.
    • Executar consultas para receber mais insights sobre suas solicitações (tamanho médio da resposta, ocorrências em cache x erros etc.).
    • Saber quais URLs seus usuários realmente solicitam.
    • Combinar seus dados do Hosting com outros dados do Firebase que você exportou para o BigQuery e consultá-los de novas maneiras.