Catch up on everthing we announced at this year's Firebase Summit. Learn more

Visualize, pesquise e filtre os registros de solicitação da web do seu site com o Cloud Logging

Você pode vincular seu projeto Firebase ao Cloud Logging para visualizar, pesquisar e filtrar seus registros de solicitação da web para cada um dos seus sites de hospedagem. Esses registros são do CDN que é 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ê faz com os registros do Cloud Logging. Visite cada seção desta página para aprender os detalhes.

Se você tiver vários sites de hospedagem em seu projeto, poderá selecionar qual de seus sites de hospedagem exportará os logs. Você pode filtrar e visualizar seus dados de registros 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 Logging nuvem no console Firebase.

    Para vincular ou desvincular Logging nuvem, você precisa as permissões empacotados em qualquer uma das seguintes funções: projeto proprietário ou editor ou Firebase Desenvolver administração .

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

    Se você já tem um ou mais sites de hospedagem ativos, o fluxo de trabalho de vinculação exibe um nível de uso de dados estimado para logs de cada um de seus sites de hospedagem. Este valor é estimado nos últimos 30 dias.

Após ligando para Logging Nuvem, registros para quaisquer novos pedidos para seus sites de hospedagem irá geralmente aparecem dentro de 30 minutos de apresentação do pedido.

Você também pode unlink Firebase Alojamento de Logging Nuvem, que pára as exportações de pedido web logs para Logging Cloud.

Monitore o uso de dados para registros

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

Compreenda melhor o seu site

A interface de Logs Visualizador nas ferramentas ofertas Google Cloud Console para ver seus registros e dados usando consultas e específicos built-in filtros 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 estão visitando 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, bem como revelar quaisquer picos inesperados no tráfego.

  • Qual é a distribuição de status para solicitações do usuário final?
    Você pode visualizar o status de cada solicitação e até mesmo diagnosticar as solicitações que recebem erros. Você pode filtrar os registros pela Critical , Error ou Warning .

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

  • O seu site está aproveitando o cache de conteúdo?
    Cada log contém uma cacheHit campo para dizer-lhe se de recursos do seu site foi servido rapidamente do cache CDN de hospedagem, ou se tivesse que fazer a viagem completa para o servidor de hospedagem. 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 afinar os hábitos de 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 rastrear qual domínio é visitado com mais frequência.

Filtre seus registros com consultas

Para saber mais sobre como filtrar seus registros com consultas, visite consultas amostra usando Logs Visualizador e consultas de log de construção . A tabela a seguir descreve os campos disponíveis para essas consultas.

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

  • Resource ( resource.type ) - firebase_domain (Firebase hospedagem de domínio Site)
  • Nome do Log ( logName ) - webrequests (Firebase hospedagem)

Cada entrada de log tem uma estrutura pré-definida e campos Queryable (ver LogEntry ). Para 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
Firebase Hospedando armazena os seguintes campos na httpRequest objeto da entrada de log.
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 do pedido, em segundo com s sufixo (por exemplo, 1.256s )
protocol O protocolo utilizado para o pedido (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 no momento foi seguido (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 de HTTP (por exemplo, 200 ou 404 )
userAgent O cabeçalho user-Agent da solicitação
Firebase hosting lojas campos adicionais no jsonPayload objeto da entrada de log.
acceptEncoding (a partir da solicitação HTTP) Qual codificação, geralmente um algoritmo de compressão, os suportes do cliente (por exemplo, conteúdo 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 contra 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 ver e construir métricas baseadas em registros , em seguida, usar essas métricas em nuvem Monitoramento para criar gráficos e políticas alerta.

  • Alavancagem predefinido métricas do sistema que são automaticamente gravadas, tais como o número de eventos de registro que ocorreram dentro de um período de tempo específico.

  • Criar métricas definidas pelo utilizador 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 Nuvem de monitoramento para registrar o número de entradas de log que contêm mensagens particulares ou informações extrato de latência relatados nas entradas do registro. Você pode então 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 registro, mas sim para o site de hospedagem específico como um todo.

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

  • response_count : contagem total de respostas por escrito para o site

    Essa métrica inclui o campo de status HTTP, para que você possa traçar as respostas HTTP por status (por 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 Cloud Monitoring , você pode criar métricas baseadas em log que você pode usar em gráficos e políticas alerta.

  • Usando BigQuery , você pode fazer qualquer um dos seguintes:

    • 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 vs 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.