Analisar insights de uso

Nesta página, descrevemos 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
  • Leituras de streaming (Listen solicitações)
  • 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 (pesquisa Listen)
  • Unidades de leitura em tempo real (atualizações de streaming do Listen)
  • Unidades de gravação de stream (StreamWrite solicitações, incluindo 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. Esse 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 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 é 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.
  • Uso do GroupBy:mostra as métricas divididas pelas 100 principais dimensões e agrupadas por coleção, grupo de coleções 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 exibida na seção Uso total. Essa variação é esperada devido aos seguintes fatores:

  • Limites de GroupBy (100 principais): a seção GroupBy é restrita à discriminação do uso de apenas 100 coleções, grupos de coleções ou namespaces principais. 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, mesclagens 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 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 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 Cloud 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 provenientes 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 que não são de streaming. Inclui operações de exclusão. Aplicável apenas à edição Standard.
    Total de operações de leitura de stream Número total de operações de leitura usadas para solicitações de streaming de Listen (incluindo sondagem 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 tranches (tranches de 4 KiB) para leituras que não são de streaming. Aplicável apenas à edição Enterprise.
    Total de unidades de gravação Número total de unidades de gravação em incrementos (incrementos de 1 KiB) para gravações que não são de streaming. 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 sondagem 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.
    Contagem total de entradas de índice verificadas Número total de entradas de índice verificadas.
    Total de documentos gravados Número total de documentos gravados.
    Contagem 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

    • Não há suporte para insights de uso de 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 há suporte para faturamento de saída de rede e armazenamento.

    Preços

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

    Ver insights de uso

    Para conferir os insights de uso de um banco de dados do 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.

      Os insights de uso de um banco de dados no modo nativo no console do Google Cloud

      Use o menu suspenso Agrupar por para conferir insights de uso de uma coleção, collectionGroup ou namespace. É possível ver os dados de insights de uso dos últimos 45 dias.