O Key Visualizer está ativado no Spanner por padrão.
Antes de começar
Para acessar o Key Visualizer, você precisa das seguintes informações do Identity and Access Management (IAM):
spanner.databases.read
Se você é um usuário de controle de acesso refinado, deve ter acesso a:
- o papel do sistema
spanner_sys_reader
ou um dos papéis de membro dele.
Para mais informações, consulte Sobre controle de acesso detalhado e Papéis refinados do sistema de controle de acesso.
Acesse a interface do Key Visualizer
Acesse a ferramenta Key Visualizer no console do Google Cloud.
Para acessar o Key Visualizer:
Na página Spanner do Console do Google Cloud, selecione uma instância.
Selecione um banco de dados para investigar.
No menu de navegação, em Observabilidade, selecione Key Visualizer:
Desativar o Key Visualizer
O Key Visualizer é controlado pelo enable_key_visualizer
de banco de dados. O valor padrão é true
.
Para desativar o Key Visualizer, defina o valor da opção de banco de dados enable_key_visualizer
como false
. A sintaxe DDL para desativar o Key Visualizer é:
ALTER DATABASE `database_id` SET OPTIONS (enable_key_visualizer=false)
Se o ID do banco de dados contém caracteres que não sejam letras, números ou sublinhados, inclua o crase (``).
A instrução pode ser enviada usando um comando gcloud ou em uma
solicitação gRPC/REST UpdateDatabaseDdl
. Exemplo:
gcloud spanner databases ddl update database_id --instance=instance_id \
--ddl='ALTER DATABASE `database_id` SET OPTIONS ( enable_key_visualizer=false )'
Depois de definir explicitamente o valor de enable_key_visualizer
, verifique o valor dele clicando em SHOW EQUIVALENT DDL na página de visão geral ou usando o gcloud ddl describe
. comando:
gcloud spanner databases ddl describe `database_id` --instance=instance_id
Reativar o Key Visualizer
Para reativar o Key Visualizer, siga as instruções anteriores, configurando
o valor da opção de banco de dados enable_key_visualizer
para true
.
Na primeira reativação para um banco de dados, o mapa de calor do Key Visualizer estará vazio nos primeiros minutos enquanto o Spanner coleta métricas.
A seguir
- Aprenda a reconhecer padrões comuns em mapas de calor.
- Descubra como explorar um mapa de calor em detalhes.
- Leia sobre as métricas exibidas em um mapa de calor.