Primeiros Passos com o Key Visualizer.

Nesta página, descrevemos como usar o Key Visualizer para verificar problemas de desempenho relacionados aos seus padrões de uso do Firestore.

Antes de começar

Para usar o Key Visualizer para Firestore, é necessário ativar a API Firestore Key Visualizer.

Enable the API

Funções exigidas

Verifique se a conta recebeu um dos seguintes papéis do IAM:

  • Proprietário do Cloud Datastore
  • Leitor do Key Visualizer do Cloud Datastore
  • Editor
  • Proprietário

Esses papéis incluem as seguintes permissões do IAM, que são necessárias para acessar o Key Visualizer:

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

Também é possível definir um papel personalizado com as permissões necessárias.

Como visualizar uma verificação de um período

Cada verificação do Key Visualizer abrange um período de duas horas. Uma verificação para um determinado período está disponível para bancos de dados com tráfego que excede 3.000 operações de documentos em um determinado minuto.

Para iniciar o Key Visualizer:

  1. No Console do Google Cloud, acesse a página Bancos de Dados.

    Acessar "Bancos de dados"

  2. Selecione o banco de dados necessário na lista de bancos de dados.

  3. No menu de navegação, clique em Key Visualizer.

  4. Selecione um período e uma métrica das verificações disponíveis do Key Visualizer:

    1. Clique no ícone de lápis no canto superior direito. Selecione uma data e um período.

      As verificações estão disponíveis com base na qualificação para verificação. Não é possível selecionar períodos que não atendeu à qualificação da verificação ou que ainda estão em processamento. As duas verificações mais recentes do dia levam algum tempo para serem processadas antes de estarem disponíveis.

    2. Selecione Todos os dados do documento ou Todos os dados do índice como origem.

    3. Clique em Atualizar.

  5. Selecione uma métrica para analisar:

    Clique na lista suspensa de métricas no canto superior esquerdo e selecione uma opção para ver. O Key Visualizer é aberto na métrica Ops/s para chaves de documento e Ops de gravação de índice/s para chaves de índice por padrão.

Para comparar métricas ou procurar correlações de dados, exiba várias métricas do Key Visualizer. Consulte Como encontrar conexões entre diferentes métricas.

Como visualizar um resumo da atividade

Para uma visão geral da atividade durante o período de duas horas selecionado, consulte o mapa de calor da métrica padrão.

O exemplo a seguir mostra um mapa de calor em que há grandes diferenças no padrão de uso para diferentes intervalos de chaves:

  • Os intervalos mostrados em cores escuras têm pouca ou nenhuma atividade.
  • Os intervalos mostrados em cores claras têm mais atividade.
  • A faixa branca brilhante no meio tem uma atividade muito alta.

Example of a Key Visualizer scan

Digitalização de chaves de documentos

A métrica Ops/s mede o número de solicitações por segundo para cada intervalo de chaves. Essa métrica é uma soma de solicitações de gravação, pesquisa e consulta. O Key Visualizer mostra essa métrica por padrão quando você abre um mapa de calor.

Depois de ter uma ideia da atividade geral no seu banco de dados, continue sua investigação analisando outras métricas e concentrando-se nos intervalos de chave que podem causar problemas. Saiba mais.

Verificação de chaves de índice

A métrica Operações de gravação de índice/s em uma célula específica mede a média de gravações de índice por segundo no intervalo de tempo de 10 segundos e no intervalo de chave correspondente.

A seguir