Analisar insights de uso

Nesta página, descrevemos como usar os insights de uso para analisar seu 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	Leituras Gravações (inclui exclusões) Exclusões TTL
Enterprise	Leituras Gravações Exclusões TTL Evento

Visão geral dos insights de uso

Use o painel de insights de uso para monitorar o uso de bancos de dados específicos. Este painel ajuda você a:

Monitorar o uso granular: acompanhe suas operações faturáveis divididas por dimensões como collection, collectionGroup ou namespace.
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

Papel do IAM (roles/datastore.viewer) 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 "Insights de uso" está organizado em duas seções principais:

Uso total:mostra métricas agregadas (leituras, gravações, exclusões de TTL) para todo o banco de dados.
Agrupar por uso:mostra as métricas divididas pelas 100 principais dimensões e agrupadas 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 variância é esperada devido aos seguintes fatores:

Limites de GroupBy (100 principais): a seção "GroupBy" é restrita à listagem do uso apenas das 100 principais coleções, grupos de coleções ou namespaces. O uso gerado por dimensões menos ativas contribui para a figura "Uso total", mas não é listado individualmente nas métricas de uso "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 fazer amostragem de coleções, priorizando aquelas com maior uso. Por isso, nem todas as coleções afetadas são incluídas nas métricas de uso do GroupBy.

Nomes reservados:o Firestore reserva nomes prefixados com dois sublinhados (__*__) para metadados internos. O uso relacionado a esses nomes reservados contribui para o uso total, mas não está incluído nas métricas de uso do GroupBy.

Dimensões de GroupBy

A seção "GroupBy" organiza as métricas de uso com base nas dimensões determinadas pelas APIs ativadas:

Coleção: disponível quando a API Firestore está ativada.
Grupo de coleta: disponível para todos os usuários em todas as configurações de API.

Dados de insights de uso

Os insights de uso no console do Google Cloud mostram dados provenientes dos seguintes métodos de API:

queryTopAggregatedInsightsData
queryTopTimeseriesInsightsData

Nome do campo	Detalhes
Nome da coleção Nome do grupo de coleções	O valor correspondente à dimensão de uso para a qual os dados de uso são agregados. Pode ser o nome de uma coleção ou de um grupo de coleções.
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 operações de leitura	Número total de unidades de leitura em tranches (tranches de 4 KiB). Aplicável apenas à edição Enterprise.
Total de operações de gravação	Número total de unidades de gravação em incrementos (incrementos de 1 KiB). Inclui também unidades de exclusão. Aplicável apenas à edição Enterprise.
Total de operações de exclusão de TTL ou exclusão gerenciada	Número total de unidades de exclusão de TTL ou exclusão gerenciada. Aplicável apenas à edição Enterprise.
Total de unidades do Eventarc	Número total de unidades do Eventarc. Aplicável apenas à edição Enterprise.
Total de bytes lidos	Número total de bytes verificados.
Total de documentos digitalizados	Número total de documentos verificados.
Total de entradas de índice verificadas	Número total de entradas de índice verificadas.
Total de documentos gravados	Número total de documentos gravados.
Total de entradas de índice gravadas	Número total de entradas de índice gravadas.
Soma total do tamanho do documento gravado	Tamanho total de gravação do documento 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 criação de índices na edição Enterprise, não são compatíveis.
O faturamento de saída de rede e armazenamento está indisponível.

Preços

Não há custo adicional para os insights de uso.

Ver insights de uso

Para conferir insights de uso de um banco de dados do Firestore, abra o painel Insights de uso do banco de dados no console do Google Cloud .

No console do Google Cloud , acesse a página Bancos de dados.

Acessar "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 collectionGroup ou um namespace. É possível conferir os dados de insights de uso dos últimos 45 dias.