Visualizza la topologia di un'istanza di calcolo

Questo documento spiega come visualizzare la posizione fisica delle istanze Compute Engine A4X Max, A4X, A4, A3 Ultra, A3 Mega e A3 High (8 GPU) che vengono eseguite su blocchi di capacità riservati.

Dopo aver creato istanze A4X Max, A4X, A4, A3 Ultra, A3 Mega e A3 High (8 GPU), puoi visualizzare le relative disposizioni per verificare quali istanze sono più vicine tra loro. Comprendendo la prossimità delle istanze, puoi:

Modifica la progettazione dell'applicazione o del workload per ridurre ulteriormente la latenza di rete.
Risolvi i problemi di latenza o prestazioni di rete delle istanze che comunicano frequentemente, se si trovano in posizioni inaspettatamente distanti.

Prima di iniziare

Esamina la terminologia utilizzata nelle funzionalità di Cluster Director.
Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare la topologia delle istanze di computing, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare la topologia delle istanze di computing. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare la topologia delle istanze di computing sono necessarie le seguenti autorizzazioni:

Per visualizzare i dettagli di un'istanza: compute.instances.get sul progetto
Per visualizzare un elenco di istanze: compute.instances.list sul progetto

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Informazioni sulla topologia delle istanze di calcolo

Quando visualizzi i dettagli di un'istanza di computing in esecuzione, puoi comprenderne la posizione fisica in un cluster controllando il campo Host fisico (per la console Google Cloud ) o il campo physicalHostTopology (per gcloud CLI, l'API Compute Engine o eseguendo una query sulla chiave di metadati). Questi campi contengono i seguenti campi secondari:

cluster: il nome globale del cluster.
block: l'ID specifico dell'organizzazione del blocco riservato in cui si trova l'istanza.
sub-block: l'ID specifico dell'organizzazione del sotto-blocco in cui si trova l'istanza.
host: l'ID specifico dell'organizzazione dell'host su cui viene eseguita l'istanza.

Per comprendere la prossimità delle istanze, confronta i valori dei campi Host fisico o physicalHostTopology tra le istanze. Più sottocampi condividono le istanze, più sono vicine fisicamente.

Puoi anche visualizzare la topologia di una prenotazione in cui vengono create le istanze di computing. I campi physicalHostTopology di una prenotazione e di un'istanza mostrano gli stessi campi block e cluster. Ad esempio, quando visualizzi un blocco riservato specifico, puoi visualizzare il nome e il sottoblocco di tutte le istanze di cui è stato eseguito il deployment nel blocco. Per saperne di più sulla topologia di una prenotazione, consulta Visualizzare la topologia di una prenotazione.

Visualizza la topologia delle istanze di calcolo

Per visualizzare contemporaneamente la posizione fisica di più istanze di Compute in esecuzione, utilizza l'API REST. In caso contrario, seleziona una delle seguenti opzioni:

Console

Nella console Google Cloud , vai alla pagina Istanze VM.

Vai a Istanze VM
Nella colonna Nome, fai clic sul nome dell'istanza di cui vuoi visualizzare i dettagli. Viene visualizzata una pagina con i dettagli dell'istanza e viene selezionata la scheda Dettagli.
Nella sezione Informazioni di base, controlla il valore del campo Host fisico.

gcloud

Per visualizzare la posizione fisica di un'istanza di computing in esecuzione, utilizza il comando gcloud compute instances describe con il flag --flatten=resourceStatus.physicalHostTopology:

gcloud compute instances describe INSTANCE_NAME \
    --flatten=resourceStatus.physicalHostTopology \
    --zone=ZONE

Sostituisci quanto segue:

INSTANCE_NAME: il nome dell'istanza
ZONE: la zona in cui esiste l'istanza

L'output è simile al seguente:

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

REST

Per visualizzare la posizione fisica delle istanze di computing in esecuzione, invia una delle seguenti richieste GET. Quando effettui una richiesta, devi includere il parametro di query fields e specificare di mostrare solo i campi name, machineType e physicalHostTopology di un'istanza. Devi includere anche il parametro di query filter e specificare di elencare solo le istanze in esecuzione.

Per visualizzare un elenco delle tue istanze in tutte le zone: metodo instances.aggregatedList

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/instances?fields=items.name,items.machineType,items.resourceStatus.physicalHostTopology&filter=status=RUNNING

Per visualizzare un elenco delle tue istanze in una zona specifica: metodo 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

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui esistono le istanze.
ZONE: la zona in cui esistono le istanze.

L'output è simile al seguente:

{
  "items": [
    {
      "name": "vm-01",
      "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
      "resourceStatus": {
        "physicalHostTopology": {
          "cluster": "europe-west1-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/a3-ultragpu-8g",
      "resourceStatus": {
        "physicalHostTopology": {
          "cluster": "europe-west1-cluster-jfhb",
          "block": "3e3056e23cf91a5cb4a8621b6a52c100",
          "subBlock": "1fc18636cbd4abd623553784ca2c174e",
          "host": "2326279b5ecdfc545fd5e39167698168"
        }
      }
    },
    ...
  ]
}

Se vuoi perfezionare l'elenco delle istanze, modifica l'espressione di filtro nel parametro di query filter.

Visualizza la topologia delle istanze di calcolo eseguendo query sulla chiave dei metadati

Per visualizzare la posizione fisica di un'istanza di computing in esecuzione eseguendo una query sulla chiave di metadati physical_host_topology, seleziona una delle seguenti opzioni:

Istanze Linux

Connettiti all'istanza di calcolo Linux.

Dalla tua istanza Linux, crea una query utilizzando lo strumento curl. Per eseguire query sulla chiave di metadati physical_host_topology nelle istanze Linux, esegui questo comando:

user@myinst:~$ curl -s -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology

L'output è simile al seguente:

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

Istanze Windows

Connettiti all'istanza di calcolo Windows.

Dall'istanza Windows, crea una query utilizzando il comando Invoke-RestMethod. Per eseguire una query sulla chiave dei metadati physical_host_topology sulle istanze Windows, esegui questo comando:

PS C:\> 
$value = (Invoke-RestMethod `
        -Headers @{'Metadata-Flavor' = 'Google'} `
        -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology")
$value

L'output è simile al seguente:

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

Passaggi successivi

Scopri come gestire gli eventi sull'host:
- Gestisci gli eventi sull'host nelle istanze di computing
- Gestisci gli eventi sull'host nelle prenotazioni
Monitorare le istanze di computing e i cluster

Visualizza la topologia di un'istanza di calcolo Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Console

gcloud

REST

Ruoli obbligatori

Autorizzazioni obbligatorie

Informazioni sulla topologia delle istanze di calcolo

Visualizza la topologia delle istanze di calcolo

Console

gcloud

REST

Visualizza la topologia delle istanze di calcolo eseguendo query sulla chiave dei metadati

Istanze Linux

Istanze Windows

Passaggi successivi

Visualizza la topologia di un'istanza di calcolo