Melihat topologi instance komputasi

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

Setelah membuat instance 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 hubungannya satu sama lain. Jika Anda mengetahui kedekatan instance komputasi, Anda dapat menyesuaikan desain aplikasi atau workload untuk menjalankan tugas yang sensitif terhadap latensi pada instance komputasi yang paling berdekatan. Untuk semua jenis instance komputasi lainnya, Anda dapat melihat ID host tempat instance tersebut berjalan setelah Anda mengekspos ID host.

Sebelum memulai

  • Tinjau terminologi untuk topologi instance komputasi.

  • Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    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 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 Host fisik 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 sub-bidang yang dimiliki bersama oleh instance komputasi, makin berdekatan instance tersebut satu sama lain.

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

Melihat topologi instance komputasi

Untuk melihat lokasi fisik beberapa instance komputasi yang sedang 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 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, maka outputnya mirip dengan berikut:

    ---
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 compute 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, 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": "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 Anda 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 menyempurnakan daftar instance komputasi, edit ekspresi filter dalam parameter kueri filter.

Melihat topologi instance komputasi dengan kueri kunci metadata

Untuk melihat lokasi fisik instance komputasi yang sedang 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, outputnya 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, maka 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, outputnya 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, maka outputnya akan mirip dengan berikut ini:

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

Langkah berikutnya