Analisar insights de uso

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 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
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. Esse painel ajuda você a:

• Monitorar o uso granular: acompanhe as operações faturáveis detalhadas 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

(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 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 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: Cloud Firestore 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.

  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 Cloud Firestore está ativada.
  • Grupo de coleções: geralmente disponível em todas as configurações de API.

  Dados de insights de uso

  Os insights de uso no console do Google Cloud mostram dados originados 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 um nome de coleção ou um nome de 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 blocos (blocos 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 blocos (blocos de 1 KiB). Inclui unidades de exclusão também. 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 de leitura	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 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 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 os insights de uso de um banco de dados Cloud Firestore, abra o painel Insights de uso do banco de dados no console do Google Cloud.

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

     Acessar "Bancos de dados"

  2. Na lista, selecione um banco de dados.

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