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.
Entenda melhor seu site — Saiba de onde e quando você visita seu site, os status de resposta do site, a latência das solicitações do usuário final e muito mais.
Filtre seus logs com consultas — Aproveite os dados coletados automaticamente para filtrar e plotar dados associados a cada solicitação ou ao seu site.
Use métricas baseadas em registros — crie gráficos do Cloud Monitoring e políticas de alertas a partir de métricas predefinidas do sistema ou métricas definidas pelo usuário.
Exporte registros para outras ferramentas do Google Cloud — use dados de registros em outras ferramentas (como BigQuery e Data Studio) para uma análise e correlação mais eficientes.
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.
O Cloud Logging é gratuito para até 50 GB de uso de dados por mês (por projeto). Esse uso pode ser de qualquer produto do Google ou Firebase usando o Cloud Logging. Você pode atualizar seu projeto para o plano de preços Blaze para desbloquear o uso pago adicional. Saiba mais sobre os preços do Cloud Logging .
Você pode monitorar e gerenciar o Cloud Logging e o faturamento:
Estime suas contas do Cloud Logging usando a calculadora de preços do Google Cloud .
Limite os logs criando exclusões .
Configure alertas para ajudar a controlar os custos.
Observe que a entrada de log para uma solicitação específica pode ser atrasada ou, em casos raros, descartada. Embora os logs possam ser usados para entender as solicitações, eles podem não refletir o uso real que aparece no uso e no faturamento do seu projeto.
Vincule ao Cloud Logging e monitore seu uso de dados
Vincular ao Cloud Logging e exportar registros de solicitações da Web
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 .
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:
No cartão de integração do Cloud Logging no console do Firebase
Na interface do Visualizador de registros no Console do Google Cloud (a métrica
log_bytes
)
O Cloud Logging é gratuito para até 50 GB de uso de dados por mês (por projeto). Esse uso pode ser de qualquer produto do Google ou Firebase usando o Cloud Logging. Você pode atualizar seu projeto para o plano de preços Blaze para desbloquear o uso pago adicional. Saiba mais sobre os preços do Cloud Logging .
Você pode monitorar e gerenciar o Cloud Logging e o faturamento:
Estime suas contas do Cloud Logging usando a calculadora de preços do Google Cloud .
Limite os logs criando exclusões .
Configure alertas para ajudar a controlar os custos.
Observe que a entrada de log para uma solicitação específica pode ser atrasada ou, em casos raros, descartada. Embora os logs possam ser usados para entender as solicitações, eles podem não refletir o uso real que aparece no uso e no faturamento do seu projeto.
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 porCritical
,Error
ouWarning
.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 delatency
capturado em cada log.Seu site está aproveitando o cache de conteúdo?
Cada log contém um campocacheHit
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 siteresponse_count
: contagem total de respostas escritas para o siteEssa 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.