Visualizza la topologia di un'istanza di calcolo

Questo documento spiega come visualizzare la posizione fisica delle istanze di Compute Engine A4X Max, A4X, A4, A3 Ultra, A3 Mega e A3 High (8 GPU) in esecuzione 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 loro disposizioni per verificare quali istanze sono più vicine tra loro. Comprendendo la vicinanza delle istanze, puoi:

Modificare la progettazione dell'applicazione o del carico di lavoro per ridurre ulteriormente la latenza di rete.
Risolvere i problemi di latenza o prestazioni di rete delle istanze che comunicano frequentemente, se si trovano inaspettatamente molto distanti tra loro.

Prima di iniziare

Esamina la terminologia utilizzata nelle funzionalità di Cluster Director.
Seleziona la scheda relativa alla modalità di utilizzo degli esempi in questa pagina:
Console

Quando utilizzi la Google Cloud console per accedere a Google Cloud servizi e API, non devi configurare l'autenticazione.

gcloud

Nella Google Cloud console, attiva Cloud Shell.

Attiva Cloud Shell

Nella parte inferiore della Google Cloud console, viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già inclusa e installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
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 Google Cloud documentazione sull'autenticazione di.

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) sul 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.

Comprendere la topologia delle istanze di computing

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 Google Cloud console) o il campo physicalHostTopology (per gcloud CLI, l'API Compute Engine o eseguendo una query sulla chiave dei 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 sottoblocco in cui si trova l'istanza.
host: l'ID specifico dell'organizzazione dell'host su cui viene eseguita l'istanza.

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

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.

Visualizzare la topologia delle istanze di computing

Per visualizzare contemporaneamente la posizione fisica di più istanze di computing in esecuzione, utilizza l'API REST. In alternativa, 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 gcloud compute instances describe comando con il --flatten=resourceStatus.physicalHostTopology flag:

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 invii una richiesta, devi includere il parametro di query fields e specificare di mostrare solo i campi name, machineType e physicalHostTopology di un'istanza. Devi anche includere 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: instances.aggregatedList metodo

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: instances.list metodo

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 filter parametro di query.

Visualizzare la topologia delle istanze di computing eseguendo una query sulla chiave dei metadati

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

Istanze Linux

Connettiti all'istanza di computing Linux.

Dall'istanza Linux, crea una query utilizzando lo curl strumento. Per eseguire una query sulla chiave dei metadati physical_host_topology sulle 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 computing Windows.

Dall'istanza Windows, crea una query utilizzando il Invoke-RestMethod comando. 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:
- Gestire gli eventi sull'host nelle istanze di computing
- Gestire 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

Comprendere la topologia delle istanze di computing

Visualizzare la topologia delle istanze di computing

Console

gcloud

REST

Visualizzare la topologia delle istanze di computing eseguendo una query sulla chiave dei metadati

Istanze Linux

Istanze Windows

Passaggi successivi

Visualizza la topologia di un'istanza di calcolo