Esta página descreve como você pode monitorar o uso do Cloud Firestore e identificar possíveis problemas no seu aplicativo.
Painel de uso
Use os painéis de uso no Console do Google Cloud Platform e no Console do Firebase para visualizar leituras, gravações e exclusões de documentos ao longo do tempo.
Controle de acesso
Os painéis de uso exigem 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 .
Painel de uso do banco de dados
Para visualizar métricas de uso de um banco de dados do Cloud Firestore, abra a página Uso do banco de dados no Console do GCP.
No console do Google Cloud Platform, acesse a página Bancos de dados .
Selecione o banco de dados necessário na lista de bancos de dados.
No menu de navegação, clique em Uso .
Clique no link da mensagem que aparece na página para visualizar o uso do seu banco de dados.
Painel de uso agregado
Se o seu projeto tiver vários bancos de dados do Cloud Firestore, você poderá visualizar métricas de uso agregadas no Console do GCP ou no Console do Firebase.
Console do GCP
No console do Google Cloud Platform, acesse a página de uso do projeto .
Acesse o uso do projeto do projeto GCP
O painel de uso do projeto mostra as operações do documento ao longo do tempo da seguinte forma:
Console do Firebase
Acesse a página de uso do Cloud Firestore (Firebase console)
Painel de uso e relatórios de faturamento
Os painéis de uso do Cloud Firestore nos consoles do Firebase e do 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 faturação tem precedência sobre o painel de utilização.
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 somente de verificação sem operação. Gravações que apenas verificam a existência ou inexistência de um documento contribuem para operações de leitura cobradas, mas aparecem como `UPDATE_NOOP` e `DELETE_NOOP` respectivamente no painel de uso de gravação.
- Gravações autônomas. Operações que não resultam em alterações 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, podem aparecer no painel de uso como `UPDATE_NOOP` ou `DELETE_NOOP`. Mesmo que apareçam como `NOOP`, eles ainda contribuem para as operações faturadas.
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 só. Ao cobrar o uso, cada gravação ainda é contada separadamente.
O painel de uso também recolhe gravações para transformações de campo, como carimbos de data/hora do servidor, incrementos numéricos e operações de união de array. Para transformações de campo, o painel de uso pode contar diversas operações como uma única operação.
- Consultas que retornam zero resultados. Consultas com zero resultados 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.
O painel de uso para exclusões não captura operações de expiração automática executadas por políticas de tempo de vida (TTL). Consulte as métricas de TTL do Cloud Monitoring .
Uso de regras de segurança
Além disso, o console do Firebase 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 esse painel com análises detalhadas no Cloud Monitoring .
Métricas do Cloud Monitoring
O Cloud Monitoring coleta métricas, eventos e metadados de produtos do Google Cloud. O painel de uso no console do Cloud Firestore relata 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. Esta 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. Esta 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 web ativo mantém uma única conexão, que pode ser compartilhada entre vários listeners de snapshot. As bibliotecas cliente do servidor criam uma conexão por listener de captura instantânea. |
| Ouvintes de instantâneo | O número de ouvintes de instantâneos em todas as conexões ativas. |
| Contagem de exclusão de tempo de vida | Contagem total de documentos excluídos por políticas de tempo de vida (TTL) . |
| Expiração do tempo de vida para atrasos na exclusão | Tempo decorrido entre o momento em que um documento expirou sob uma política de tempo de vida (TTL) e o momento em que foi realmente excluído. |
- Uso de atualizações em tempo real
Use as métricas de conexões ativas e ouvintes de snapshots para medir o uso de atualizações em tempo real .
Digamos que um usuário abra seu aplicativo no telefone. O aplicativo então se conecta ao Cloud Firestore e assina 10 consultas. Isso aumenta suas métricas em 1 conexão ativa e 10 ouvintes de snapshot.
- Taxa de amostragem
As métricas do Cloud Firestore são amostradas a cada minuto, mas as atualizações podem levar até quatro minutos para aparecer nos seus painéis.
Métricas de latência
As métricas de latência de back-end estão disponíveis por meio de métricas comuns do Firestore do Google Cloud.
Por exemplo, um gráfico de latência p50 pode ser encontrado na visualização do explorador de métricas do Console do Cloud.
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
- Saiba mais sobre o monitoramento em nuvem.
- Conheça as práticas recomendadas para monitorar o desempenho do Firestore .