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

Vorschau

Diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie gesehen“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Sie können Topologie- und Statusinformationen zu Ihrer Kapazität im Modus „All Capacity“ vor oder nach der Bereitstellung von TPU-Slices über die Google Cloud Console oder die Google Cloud CLI abrufen. Sie können den physischen Standort einer TPU-VM-Instanz auch über die Compute Engine Instance API oder über einen curl-Befehl im Gastbetriebssystem der TPU-VM abrufen. Informationen zu Topologie und Systemzustand auf Cluster-, Block-, Unterblock-, Host- und VM-Ebene ermöglichen es Ihnen, topologiebewusste Entscheidungen zur Platzierung Ihrer 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 Reservierungsseite 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-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 Nutzung 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 Cluster Location (Cluster-Standort) angezeigt. In diesem Abschnitt werden der Clustername, die gehashte ID eines Blocks und die gehashte ID eines Unterblocks angezeigt.

Cluster-Namen sind in allen Google-Organisationen global eindeutig. Mit anderen Worten: Zwei verschiedene Kunden sehen möglicherweise denselben Clusternamen. Im Gegensatz zu Clusternamen sind die gehashten IDs von Blöcken oder Unterblöcken in den Projekten IhrerGoogle Cloud -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.

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

Reservierung beschreiben

Mit gcloud compute reservations describe können Sie sich einen Überblick über die Kapazität in Ihrer Reservierung verschaffen. Mit dem folgenden Befehl wird eine Zusammenfassung einer Reservierung angezeigt:

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 Dienstfreigabetyp
• resourceStatus.healthInfo.healthStatus: Gesamtzustand 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 Informationen zu Kapazität, Topologie und Status für alle Blöcke in einer Reservierung aufrufen.

Jeder Block, Unterblock und jedes Hostobjekt wird durch eine Hash-ID identifiziert. Die ID des übergeordneten Objekts wird in den Feldern der physischen Topologie untergeordneter Objekte angezeigt. Mithilfe der Hash-IDs können Sie eine Topologiehierarchieansicht 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 Zustand 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 können Sie Informationen zu einem bestimmten Block aufrufen.

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 gibt die folgende Ausgabe zurück:

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 Zustand 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 untergeordneten Blöcke in der Reservierung:

• count: die Anzahl der Hosts
• healthInfo.degradedInfraCount: Der fehlerfreie Zustand des Optical Circuit Switch (OCS) eines Ironwood-Cubes. Wenn dieser Wert 1 ist, bedeutet das, dass die OCS des Ironwood-Würfels beeinträchtigt ist. Dieser Wert gilt nicht für Trillium.
• healthInfo.healthStatus: der allgemeine Zustand 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 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 untergeordneten Blöcke in der Reservierung:

• count: die Anzahl der Hosts
• healthInfo.degradedInfraCount: Der fehlerfreie Zustand des Optical Circuit Switch (OCS) eines Ironwood-Cubes. Wenn dieser Wert 1 ist, bedeutet das, dass die OCS des Ironwood-Würfels beeinträchtigt ist. Dieser Wert gilt nicht für Trillium.
• healthInfo.healthStatus: der allgemeine Zustand 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 nachvollziehen.

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.

Mit beiden Befehlen werden Informationen zum Cluster, Block, Unterblock und Host der von Ihnen angegebenen TPU-VM angezeigt:

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