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 susunannya untuk memverifikasi instance mana yang paling berdekatan satu sama lain. 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.

  • 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 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 mengueri 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 pemesanan, lihat Melihat topologi pemesanan.

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

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

    Buka instance VM

  2. Di kolom Nama, klik nama instance yang ingin Anda lihat detailnya. Halaman yang memberikan detail instance 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.

  • 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 dalam parameter kueri filter.

Melihat topologi instance komputasi dengan membuat kueri kunci metadata

Untuk melihat lokasi fisik instance komputasi yang sedang berjalan dengan membuat kueri 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:

    {
  "cluster": "europe-west1-cluster-jfhb",
  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
  "subBlock": "1fc18636cbd4abd623553784ca2c174e",
  "host": "2326279b5ecdfc545fd5e39167698168"
}

Instance Windows

  1. Hubungkan ke instance komputasi Windows Anda.

  2. Dari instance Windows, buat kueri menggunakan 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:

    {
  "cluster": "europe-west1-cluster-jfhb",
  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
  "subBlock": "1fc18636cbd4abd623553784ca2c174e",
  "host": "2326279b5ecdfc545fd5e39167698168"
}

Langkah berikutnya