É 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.
Entender melhor seu site: saiba de onde e quando seu site recebe acessos, os status das respostas do site, a latência das solicitações de usuário final e muito mais.
Filtrar seus registros com consultas: aproveite os dados coletados automaticamente para filtrar e traçar dados associados a cada solicitação ou site.
Usar métricas com base 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.
Exportar registros para outras ferramentas do Google Cloud: use dados de registros em outras ferramentas, como o BigQuery e o Data Studio, para ter uma análise e uma correlação mais eficientes.
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.
Vincular ao Cloud Logging e monitorar o uso de dados
Vincular ao Cloud Logging e exportar registros de solicitação da Web
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.
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:
No card 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).
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 porCritical,ErrorouWarning.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 valorlatencycapturado em cada registro.Seu site está aproveitando o armazenamento de conteúdo em cache?
Cada registro contém um campocacheHitpara 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 siteresponse_count: contagem total de respostas escritas para o siteEssa 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.