Exibir detalhes da instância

Para inspecionar o status, o endereço IP, o tipo de máquina, as flags de banco de dados ativas e a distribuição de zona de uma instância em um cluster do AlloyDB para PostgreSQL, confira os detalhes da instância.

Antes de começar

  • O projeto do Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • Você precisa ter um destes papéis do IAM no Google Cloud projeto que está sendo usado:
    • roles/alloydb.admin (o papel predefinido do IAM de Admin do AlloyDB)
    • roles/owner (o papel básico do IAM de Proprietário)
    • roles/editor (o papel básico do IAM de Editor)

    Se você não tiver nenhum desses papéis, entre em contato com o Administrador da organização para solicitar o acesso.

Procedimento

Console

  1. No Google Cloud console, acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do Recurso.

  3. Na página Visão geral que será aberta, acesse a seção Instâncias no cluster e confira os detalhes sobre a instância.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a Google Cloud CLI ou usar o Cloud Shell.

Para ver detalhes sobre uma instância, use o comando gcloud alloydb instances describe.

gcloud alloydb instances describe INSTANCE_ID \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --project=PROJECT_ID

Substitua:

  • INSTANCE_ID: o ID da instância.
  • REGION_ID: o ID da região da instância.
  • CLUSTER_ID: o ID do cluster da instância.
  • PROJECT_ID: o ID do projeto da instância.

Determinar as zonas de uma instância principal

Para garantir alta disponibilidade, uma instância primária do AlloyDB é composta por duas instâncias de máquina virtual (VM): uma VM ativa, que responde às solicitações, e uma VM em espera. Essas VMs são executadas em duas zonas diferentes da região da instância.

Para determinar em quais zonas as VMs da instância principal são executadas, siga as etapas na seção anterior e examine uma parte específica da resposta ao comando ou da exibição do console do Google Cloud :

Console

No console Google Cloud , acesse a página Clusters:

Acessar Clusters

A coluna Local mostra a zona da VM ativa de cada instância principal.

A mesma coluna mostra apenas o ID da região para clusters e instâncias de pool de leitura. Por exemplo, um cluster com um Local de us-central1 pode ter uma instância principal que exibe o ID de zona completo da VM ativa de us-central1-f.

A seção Instâncias no cluster da página de detalhes de um cluster mostra as mesmas informações no campo Local da instância primária. Esse campo também lista o local da VM em espera, rotulado como "zona secundária".

gcloud

Depois de executar o comando descrito na seção anterior, localize os seguintes campos na saída do comando:

  • writableNode: o ID da zona da VM ativa.

  • nodes: o ID da zona da VM em espera.

Por exemplo, a saída parcial a seguir indica que a VM ativa da instância primária é executada na zona us-central1-f, enquanto a de espera está em us-central1-c:

nodes:
- zoneId: us-central1-c
reconciling: false
state: READY
uid: 3477b790-21bc-4338-a09e-339912e3b28e
updateTime: '2022-08-09T21:22:16.671268941Z'
writableNode:
  zoneId: us-central1-f

Determinar os nós de uma instância do pool de leitura

Ao visualizar os detalhes de uma instância de pool de leitura usando a CLI gcloud, é possível ver mais informações sobre os nós constituintes com o argumento opcional --view=FULL. Para mais informações, consulte Resolver problemas de consultas de pool de leitura.