Visualizza la topologia di un'istanza di calcolo

Questo documento spiega come visualizzare la posizione fisica delle istanze 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 Compute Engine sono più vicine tra loro. Comprendendo la vicinanza delle istanze, puoi eseguire le seguenti operazioni:

  • 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 di calcolo che comunicano frequentemente, se si trovano inaspettatamente molto distanti tra loro.

Per visualizzare la topologia dei cluster in Cluster Director, consulta Visualizzare la topologia del cluster.

Prima di iniziare

  • Esamina la terminologia utilizzata nelle funzionalità di Cluster Director.

  • Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:

    Console

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

    gcloud

    Nella console Google Cloud , attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud 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à 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.

      Installa Google Cloud CLI.

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    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 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 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 vicinanza 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 dell'istanza di computing

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

Console

  1. Nella console Google Cloud , vai alla pagina Istanze VM.

    Vai a Istanze VM

  2. 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.

  3. 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 dell'istanza di computing 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

  1. Connettiti all'istanza di computing Linux.

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

  1. Connettiti all'istanza di calcolo Windows.

  2. 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