Melihat topologi instance komputasi

Dokumen ini menjelaskan cara melihat lokasi fisik, yang juga dikenal sebagai topologi, instance Compute Engine Anda di suatu zona. Untuk melihat topologi cluster di Cluster Director, lihat Melihat topologi cluster.

Setelah membuat instance A5X, A4X Max, A4X, A4, A3 Ultra, A3 Mega, dan A3 High (8 GPU) atau instance komputasi yang menentukan kebijakan penempatan rapat atau kebijakan workload, Anda dapat melihat lokasi fisik instance komputasi Anda dalam kaitannya satu sama lain. Jika mengetahui kedekatan instance komputasi, Anda dapat menyesuaikan desain aplikasi atau workload untuk menjalankan tugas yang sensitif terhadap latensi pada instance komputasi yang paling dekat satu sama lain. Untuk semua jenis instance komputasi lainnya, Anda dapat melihat ID host tempat instance tersebut berjalan setelah Anda mengekspos ID host.

Sebelum memulai

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat topologi instance komputasi, 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 komputasi: compute.instances.get pada project
  • Untuk melihat daftar instance komputasi: compute.instances.list pada project

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

Memahami topologi instance komputasi

Untuk memahami lokasi fisik instance komputasi dalam cluster, periksa kolom Physical host di konsol Google Cloud . Jika Anda menggunakan gcloud CLI, Compute Engine API, atau kueri kunci metadata, periksa kolom physicalHostTopology. 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 di antara instance komputasi. Makin banyak subkolom yang digunakan bersama oleh instance komputasi, makin dekat jaraknya satu sama lain.

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

Melihat topologi instance komputasi

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

Konsol

  1. Di konsol Google Cloud , buka halaman VM instances.

    Buka instance VM

  2. Di kolom Name, klik nama instance komputasi yang ingin Anda lihat detailnya. Halaman yang memberikan detail instance komputasi akan muncul dan tab Details akan dipilih.

  3. 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 komputasi.

  • ZONE: zona tempat instance komputasi berada.

Outputnya mirip dengan hal berikut ini:

  • Jika Anda dapat melihat ID cluster, blok, sub-blok, dan host instance komputasi, output-nya akan mirip dengan berikut ini:

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

  • Jika Anda hanya dapat melihat ID host setelah mengeksposnya, output-nya akan mirip dengan berikut ini:

    ---
cluster: null
block: null
subBlock: null
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 instance komputasi. Anda juga harus menyertakan parameter kueri filter dan menentukan untuk hanya mencantumkan instance komputasi 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 komputasi berada.

  • ZONE: zona tempat instance komputasi berada.

Outputnya mirip dengan hal berikut ini:

  • Jika Anda dapat melihat ID cluster, blok, sub-blok, dan host instance komputasi Anda, output-nya akan mirip dengan 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 hanya dapat melihat ID instance komputasi host setelah mengeksposnya, outputnya akan mirip dengan 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": 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"
        }
      }
    },
    ...
  ]
}

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

Melihat topologi instance komputasi dengan kueri kunci metadata

Untuk melihat lokasi fisik instance komputasi yang berjalan dengan kueri ke kunci metadata physical_host_topology, pilih salah satu opsi berikut:

Instance Linux

  1. Hubungkan ke instance komputasi Linux Anda.

  2. Dari instance Linux, buat kueri menggunakan alat curl. Untuk membuat kueri kunci metadata physical_host_topology di instance Linux, jalankan perintah berikut:

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

    Outputnya mirip dengan hal berikut ini:

    • Jika Anda dapat melihat ID cluster, blok, sub-blok, dan host instance komputasi, output-nya akan mirip dengan berikut ini:

      {
  "cluster": "europe-west1-cluster-jfhb",
  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
  "subBlock": "0fc09525cbd5abd734342893ca1c083f",
  "host": "1215168a4ecdfb434fd4d28056589059"
}

    • Jika Anda hanya dapat melihat ID host setelah mengeksposnya, outputnya akan mirip dengan berikut ini:

      {
  "cluster": null,
  "block": null,
  "subBlock": null,
  "host": "1215168a4ecdfb434fd4d28056589059"
}

Instance Windows

  1. Hubungkan ke instance komputasi Windows Anda.

  2. Dari instance Windows, buat kueri dengan perintah Invoke-RestMethod. Untuk membuat kueri kunci metadata physical_host_topology di instance Windows, jalankan perintah berikut:

    PS C:\> 
$value = (Invoke-RestMethod `
        -Headers @{'Metadata-Flavor' = 'Google'} `
        -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology")
$value

    Outputnya mirip dengan hal berikut ini:

    • Jika Anda dapat melihat ID cluster, blok, sub-blok, dan host instance komputasi, output-nya akan mirip dengan berikut ini:

      {
  "cluster": "europe-west1-cluster-jfhb",
  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
  "subBlock": "0fc09525cbd5abd734342893ca1c083f",
  "host": "1215168a4ecdfb434fd4d28056589059"
}

    • Jika Anda hanya dapat melihat ID host setelah mengeksposnya, outputnya akan mirip dengan berikut ini:

      {
  "cluster": null,
  "block": null,
  "subBlock": null,
  "host": "1215168a4ecdfb434fd4d28056589059"
}

Langkah berikutnya