Ver a topologia do cluster H4D

Depois de criar um cluster H4D em blocos de capacidade reservados, é possível conferir a organização física das VMs que compõem o cluster. Entender a organização das VMs permite fazer o seguinte:

  • Ajuste o design do aplicativo ou da carga de trabalho para minimizar ainda mais a latência da rede, especialmente para cargas de trabalho que usam o Cloud RDMA.
  • Resolva problemas de latência ou desempenho de rede de VMs que se comunicam com frequência.

Antes de começar

Verifique se você tem as permissões necessárias para acessar as informações de topologia da VM.

Funções exigidas

Para receber as permissões necessárias para ver a topologia das VMs, peça ao administrador para conceder a você o papel do IAM de Administrador da instância do Compute (v1) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém todas as permissões necessárias para visualizar a topologia das VMs. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

As permissões a seguir são necessárias para visualizar a topologia de VMs:

  • Para ver os detalhes de uma VM: compute.instances.get no projeto
  • Para conferir uma lista de VMs: compute.instances.list no projeto

Entender a topologia das VMs

Ao conferir os detalhes de uma VM em execução, é possível recuperar informações sobre a localização física dela em um cluster. Para isso, verifique o campo Host físico (para o console Google Cloud ) ou o campo physicalHostTopology (para a CLI gcloud), a API Compute Engine ou consulte a chave de metadados. Esses campos contêm os seguintes subcampos:

  • cluster: o nome global do cluster.
  • block: o ID específico da organização do bloco reservado em que a VM está localizada.
  • sub-block: o ID específico da organização do subbloco em que a VM está localizada.
  • host: o ID específico da organização do host em que a VM é executada.

Para definições desses termos, consulte Terminologia de cluster.

Para entender a proximidade entre as VMs, compare os valores dos campos Host físico ou physicalHostTopology entre elas. Quanto mais subcampos as VMs compartilharem, mais próximas elas estarão fisicamente.

Também é possível conferir a topologia de uma reserva em que as VMs são criadas. Os campos physicalHostTopology de uma reserva e uma VM mostram os mesmos campos block e cluster. Ao visualizar um bloco reservado específico, você pode conferir o nome e o sub-bloco de todas as VMs implantadas nele. Para mais informações sobre a topologia de uma reserva, consulte Conferir a topologia de uma reserva.

Conferir a topologia das VMs

Para conferir o local físico de várias VMs em execução, selecione uma das seguintes opções:

Console

  • No console do Google Cloud , acesse a página Instâncias de VM.

    Acessar instâncias de VM

  • Na coluna Nome, clique no nome da VM para ver os detalhes dela. Uma página com os detalhes da VM vai aparecer. A guia Detalhes é selecionada por padrão.

  • Na seção Informações básicas, verifique o valor do campo Host físico.

CLI do Google Cloud

Para conferir o local físico de uma VM em execução, use o comando gcloud compute instances describe com o flag flatten=resourceStatus.physicalHostTopology.

Substitua:

  • VM_NAME: o nome da VM.
  • ZONE: a zona em que a VM está.

O resultado será o seguinte:

---
cluster: europe-west1-cluster-jfhb
block: 3e3056e23cf91a5cb4a8621b6a52c100
subBlock: 0fc09525cbd5abd734342893ca1c083f
host: 1215168a4ecdfb434fd4d28056589059

REST

Para conferir o local físico das suas VMs em execução, faça uma das seguintes solicitações GET. Ao fazer uma solicitação, inclua o parâmetro de consulta fields e especifique para mostrar apenas os campos name, machineType e physicalHostTopology de uma VM. Também é necessário incluir o parâmetro de consulta filter e especificar que apenas as VMs em execução sejam listadas.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/instances?fields=items.name,items.machineType,items.resourceStatus.physicalHostTopology&filter=status=RUNNING
  • Para conferir uma lista das suas VMs em uma zona específica: método instances.list.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances?fields=items.name,items.machineType,items.resourceStatus.physicalHostTopology&filter=status=RUNNING

Substitua o seguinte: * PROJECT_ID: o ID do projeto em que as VMs estão. * ZONE: a zona em que as VMs estão.

O resultado será o seguinte:

{
  "items": [
    {
      "name": "vm-01",
      "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/machineTypes/h4d-highmem-192-lssd",
      "resourceStatus": {
        "physicalHostTopology": {
          "cluster": "europe-west4-cluster-jfhb",
          "block": "3e3056e23cf91a5cb4a8621b6a52c100",
          "subBlock": "0fc09525cbd5abd734342893ca1c083f",
          "host": "1215168a4ecdfb434fd4d28056589059"
        }
      }
    },
    {
      "name": "vm-02",
      "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/h4d-highmem-192-lssd",
      "resourceStatus": {
        "physicalHostTopology": {
          "cluster": "europe-west4-cluster-jfhb",
          "block": "3e3056e23cf91a5cb4a8621b6a52c100",
          "subBlock": "1fc18636cbd4abd623553784ca2c174e",
          "host": "2326279b5ecdfc545fd5e39167698168"
        }
      }
    },
    ...
  ]
}

Se quiser refinar sua lista de VMs, edite a expressão de filtro no parâmetro de consulta filter.

Consultar a chave de metadados para ver a topologia das VMs

Para conferir o local físico de uma VM em execução consultando a chave de metadados physical_host_topology, selecione uma das seguintes opções:

VMs do Linux

  1. Conecte-se à VM do Linux.
  2. Na VM do Linux, crie uma consulta usando a ferramenta curl. Para consultar a chave de metadados physical_host_topology em VMs do Linux, execute o seguinte comando:
curl -s -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology

O resultado será o seguinte:

{
  "cluster": "europe-west4-cluster-jfhb",
  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
  "subBlock": "1fc18636cbd4abd623553784ca2c174e",
  "host": "2326279b5ecdfc545fd5e39167698168"
}

VM do Windows

  1. Conecte-se à VM do Windows.
  2. Na VM do Windows, crie uma consulta usando o Invoke-RestMethod. Para consultar a chave de metadados physical_host_topology nas VMs do Windows, execute o seguinte comando:
$value = (Invoke-RestMethod `
  -Headers @{'Metadata-Flavor' = 'Google'} `
  -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology")
$value

O resultado será o seguinte:

{
  "cluster": "europe-west4-cluster-jfhb",
  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
  "subBlock": "1fc18636cbd4abd623553784ca2c174e",
  "host": "2326279b5ecdfc545fd5e39167698168"
}

A seguir