Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

コンピューティングインスタンスのトポロジを表示する

このドキュメントでは、ゾーン内の Compute Engine インスタンスの物理的な場所（トポロジ）を表示する方法について説明します。Cluster Director でクラスタのトポロジを表示するには、クラスタトポロジを表示するをご覧ください。

A4X Max、A4X、A4、A3 Ultra、A3 Mega、A3 High（8 個の GPU）インスタンス、またはコンパクトプレースメントポリシーまたはワークロードポリシーを指定するコンピューティングインスタンスを作成すると、コンピューティングインスタンスの物理的な位置を相互に関連付けて確認できます。コンピューティングインスタンスの近接性を把握したら、アプリケーションまたはワークロードの設計を調整して、互いに最も近いコンピューティングインスタンスでレイテンシの影響を受けやすいジョブを実行できます。他のすべてのタイプのコンピューティングインスタンスでは、ホスト ID を公開すると、実行されているホストの ID を確認できます。

始める前に

コンピューティングインスタンスのトポロジの用語を確認します。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール

Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud

Google Cloud CLI をインストールし、フェデレーション ID を使用して gcloud CLI にログインします。ログイン後、次のコマンドを実行して Google Cloud CLI を初期化します。
```
gcloud init
```
REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

必要なロール

コンピューティングインスタンスのトポロジを表示するために必要な権限を取得するには、プロジェクトに対する Compute インスタンス管理者（v1）（roles/compute.instanceAdmin.v1）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには、コンピューティングインスタンスのトポロジを表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

コンピューティングインスタンスのトポロジを表示するには、次の権限が必要です。

コンピューティングインスタンスの詳細を表示する: プロジェクトに対する compute.instances.get
コンピューティングインスタンスのリストを表示する: プロジェクトに対する compute.instances.list

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

コンピューティングインスタンスのトポロジについて

クラスタ内のコンピューティングインスタンスの物理的な位置を確認するには、 Google Cloud コンソールの [物理ホスト] フィールドを確認します。gcloud CLI、Compute Engine API、またはメタデータキークエリを使用する場合は、physicalHostTopology フィールドを確認します。これらのフィールドには次のサブフィールドが含まれます。

cluster: クラスタのグローバル名。
block: インスタンスが配置されている予約済みブロックの組織固有の ID。
sub-block: インスタンスが配置されているサブブロックの組織固有の ID。
host: インスタンスが実行されているホストの組織固有の ID。

インスタンスの近接性を把握するには、コンピューティングインスタンス間の [物理ホスト] フィールドまたは physicalHostTopology フィールドの値を比較します。コンピューティングインスタンスが共有するサブフィールドが多いほど、相互に近くなります。

コンピューティングインスタンスが作成される予約のトポロジを表示することもできます。予約とインスタンスの physicalHostTopology フィールドに同じ block フィールドと cluster フィールドが表示されます。たとえば、特定の予約済みブロックを表示すると、そのブロックにデプロイされているすべてのコンピューティングインスタンスの名前とサブブロックが表示されます。予約のトポロジの詳細については、予約のトポロジを表示するをご覧ください。

コンピューティングインスタンスのトポロジを表示する

複数の実行中のコンピューティングインスタンスの物理的なロケーションを一度に表示するには、REST API を使用します。それ以外の場合は、次のいずれかのオプションを選択します。

コンソール

Google Cloud コンソールで、[VM インスタンス] ページに移動します。

[VM インスタンス] に移動
[名前] 列で、詳細を表示するコンピューティングインスタンスの名前をクリックします。コンピューティングインスタンスの詳細を示すページが表示され、[詳細] タブが選択されています。
[基本情報] セクションで、[物理ホスト] フィールドの値を確認します。

gcloud

実行中のコンピューティングインスタンスの物理的な位置を表示するには、--flatten=resourceStatus.physicalHostTopology フラグを指定して gcloud compute instances describe コマンドを使用します。

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

次のように置き換えます。

INSTANCE_NAME: コンピューティングインスタンスの名前。
ZONE: コンピューティングインスタンスが存在するゾーン。

出力は次のようになります。

コンピューティングインスタンスのクラスタ、ブロック、サブブロック、ホストの ID を表示できる場合、出力は次のようになります。
```
---
cluster: europe-west1-cluster-jfhb
block: 3e3056e23cf91a5cb4a8621b6a52c100
subBlock: 0fc09525cbd5abd734342893ca1c083f
host: 1215168a4ecdfb434fd4d28056589059
```
ホストの ID を公開後にのみ表示できる場合、出力は次のようになります。
```
---
cluster: null
block: null
subBlock: null
host: 1215168a4ecdfb434fd4d28056589059
```

REST

実行中のコンピューティングインスタンスの物理的なロケーションを表示するには、次のいずれかの GET リクエストを行います。リクエストを行う場合は、fields クエリパラメータを含め、コンピューティングインスタンスの name、machineType、physicalHostTopology フィールドのみを表示するように指定する必要があります。また、filter クエリパラメータを含めて、実行中のコンピューティングインスタンスのみを一覧表示するように指定する必要があります。

すべてのゾーンのインスタンスのリストを表示するには: 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

特定のゾーンのインスタンスのリストを表示するには: 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

次のように置き換えます。

PROJECT_ID: コンピューティングインスタンスが存在するプロジェクトの ID。
ZONE: コンピューティングインスタンスが存在するゾーン。

出力は次のようになります。

コンピューティングインスタンスのクラスタ、ブロック、サブブロック、ホストの ID を表示できる場合、出力は次のようになります。

{
  "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"
        }
      }
    },
    ...
  ]
}

公開後にホストのコンピューティングインスタンスの ID のみを表示できる場合、出力は次のようになります。

{
  "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": null,
          "block": null,
          "subBlock": null,
          "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": null,
          "block": null,
          "subBlock": null,
          "host": "2326279b5ecdfc545fd5e39167698168"
        }
      }
    },
    ...
  ]
}

コンピューティングインスタンスのリストを絞り込む場合は、filter クエリパラメータでフィルタ式を編集します。

メタデータキーのクエリを使用してコンピューティングインスタンスのトポロジを表示する

physical_host_topology メタデータキーにクエリを実行して、実行中のコンピューティングインスタンスの物理的なロケーションを表示するには、次のいずれかのオプションを選択します。

Linux インスタンス

Linux コンピューティングインスタンスに接続します。
Linux インスタンスから、curl ツールを使用してクエリを作成します。Linux インスタンスで physical_host_topology メタデータキーにクエリを実行するには、次のコマンドを実行します。
```
user@myinst:~$ curl -s -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology
```
出力は次のようになります。
- コンピューティングインスタンスのクラスタ、ブロック、サブブロック、ホストの ID を表示できる場合、出力は次のようになります。
```
{
  "cluster": "europe-west1-cluster-jfhb",
  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
  "subBlock": "0fc09525cbd5abd734342893ca1c083f",
  "host": "1215168a4ecdfb434fd4d28056589059"
}
```
- ホストの ID を公開した後にのみ表示できる場合、出力は次のようになります。
```
{
  "cluster": null,
  "block": null,
  "subBlock": null,
  "host": "1215168a4ecdfb434fd4d28056589059"
}
```

Windows インスタンス

Windows コンピューティングインスタンスに接続します。
Windows インスタンスから、Invoke-RestMethod コマンドを使用してクエリを作成します。Windows インスタンスで physical_host_topology メタデータキーにクエリを実行するには、次のコマンドを実行します。
```
PS C:\> 
$value = (Invoke-RestMethod `
        -Headers @{'Metadata-Flavor' = 'Google'} `
        -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology")
$value
```
出力は次のようになります。
- コンピューティングインスタンスのクラスタ、ブロック、サブブロック、ホストの ID を表示できる場合、出力は次のようになります。
```
{
  "cluster": "europe-west1-cluster-jfhb",
  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
  "subBlock": "0fc09525cbd5abd734342893ca1c083f",
  "host": "1215168a4ecdfb434fd4d28056589059"
}
```
- ホストの ID を公開した後にのみ表示できる場合、出力は次のようになります。
```
{
  "cluster": null,
  "block": null,
  "subBlock": null,
  "host": "1215168a4ecdfb434fd4d28056589059"
}
```

次のステップ

ホストイベントの管理方法を確認する。
- コンピューティングインスタンス間でホストイベントを管理する
- 予約間でホストイベントを管理する
コンピューティングインスタンスとクラスタをモニタリングする

コンピューティング インスタンスのトポロジを表示する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

コンソール

gcloud

REST

必要なロール

必要な権限

コンピューティング インスタンスのトポロジについて

コンピューティング インスタンスのトポロジを表示する

コンソール

gcloud

REST

メタデータキーのクエリを使用してコンピューティング インスタンスのトポロジを表示する

Linux インスタンス

Windows インスタンス

次のステップ

コンピューティングインスタンスのトポロジを表示する

コンピューティングインスタンスのトポロジについて

コンピューティングインスタンスのトポロジを表示する

メタデータキーのクエリを使用してコンピューティングインスタンスのトポロジを表示する