O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

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 exibidas 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 Leituras de streaming (solicitações `Listen`) Gravações de stream (`StreamWrite` solicitações, incluindo exclusões)
Enterprise	Unidades de leitura Unidades de gravação (inclui exclusões) Unidades de exclusão de TTL ou exclusão gerenciada Unidades do Eventarc Unidades de leitura de stream (polling `Listen`) Unidades de leitura em tempo real (atualizações de streaming do `Listen`) Unidades de gravação de stream (solicitações `StreamWrite`, inclui exclusões)

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 do IAM de 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 de insights de uso está organizado em duas seções principais:

Uso total:exibe métricas agregadas (leituras, gravações, leituras de stream, gravações de stream e exclusões de TTL) para todo o banco de dados.
Agrupar por uso:mostra as métricas detalhadas pelas 100 principais dimensões e agrupadas por coleta, grupo de coleta ou namespace.

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 das 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 do 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 o maior uso. Como resultado, 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 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 coleções: em disponibilidade geral em todas as configurações de API.

Dados de insights de uso

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

queryTopAggregatedInsightsData
queryTopTimeseriesInsightsData

Nome do campo	Detalhes
Nome da coleção Nome do CollectionGroup	O valor correspondente à dimensão de uso para que 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 sem streaming. Aplicável apenas à edição Standard.
Total de operações de gravação	Número total de operações de gravação sem streaming. Inclui operações de exclusão. Aplicável apenas à edição Standard.
Total de operações de leitura de fluxo	Número total de operações de leitura usadas para solicitações de streaming `Listen`, incluindo pesquisa de consulta inicial, notificações de mudança de documento em tempo real, resultados ignorados, leituras de índice e cobranças mínimas de leitura. Aplicável apenas à edição Standard.
Total de operações de gravação de stream	Número total de operações de gravação usadas para solicitações `StreamWrite`. Inclui operações de exclusão. 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 unidades de leitura	Número total de unidades de leitura em blocos (blocos de 4 KiB) para leituras não transmitidas. Aplicável apenas à edição Enterprise.
Total de unidades de gravação	Número total de unidades de gravação em incrementos (1 KiB) para gravações não transmitidas. Inclui 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 unidades de leitura de stream	Número total de unidades de leitura em tranches (tranches de 4 KiB) usadas para operações de polling em solicitações de streaming `Listen`. Aplicável apenas à edição Enterprise.
Total de unidades de leitura em tempo real	Número total de unidades de leitura em tempo real (tranches de 1 KiB) usadas para atualizações de streaming em solicitações `Listen`. Aplicável apenas à edição Enterprise.
Total de unidades de gravação de stream	Número total de unidades de gravação em blocos (blocos de 1 KiB) usadas para solicitações de `StreamWrite`. Inclui unidades de exclusão. Aplicável apenas à edição Enterprise.
Total de bytes lidos	Número total de bytes verificados.
Total de documentos verificados	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 de documentos em bytes.

Limitações

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, não são compatíveis.
Não há suporte para saída de rede e faturamento de armazenamento.

Preços

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

Conferir 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.