Usar o painel do Cloud Monitoring
Nesta página, descrevemos como usar um painel do Cloud Monitoring para conferir as métricas disponíveis, criar um painel personalizado e definir alertas.
Conferir métricas do Firestore
Para conferir as diferentes métricas do Firestore e criar gráficos, use uma das seguintes opções:
A página Monitoring na seção do Firestore do console Google Cloud . Esta página inclui um painel de monitoramento predefinido. Também é possível criar até um painel personalizado. Para acessar a página Monitoring de um banco de dados, siga estas etapas:
No console do Google Cloud , abra a página Bancos de dados do Firestore.
Selecione um banco de dados na lista.
No menu de navegação, clique em Monitoring para abrir um painel.
O Metrics Explorer no Cloud Monitoring no console Google Cloud . Para mais informações sobre como criar gráficos, consulte Criar gráficos com o Metrics Explorer.
Ver o painel do Cloud Monitoring
No Cloud Monitoring, os painéis personalizados permitem mostrar informações relevantes para você de maneira organizada. Por exemplo, é possível criar um painel para mostrar as métricas de desempenho e as políticas de alertas do projeto no ambiente de produção.
Para mais informações sobre como configurar um painel personalizado, consulte Gerenciar painel personalizado e Adicionar widgets do painel.
Monitorar taxas de erro
É possível criar um painel de monitoramento para acompanhar as taxas de erros e garantir a disponibilidade do banco de dados. A disponibilidade se refere à taxa em que seu banco de dados responde dentro de um período esperado com um código de status bem-sucedido. O SLA do Firestore define os detalhes específicos do que é classificado como uma solicitação válida.
A taxa de erros é determinada dividindo o número de solicitações que resultaram em uma resposta de erro pelo número total de solicitações enviadas.
Um exemplo de painel para calcular taxas de erro pode ser criado calculando a proporção A/B de api/request_count
de solicitações válidas com códigos de erro 4xx
ou 5xx
em contraste com o api/request_count
de todas as solicitações válidas.

Na figura 1, você pode ver como visualizar a proporção da taxa de erros usando as métricas api/request_count no Metrics Explorer.
Crie uma política de alertas
Com o Cloud Monitoring, é possível criar alertas para receber notificações quando houver uma mudança em uma condição de métrica. Use esses alertas para receber notificações sobre possíveis problemas antes que eles afetem os usuários.
Para mais informações sobre como criar alertas, consulte Criar políticas de alertas de limite de métrica.
Considere o exemplo a seguir, em que criamos uma política de alertas de latência. A política de alertas verifica a latência p99 em uma janela contínua de cinco minutos. Se a latência p99 permanecer acima de 250 ms por 5 minutos, o alerta será acionado.
Console
No console Google Cloud , acesse a página Monitoring e selecione notifications Alertas.
Selecione Criar política.
Selecione a métrica Latências de solicitação no recurso API utilizada.
Adicione um filtro de serviço para
firestore.googleapis.com
em bancos de dados nativos do Firestore.Clique em Próxima para configurar o gatilho.
Selecione Tipos de condição como Limite.
Uma condição de limite é definida como um valor de 250 ms. Um alerta é acionado quando o valor de latência p99 permanece o mesmo durante todo o período da janela contínua (5 minutos).
Defina o Valor do limite como 250.
Clique em Próxima para configurar as notificações.
Defina o nome da política de alertas e clique em Próxima.
Revise as configurações de alerta e clique em Criar política.
MQL
É possível implementar a mesma política de alerta de latência usando uma consulta da linguagem de consulta do Monitoring (MQL). Para mais exemplos de uso do MQL, consulte Exemplos de consultas MQL.
fetch consumed_api
| metric 'serviceruntime.googleapis.com/api/request_latencies'
| filter (resource.service == 'firestore.googleapis.com')
| group_by 5m,
[value_request_latencies_percentile:
percentile(value.request_latencies, 99)]
| every 5m
| condition val() > 0.25 's'