Topologie und Status von Reservierungen im Modus „Alle Kapazitäten“ ansehen

Sie können Topologie- und Statusinformationen zu Ihrer Kapazität im Modus „Alle Kapazitäten“ über die Google Cloud console oder die Google Cloud CLI abrufen, bevor oder nachdem Sie TPU-Slices bereitgestellt haben. Sie können den physischen Standort einer TPU-VM-Instanz auch über die Compute Engine Instance API oder über einen curl-Befehl aus dem Gastbetriebssystem der TPU-VM abrufen. Topologie- und Statusinformationen auf Cluster-, Block-, Unterblock-, Host- und VM-Ebene ermöglichen es Ihnen, topologiebezogene Platzierungsentscheidungen für Ihre Arbeitslasten zu treffen, bestimmte Blöcke oder Unterblöcke für die Bereitstellung auszuwählen und die relative Nähe zwischen TPU-VM-Instanzen zu verstehen.

Kapazitätstopologie in der Google Cloud console ansehen

So rufen Sie die Details Ihrer Reservierung in der Google Cloud console auf:

  1. Suchen Sie in der Google Cloud console über die Suchleiste nach „Reservierungen“ und rufen Sie die Seite „Reservierungen“ auf.
  2. Wählen Sie den Tab On-Demand-Reservierungen aus und suchen Sie nach Ihrer TPU-Reservierung im Modus „Alle Kapazitäten“. Ihr Account-Management-Team teilt Ihnen den Namen Ihrer Reservierung mit.
  3. Wählen Sie Ihre Reservierung aus, um die Detailseite aufzurufen.

Bei einer Reservierung im Modus „Alle Kapazitäten“ ist der Betriebsmodus auf Alle Kapazitäten festgelegt. Eine Liste der Blöcke wird zusammen mit einer Zusammenfassung ihrer Auslastung und ihres Status angezeigt.

Wählen Sie einen Block aus der Liste aus, um die Detailseite des Blocks aufzurufen. Die Topologie des Blocks wird im Abschnitt Clusterstandort angezeigt. In diesem Abschnitt werden der Clustername, die Hash-ID eines Blocks und die Hash-ID eines Unterblocks angezeigt.

Clusternamen sind in allen Google-Organisationen global eindeutig. Mit anderen Worten: Zwei verschiedene Kunden sehen möglicherweise denselben Clusternamen. Im Gegensatz zu Clusternamen sind die Hash-IDs von Blöcken oder Unterblöcken in den Google Cloud Projekten Ihrer Organisation eindeutig.

Sie können einen Unterblock auswählen, um die Detailseite des Unterblocks aufzurufen. Dort werden nur physische Hosts mit aktiven TPU-VM-Instanzen angezeigt. Nicht verwendete physische Hosts werden nicht angezeigt.

Kapazitätstopologie mit der Google Cloud CLI ansehen

Mit den Google Cloud CLI-Befehlen list und describe für Reservierungen, Blöcke und Unterblöcke können Sie Topologie- und Statusinformationen zu Ihrer Kapazität abrufen.

Mit den Informationen, die von den Befehlen in diesem Abschnitt angezeigt werden, können Sie die Topologiehierarchie der physischen Kapazität in Ihrer Reservierung bestimmen.

Reservierung beschreiben

Mit dem Befehl gcloud compute reservations describe können Sie eine Übersicht über die Kapazität in Ihrer Reservierung aufrufen. Der folgende Befehl zeigt eine Zusammenfassung einer Reservierung an:

gcloud compute reservations describe RESERVATION_NAME \
   --project=PROJECT_ID \
   --zone=ZONE

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: Der Name Ihrer Reservierung.
  • PROJECT_ID: Ihre Projekt-ID.
  • ZONE: Die Zone, in der sich Ihre Reservierung befindet.

Die Ausgabe sieht etwa so aus:

advancedDeploymentControl:
  reservationOperationalMode: ALL_CAPACITY
aggregateReservation:
  inUseResources:
  - accelerator:
      acceleratorCount: 48
      acceleratorType: projects/example-project/zones/us-central1-c/acceleratorTypes/tpu7x
  reservedResources:
  - accelerator:
      acceleratorCount: 128
      acceleratorType: projects/example-project/zones/us-central1-c/acceleratorTypes/tpu7x
  vmFamily: VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X
  workloadType: UNSPECIFIED
creationTimestamp: '2025-11-05T14:16:30.571-08:00'
deleteAtTime: '2026-11-06T08:00:00Z'
deploymentType: DENSE 
enableEmergentMaintenance: false
id: '8873145979824927313'
kind: compute#reservation
linkedCommitments:
- https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/commitments/example-cud
name: example-reservation
protectionTier: STANDARD
reservationSharingPolicy:
  serviceShareType: ALLOW_ALL
resourceStatus:
  healthInfo:
    degradedBlockCount: 0
    healthStatus: HEALTHY
    healthyBlockCount: 1
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: 
schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation
shareSettings:
  projectMap:
    '111111111111':
      projectId: '111111111111'
  shareType: SPECIFIC_PROJECTS
specificReservationRequired: true
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c

Die folgenden Werte aus der Ausgabe beschreiben die Reservierung:

  • advancedDeploymentControl.reservationOperationalMode: Der Kapazitätsmodus für die Reservierung
  • aggregateReservation.inUseResources.accelerator.acceleratorCount: Die Anzahl der verwendeten TPU-Chips
  • aggregateReservation.inUseResources.accelerator.acceleratorType: Die TPU-Version
  • reservedResources.accelerator.acceleratorCount: Die Anzahl der TPU-Chips in der Reservierung
  • deploymentType: Der Bereitstellungstyp (für TPUs immer DENSE)
  • reservationSharingPolicy.serviceShareType: Der Typ der Dienstfreigabe
  • resourceStatus.healthInfo.healthStatus: Der allgemeine Status der Kapazität
  • resourceStatus.healthInfo.healthyBlockCount: Die Anzahl der fehlerfreien Blöcke in der Reservierung
  • resourceStatus.reservationBlockCount: Die Anzahl der Blöcke in der Reservierung

Alle Reservierungsblöcke auflisten

Mit dem Befehl gcloud compute reservations blocks list können Sie Kapazitäts-, Topologie- und Statusinformationen für alle Blöcke in einer Reservierung anzeigen.

Jedes Block-, Unterblock- und Hostobjekt wird durch eine Hash-ID identifiziert. Die ID des übergeordneten Objekts wird in den Feldern der physischen Topologie der untergeordneten Objekte angezeigt. Mit den Hash-IDs können Sie eine Topologiehierarchie der Kapazität erstellen.

gcloud compute reservations blocks list RESERVATION_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: Der Name Ihrer Reservierung.
  • PROJECT_ID: Ihre Projekt-ID.
  • ZONE: Die Zone, in der sich Ihre Reservierung befindet.

Der Befehl zeigt die folgende Ausgabe an:

count: 32
creationTimestamp: '2025-11-05T15:00:15.223-08:00'
healthInfo:
  degradedSubBlockCount: 0
  healthStatus: HEALTHY
  healthySubBlockCount: 2
  id: '2996501069483632657'
inUseCount: 12
kind: compute#reservationBlock
name: example-reservation-block-0001
physicalTopology:
  block: 9a0e671424e45fd480ca172ad7a4e25d
  cluster: example-cluster
reservationMaintenance:
  schedulingType: GROUPED
reservationSubBlockCount: 2
reservationSubBlockInUseCount: 1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/2996501069483632657
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c


count: 128
creationTimestamp: '2025-08-19T18:23:32.825-07:00'
healthInfo:
  degradedSubBlockCount: 0
  healthStatus: HEALTHY
  healthySubBlockCount: 4
id: '9a0e671424e45fd480ca172ad7a4e25d'
inUseCount: 64
kind: compute#reservationBlock
name: example-reservation-block-0002
physicalTopology:
  block: 3feffcdeb6434d68bb818a836f75c1b8
  cluster: example-cluster
reservationMaintenance:
  schedulingType: GROUPED
reservationSubBlockCount: 2
reservationSubBlockInUseCount: 1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/2996501069483632657
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c

Die folgenden Werte aus der Ausgabe beschreiben die Blöcke in der Reservierung:

  • count: Die Anzahl der physischen Hosts
  • healthInfo.healthStatus: Der allgemeine Status des Blocks
  • healthInfo.healthySubblockCount: Die Anzahl der fehlerfreien Unterblöcke im Block
  • id: Die ID des Blocks
  • inUseCount: Die Anzahl der verwendeten physischen Hosts
  • kind: Die Art des beschriebenen Objekts
  • name: Der Name des Blocks
  • physicalTopology.block: Die Block-ID
  • physicalTopology.cluster: Der Cluster, in dem sich der Block befindet
  • reservationSubBlockCount: Die Anzahl der Unterblöcke in diesem Block
  • reservationSubBlockInUseCount: Die Anzahl der verwendeten Unterblöcke

Reservierungsblock beschreiben

Mit dem Befehl gcloud compute reservations blocks describe für einen bestimmten Block können Sie Informationen für den angegebenen Block anzeigen.

gcloud compute reservations blocks describe RESERVATION_NAME \
  --block-name=BLOCK_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: Der Name Ihrer Reservierung.
  • BLOCK_NAME: Der Name des Reservierungsblocks.
  • PROJECT_ID: Ihre Projekt-ID.
  • ZONE: Die Zone, in der sich Ihre Reservierung befindet.

Dieser Befehl zeigt die folgende Ausgabe an:

resource:
  count: 32
  creationTimestamp: '2025-11-05T15:00:15.223-08:00'
  healthInfo:
    degradedSubBlockCount: 0
    healthStatus: HEALTHY
    healthySubBlockCount: 2
  id: '2996501069483632657'
  inUseCount: 12
  kind: compute#reservationBlock
  name: example-reservation-block-0001
  physicalTopology:
    block: 9a0e671424e45fd480ca172ad7a4e25d
    cluster: example-cluster
  reservationMaintenance:
    schedulingType: GROUPED
  reservationSubBlockCount: 2
  reservationSubBlockInUseCount: 1
  selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001
  selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/2996501069483632657
  status: READY
  zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c

Die folgenden Werte aus der Ausgabe beschreiben die Blöcke in der Reservierung:

  • count: Die Anzahl der Hosts im Block
  • healthInfo.healthStatus: Der allgemeine Status des Blocks
  • healthInfo.healthySubblockCount: Die Anzahl der fehlerfreien Unterblöcke im Block
  • id: Die ID des Blocks
  • inUseCount: Die Anzahl der verwendeten Hosts
  • kind: Die Art des beschriebenen Objekts
  • name: Der Name des Blocks
  • physicalTopology.block: Die Block-ID
  • physicalTopology.cluster: Der Cluster, in dem sich der Block befindet
  • reservationSubBlockCount: Die Anzahl der Unterblöcke in diesem Block
  • reservationSubBlockInUseCount: Die Anzahl der verwendeten Unterblöcke

Alle Unterblöcke eines Blocks auflisten

Sie können die Unterblöcke in einem Block auflisten, um Informationen für jeden Unterblock anzuzeigen:

gcloud compute reservations sub-blocks list RESERVATION_NAME \
  --block-name=BLOCK_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: Der Name Ihrer Reservierung.
  • BLOCK_NAME: Der Name des Reservierungsblocks.
  • PROJECT_ID: Ihre Projekt-ID.
  • ZONE: Die Zone, in der sich Ihre Reservierung befindet.

Dieser Befehl zeigt die folgenden Informationen an:

count: 16
creationTimestamp: '2025-11-05T15:00:16.738-08:00'
healthInfo:
  degradedHostCount: 0
  degradedInfraCount: 0
  healthStatus: HEALTHY
  healthyHostCount: 16
  healthyInfraCount: 1
id: '8309376980435233263'
inUseCount: 0
kind: compute#reservationSubBlock
name: example-reservation-block-0001-subblock-0001
physicalTopology:
  block: 9a0e671424e45fd480ca172ad7a4e25d
  cluster: example-cluster
  subBlock: a0122935eb54d02750b65eef2d4f0366
reservationSubBlockMaintenance:
  schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001/reservationSubBlocks/example-reservation-block-0001-subblock-0001
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001/reservationSubBlocks/8309376980435233263
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c
---
count: 16
creationTimestamp: '2025-11-05T15:00:16.736-08:00'
healthInfo:
  degradedHostCount: 0
  degradedInfraCount: 0
  healthStatus: HEALTHY
  healthyHostCount: 16
  healthyInfraCount: 1
id: '5629213080155482607'
inUseCount: 12
kind: compute#reservationSubBlock
name: example-reservation-block-0001-subblock-0002
physicalTopology:
  block: 9a0e671424e45fd480ca172ad7a4e25d
  cluster: example-cluster
  subBlock: 7aca49831e54d32970631524bc060d9c
reservationSubBlockMaintenance:
  schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001/reservationSubBlocks/example-reservation-block-0001-subblock-0002
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001/reservationSubBlocks/5629213080155482607
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c

Die folgenden Werte aus der Ausgabe beschreiben die Unterblöcke in der Reservierung:

  • count: Die Anzahl der Hosts
  • healthInfo.degradedInfraCount: Der Status des Optical Circuit Switch (OCS) eines Ironwood-Cubes. Wenn dieser Wert 1 ist, ist der OCS des Ironwood-Cubes fehlerhaft. Dieser Wert gilt nicht für Trillium.
  • healthInfo.healthStatus: Der allgemeine Status des Unterblocks
  • healthInfo.healthyHostCount: Die Anzahl der fehlerfreien Hosts im Unterblock
  • id: Die ID des Blocks
  • inUseCount: Die Anzahl der verwendeten Hosts
  • kind: Die Art des beschriebenen Objekts
  • name: Der Name des Unterblocks
  • physicalTopology.block: Die ID des Blocks, der diesen Unterblock enthält
  • physicalTopology.cluster: Der Cluster, in dem sich der Block befindet
  • physicalTopology.subblock: Die ID des Unterblocks

Reservierungsunterblock beschreiben

Mit dem Befehl gcloud compute sub-blocks describe können Sie Informationen zu einem Unterblock aufrufen:

gcloud compute reservations sub-blocks describe RESERVATION_NAME \
  --block-name=BLOCK_NAME \
  --sub-block-name=SUB_BLOCK_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: Der Name Ihrer Reservierung.
  • BLOCK_NAME: Der Name des Reservierungsblocks.
  • SUB_BLOCK_NAME: Der Name des Reservierungsunterblocks.
  • PROJECT_ID: Ihre Projekt-ID.
  • ZONE: Die Zone, in der sich Ihre Reservierung befindet.

Dieser Befehl zeigt die folgenden Informationen an:

resource:
  count: 16
  creationTimestamp: '2025-11-05T15:00:16.736-08:00'
  healthInfo:
    degradedHostCount: 0
    degradedInfraCount: 0
    healthStatus: HEALTHY
    healthyHostCount: 16
    healthyInfraCount: 1
  id: '5629213080155482607'
  inUseCount: 12
  kind: compute#reservationSubBlock
  name: example-reservation-block-0001-subblock-0002
  physicalTopology:
    block: 9a0e671424e45fd480ca172ad7a4e25d
    cluster: example-cluster
    subBlock: 7aca49831e54d32970631524bc060d9c
  reservationSubBlockMaintenance:
    schedulingType: GROUPED
  selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001/reservationSubBlocks/example-reservation-block-0001-subblock-0002
  selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c/reservations/example-reservation/reservationBlocks/example-reservation-block-0001/reservationSubBlocks/5629213080155482607
  status: READY
  zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-c

Die folgenden Werte aus der Ausgabe beschreiben die Unterblöcke in der Reservierung:

  • count: Die Anzahl der Hosts
  • healthInfo.degradedInfraCount: Der Status des Optical Circuit Switch (OCS) eines Ironwood-Cubes. Wenn dieser Wert 1 ist, ist der OCS des Ironwood-Cubes fehlerhaft. Dieser Wert gilt nicht für Trillium.
  • healthInfo.healthStatus: Der allgemeine Status des Unterblocks
  • healthInfo.healthyHostCount: Die Anzahl der fehlerfreien Hosts im Unterblock
  • id: Die ID des Blocks
  • inUseCount: Die Anzahl der verwendeten Hosts
  • kind: Die Art des beschriebenen Objekts
  • name: Der Name des Unterblocks
  • physicalTopology.block: Die ID des Blocks, der diesen Unterblock enthält
  • physicalTopology.cluster: Der Cluster, in dem sich der Block befindet
  • physicalTopology.subblock: Die ID des Unterblocks

Physischen Standort einer TPU-VM-Instanz ermitteln

Nachdem Sie TPU-Slices bereitgestellt haben, können Sie den physischen Standort Ihrer TPU-VM-Instanzen abrufen. So können Sie die relativen Entfernungen zwischen TPU-VM-Instanzen für die Optimierung der Arbeitslastplanung ermitteln.

Sie können den physischen Standort einer TPU-VM-Instanz mit curl oder der Google Cloud CLI ermitteln:

curl

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

gcloud

gcloud compute instances describe VM_NAME \
    --format="table[box,title=VM-Position](resourceStatus.physical_host_topology:label=location)" \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • VM_NAME: Der Name Ihrer TPU-VM.
  • ZONE: Die Zone, in der sich Ihre TPU-VM befindet.

Beide Befehle zeigen Informationen zum Cluster, Block, Unterblock und Host der von Ihnen angegebenen TPU-VM an:

block: 3feffcdeb6434d68bb818a836f75c1b8
cluster: southamerica-west1-cluster-njga
subblock: cbee689cb721abdb0c7f80a4f2d0c1c7
host: 36b2d9731c1e1cf8594a759c8c4178f0