Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Monitorar a atividade do Cloud Firestore

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página descreve como você pode monitorar o uso do Cloud Firestore e detectar possíveis problemas em seu aplicativo. Observar o uso do seu aplicativo também pode lhe dar uma ideia do que esperar em sua fatura. Além disso, se algo parecer errado, obter uma visão clara das operações do seu banco de dados pode ser uma ferramenta útil para a solução de problemas.

Painel de uso

O console do Google Cloud Platform e o console do Firebase incluem um painel de uso do Cloud Firestore que mostra leituras, gravações e exclusões de documentos ao longo do tempo.

Console do GCP

Acesse a página de uso do Cloud Firestore (console do GCP)

O painel de uso do Cloud Firestore no Console do GCP.

Controle de acesso

O painel de uso requer a permissão monitoring.timeSeries.list do Cloud IAM. As funções de proprietário, editor e visualizador do projeto concedem essa permissão. Você também pode conceder essa permissão por meio de uma função do Cloud Monitoring ou de uma função personalizada .

Console do Firebase

Acesse a página de uso do Cloud Firestore (console do Firebase)

O painel de uso do Cloud Firestore no console do Firebase.

Painel de uso e relatórios de cobrança

Os painéis de uso do Cloud Firestore nos consoles Firebase e Cloud fornecem uma estimativa de uso. Eles podem ajudá-lo a identificar picos de uso. No entanto, o painel não é uma visão exata das operações faturadas. O uso faturado é provavelmente maior. Em todos os casos de discrepância, o relatório de cobrança tem precedência sobre o painel de uso.

As operações que causam discrepâncias entre o painel de uso e o uso faturado incluem:

  • Operações de importação e exportação. As leituras e gravações realizadas por essas operações não aparecem no painel de uso.
  • Gravações sem operação. As operações que não resultam em uma alteração no banco de dados, como uma atualização que não altera os valores dos campos ou uma gravação em um documento excluído, contribuem para as operações faturadas. No entanto, o painel de uso não conta essas operações.
  • Gravações recolhidas. Em casos com várias gravações no mesmo documento em rápida sucessão, o painel de uso pode recolher várias gravações e contá-las como uma. Ao faturar o uso, cada gravação ainda é contada separadamente.

    O painel de uso também reduz gravações para transformações de campo, como carimbos de data/hora do servidor, incrementos numéricos e operações de união de matriz. Para transformações de campo, o painel de uso pode contar várias operações como uma única operação.

  • Consultas que retornam resultados zero. Consultas com resultados zero incorrem no custo de uma operação de leitura. Esse uso é cobrado, mas não aparece no painel de uso.
  • Operações de leitura associadas a consultas de agregação, como COUNT. Esse uso é cobrado, mas não aparece no painel de uso.

Uso da regra de segurança

Além disso, o Firebase console fornece um painel de avaliação de regras de segurança, uma visão útil e rápida das invocações de regras. Você pode complementar este painel com análises detalhadas no Cloud Monitoring .

Ir para a página Regras

Painel de monitoramento de regras do Cloud Firestore no console do Firebase.

Cotas diárias

Ao criar um projeto do Firebase, você também está criando um projeto no Google Cloud. A página Cotas do App Engine no Console do GCP rastreia informações diárias de uso do Cloud Firestore, incluindo leituras, gravações, gravações de índice, exclusões, dados armazenados e saída de rede.

Vá para a página de cotas

Uso do Cloud Firestore na página Cotas do App Engine.

Monitoramento de Nuvem

O Cloud Monitoring coleta métricas, eventos e metadados dos produtos do Google Cloud. O painel de uso no console do Cloud Firestore informa os mesmos dados de métricas. Para configurar painéis personalizados e alertas de uso, use o Cloud Monitoring.

O Cloud Monitoring inclui as seguintes métricas do Cloud Firestore:

Nome da métrica Descrição
leituras de documentos

O número de leituras de documentos bem-sucedidas. Você pode dividir essa métrica pelo tipo de leitura: LOOKUP ou QUERY.

Essa métrica não inclui leituras de operações de exportação gerenciadas.

Gravações de Documentos

O número de gravações de documentos bem-sucedidas. Você pode dividir a métrica pelo tipo de gravação: CREATE ou UPDATE.

Essa métrica não inclui gravações de operações de importação gerenciadas.

exclusões de documentos O número de exclusões de documentos bem-sucedidas.
Conexões ativas

O número de conexões ativas com seu banco de dados.

Cada SDK móvel e da Web ativo mantém uma única conexão, que pode ser compartilhada entre vários ouvintes de instantâneos. As bibliotecas de cliente do servidor criam uma conexão por ouvinte de captura instantânea.

Ouvintes instantâneos

O número de ouvintes de captura instantânea em todas as conexões ativas.

Contagem de exclusão de tempo de vida

Contagem total de documentos excluídos por políticas de vida útil (TTL) .

Expiração do tempo de vida para atrasos de exclusão

O tempo decorrido entre o momento em que um documento expirou sob uma política de vida útil (TTL) e o momento em que foi realmente excluído.

Uso de atualizações em tempo real

Use as conexões ativas e métricas de ouvintes instantâneos para medir seu uso de atualizações em tempo real .

Digamos que um usuário abra seu aplicativo em seu telefone. O aplicativo se conecta ao Cloud Firestore e se inscreve em 10 consultas. Isso aumenta suas métricas em 1 conexão ativa e 10 ouvintes instantâneos.

Taxa de amostragem

As métricas do Cloud Firestore são amostradas a cada minuto, mas as atualizações podem levar até 4 minutos para aparecer em seus painéis.

Configurar um painel do Cloud Monitoring

Para configurar um painel com métricas do Cloud Firestore, consulte Gerenciar painel personalizado e Adicionar widgets de painel .

Qual é o próximo