Melihat topologi instance komputasi

Dokumen ini menjelaskan cara melihat lokasi fisik instance Compute Engine A4X Max, A4X, A4, A3 Ultra, A3 Mega, dan A3 High (8 GPU) yang berjalan di blok kapasitas yang dicadangkan.

Setelah membuat instance A4X Max, A4X, A4, A3 Ultra, A3 Mega, dan A3 High (8 GPU), Anda dapat melihat penataannya untuk memverifikasi instance mana yang paling berdekatan. Dengan memahami kedekatan instance, Anda dapat melakukan hal berikut:

Sesuaikan desain aplikasi atau workload Anda untuk lebih meminimalkan latensi jaringan.
Memecahkan masalah latensi atau performa jaringan instance yang sering berkomunikasi, jika instance tersebut berada di lokasi yang berjauhan secara tidak terduga.

Sebelum memulai

Tinjau terminologi yang digunakan dalam fitur Cluster Director.
Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
REST

Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat topologi instance Compute, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat topologi instance komputasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat topologi instance komputasi:

Untuk melihat detail instance: compute.instances.get pada project
Untuk melihat daftar instance: compute.instances.list pada project

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Memahami topologi instance komputasi

Saat melihat detail instance komputasi yang sedang berjalan, Anda dapat memahami lokasi fisiknya dalam cluster dengan memeriksa kolom Host fisik (untuk konsol Google Cloud ), atau kolom physicalHostTopology (untuk gcloud CLI, Compute Engine API, atau dengan mengkueri kunci metadata). Kolom ini berisi sub-kolom berikut:

cluster: nama global cluster.
block: ID khusus organisasi dari blok yang dipesan tempat instance berada.
sub-block: ID khusus organisasi dari sub-blok tempat instance berada.
host: ID khusus organisasi dari host tempat instance berjalan.

Untuk memahami kedekatan instance, bandingkan nilai kolom Host fisik atau physicalHostTopology antar-instance. Semakin banyak sub-kolom yang dimiliki bersama oleh instance, semakin dekat lokasi fisiknya.

Anda juga dapat melihat topologi pemesanan tempat instance komputasi dibuat. Kolom physicalHostTopology pemesanan dan instance menampilkan kolom block dan cluster yang sama. Misalnya, saat melihat blok yang dicadangkan tertentu, Anda dapat melihat nama dan sub-blok semua instance yang di-deploy di blok tersebut. Untuk mengetahui informasi selengkapnya tentang topologi reservasi, lihat Melihat topologi reservasi.

Melihat topologi instance compute

Untuk melihat lokasi fisik beberapa instance komputasi yang sedang berjalan sekaligus, gunakan REST API. Jika tidak, pilih salah satu opsi berikut:

Konsol

Di konsol Google Cloud , buka halaman VM instances.

Buka instance VM
Di kolom Name, klik nama instance yang ingin Anda lihat detailnya. Halaman yang memberikan detail instance akan muncul dan tab Details dipilih.
Di bagian Basic information, periksa nilai kolom Physical host.

gcloud

Untuk melihat lokasi fisik instance komputasi yang sedang berjalan, gunakan perintah gcloud compute instances describe dengan flag --flatten=resourceStatus.physicalHostTopology:

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

Ganti kode berikut:

INSTANCE_NAME: nama instance.
ZONE: zona tempat instance berada.

Outputnya mirip dengan hal berikut ini:

---
cluster: europe-west1-cluster-jfhb
block: 3e3056e23cf91a5cb4a8621b6a52c100
subBlock: 0fc09525cbd5abd734342893ca1c083f
host: 1215168a4ecdfb434fd4d28056589059

REST

Untuk melihat lokasi fisik instance komputasi yang sedang berjalan, buat salah satu permintaan GET berikut. Saat membuat permintaan, Anda harus menyertakan parameter kueri fields dan menentukan untuk hanya menampilkan kolom name, machineType, dan physicalHostTopology dari sebuah instance. Anda juga harus menyertakan parameter kueri filter dan menentukan untuk hanya mencantumkan instance yang sedang berjalan.

Untuk melihat daftar instance Anda di semua zona: metode 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

Untuk melihat daftar instance Anda di zona tertentu: Metode 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

Ganti kode berikut:

PROJECT_ID: ID project tempat instance berada.
ZONE: zona tempat instance berada.

Outputnya mirip dengan hal berikut ini:

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

Jika Anda ingin menyaring daftar instance, edit ekspresi filter di parameter kueri filter.