Esta página descreve como usar os insights de uso para analisar o uso faturável de bancos de dados específicos. É possível detalhar esses dados por dimensões, como coleções, grupos de coleções ou namespaces (específicos do modo Datastore) em um período personalizado. As métricas de insights de uso mostradas variam de acordo com a edição ou o modo:
| Edição | Métricas |
| Padrão |
|
| Enterprise |
|
Visão geral dos insights de uso
Use o painel de insights de uso para monitorar o uso de bancos de dados específicos. Esse painel ajuda você a:
- Monitorar o uso granular: acompanhe as operações faturáveis detalhadas por
dimensões, como
collection,collectionGroup, ounamespace. - Otimizar custos: identifique o uso com faturamento alto para determinar onde é possível otimizar estruturas de dados ou consultas e reduzir a fatura geral.
- Acompanhar tendências históricas: monitore como as estatísticas de uso faturável mudam em períodos específicos.
Funções exigidas
Para receber a permissão necessária para acessar o painel de insights de uso, peça ao administrador para conceder a você o papel Leitor do Datastore
(roles/datastore.viewer) do IAM no seu projeto.
Esse papel predefinido contém a permissão datastore.insights.get, que é necessária para acessar o painel de insights de uso.
Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.
Painel de insights de uso
O painel de insights de uso está organizado em duas seções principais:
- Uso total:mostra métricas agregadas (leituras, gravações, exclusões TTL) para todo o banco de dados.
- Uso por GroupBy:mostra métricas detalhadas pelas 100 principais dimensões e é agrupado por coleção, grupo de coleções ou namespaces.
Métricas de uso total e GroupBy
É importante observar que a soma das métricas na seção GroupBy pode não corresponder à métrica mostrada na seção Uso total. Essa variação é esperada devido aos seguintes fatores:
- Limites de GroupBy (100 principais) : a seção GroupBy é restrita à detalhamento do uso apenas para as 100 principais coleções, grupos de coleções ou namespaces. O uso gerado por dimensões menos ativas contribui para o valor de uso total, mas não é listado individualmente nas métricas de uso de GroupBy.
- Amostragem para operações amplas:para solicitações que afetam um grande número de coleções (por exemplo, junções em várias coleções,
ListCollectionIds,ListDocuments, consultas sem tipo), os insights de uso podem amostrar coleções, priorizando aquelas com maior uso. Como resultado, nem todas as coleções afetadas são incluídas nas métricas de uso de GroupBy. Nomes reservados:o modo Datastore reserva nomes com prefixo de sublinhados duplos (__*__) para metadados internos. O uso relacionado a esses nomes reservados contribui para o uso total, mas não é incluído nas métricas de uso de GroupBy.
Entidades de estatísticas do modo Datastore:as entidades de estatísticas usadas no modo Datastore são incluídas no uso total, mas não contribuem para as métricas de uso de GroupBy.
Dimensões de GroupBy
A seção GroupBy organiza as métricas de uso com base nas dimensões determinadas pelas APIs ativadas:
- Namespace: disponível quando a API Datastore está ativada.
- Tipo: geralmente disponível em todas as configurações de API.
Dados de insights de uso
Os insights de uso no Google Cloud console mostram dados originados dos seguintes métodos de API:
queryTopAggregatedInsightsDataqueryTopTimeseriesInsightsData
| Nome do campo | Detalhes |
| Nome da coleção Nome do grupo de coleções Valor do namespace |
O valor correspondente à dimensão de uso para a qual os dados de uso são agregados. Pode ser um nome de coleção, um nome de grupo de coleções ou um nome de namespace. |
| Total de operações de leitura | Número total de operações de leitura. Aplicável apenas à edição Standard. |
| Total de operações de gravação | Número total de operações de gravação. Inclui operações de exclusão também. Aplicável apenas à edição Standard. |
| Total de operações de exclusão de TTL | Número total de operações de exclusão de TTL. Aplicável apenas à edição Standard. |
| Total de bytes de leitura | Número total de bytes verificados. |
| Número total de entidades verificadas | Número total de entidades verificadas. |
| Número total de entradas de índice verificadas | Número total de entradas de índice verificadas. |
| Número total de entidades gravadas | Número total de entidades gravadas. |
| Número total de entradas de índice gravadas | Número total de entradas de índice gravadas. |
| Soma total do tamanho da entidade gravada | Tamanho total da gravação da entidade em bytes. |
Limitações
- As consultas de streaming que contribuem para leituras e gravações faturáveis não são rastreadas como parte da resposta da API.
- Os insights de uso para operações de administrador (que contribuem para leituras e gravações faturáveis), como importação/exportação, exclusão em massa, restauração, clonagem e builds de índice na edição Enterprise, estão indisponíveis.
- O faturamento de saída de rede e armazenamento não é compatível.
Preços
Não há custo adicional para insights de uso.
Conferir insights de uso
Para conferir insights de uso de um banco de dados do Firestore no modo Datastore, abra o painel Insights de uso no Google Cloud console.
No Google Cloud console, acesse a página Bancos de dados.
Na lista, selecione um banco de dados.
No menu de navegação, clique em Insights de uso.
Use o menu suspenso Agrupar por para conferir insights de uso de uma coleção, um grupo de coleções ou um namespace. É possível conferir dados de insights de uso dos últimos 45 dias.