Melihat topologi instance Compute Engine

Dokumen ini menjelaskan cara melihat topologi instance Compute Engine yang sedang berjalan. Setelah membuat dan memulai instance komputasi, Anda dapat melihat lokasi fisiknya di zona untuk memahami topologi cluster. Informasi ini membantu Anda melakukan hal berikut:

  • Mengatur tugas: Anda dapat menyesuaikan desain beban kerja untuk, misalnya, menempatkan tugas yang memerlukan komunikasi intensif pada instance komputasi yang secara fisik paling dekat.

  • Memecahkan masalah: Anda dapat menyelidiki masalah latensi atau performa jaringan jika instance komputasi tertentu ternyata ditempatkan berjauhan.

Untuk memverifikasi instance komputasi mana yang berjalan di project Anda, lihat daftar instance komputasi.

Batasan

Anda hanya dapat melihat topologi instance komputasi yang memenuhi satu atau beberapa persyaratan berikut:

Memahami topologi instance komputasi

Setiap instance komputasi berjalan di server fisik, host, yang berada di blok server. Setiap blok termasuk dalam cluster, yang berada di pusat data dalam Cloud de Confiance zona. Saat melihat instance komputasi yang memenuhi persyaratan tertentu, Anda dapat memahami topologinya dalam kaitannya dengan instance komputasi lain yang memenuhi persyaratan yang sama. Secara khusus, Anda dapat memahami lokasi fisik instance komputasi dengan memeriksa sub-kolom berikut di kolom physicalHostTopology setiap instance komputasi:

  • Cluster (cluster): nama global cluster tempat instance komputasi Anda berada. Cluster adalah pengelompokan logis tingkat tinggi dari beberapa host, yang dapat mencakup beberapa blok, yang bekerja sama sebagai satu kumpulan resource.

  • Blok (block): ID spesifik per organisasi dari blok tempat instance komputasi Anda berada. Blok adalah kumpulan beberapa host yang dikelompokkan bersama. Instance komputasi dalam blok yang sama mengalami latensi jaringan yang rendah.

  • Sub-block (subBlock): ID khusus organisasi dari sub-blok tempat instance komputasi Anda berada. Sub-blok adalah sub-pembagian fisik dalam blok, yang mengelompokkan host dalam satu penutup fisik. Instance Compute di sub-blok yang sama akan mengalami latensi jaringan yang lebih rendah daripada instance Compute di blok yang sama.

  • Host (host): ID khusus organisasi dari host tempat instance komputasi Anda berada. Host adalah satu server fisik tempat instance komputasi Anda berjalan. Setiap host memiliki vCPU fisik, memori, penyimpanan, dan kartu antarmuka jaringan (NIC) sendiri. Instance komputasi di host yang berdekatan akan mengalami latensi jaringan serendah mungkin.

Semakin banyak sub-bidang yang dimiliki bersama oleh dua instance komputasi yang sedang berjalan, semakin dekat jarak fisik keduanya. Informasi ini membantu Anda mengoptimalkan workload dengan mengatur tugas sehingga Anda dapat meminimalkan latensi jaringan, atau dengan mendesain sistem yang lebih tangguh.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Cloud de Confiance by S3NS dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

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

    Konsol

    Saat menggunakan konsol Cloud de Confiance untuk mengakses layanan Cloud de Confiance by S3NS dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init
  • Tetapkan region dan zona default.
  • 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, lalu login ke gcloud CLI dengan identitas gabungan Anda.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Cloud de Confiance .

Peran yang diperlukan

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

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

Izin yang diperlukan

Izin berikut diperlukan untuk memverifikasi topologi instance komputasi Anda:

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

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

Memverifikasi topologi instance komputasi

Untuk memverifikasi topologi instance komputasi yang sedang berjalan, gunakan salah satu metode berikut:

Memverifikasi topologi instance komputasi menggunakan konsol Cloud de Confiance , gcloud CLI, atau REST

Untuk melihat topologi beberapa instance komputasi secara bersamaan, gunakan REST API. Jika tidak, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Cloud de Confiance , buka halaman VM instances.

    Buka instance VM

  2. Di kolom Name, klik nama instance Compute 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 topologi 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 Compute.

  • ZONE: zona tempat instance komputasi berada.

Outputnya mirip dengan hal berikut ini:

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

REST

Untuk melihat topologi 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 yang berikut ini. Dalam contoh berikut, instance compute vm-01 dan vm-02 berada di blok yang sama.

{
  "items": [
    {
      "name": "vm-01",
      "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
      "resourceStatus": {
        "physicalHostTopology": {
          "block": "3e3056e23cf91a5cb4a8621b6a52c100",
          "cluster": "europe-west1-cluster-jfhb",
          "host": "1215168a4ecdfb434fd4d28056589059",
          "subBlock": "0fc09525cbd5abd734342893ca1c083f"
        }
      }
    },
    {
      "name": "vm-02",
      "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
      "resourceStatus": {
        "physicalHostTopology": {
          "block": "3e3056e23cf91a5cb4a8621b6a52c100",
          "cluster": "europe-west1-cluster-jfhb",
          "host": "2326279b5ecdfc545fd5e39167698168",
          "subBlock": "1fc18636cbd4abd623553784ca2c174e"
        }
      }
    },
    ...
  ]
}

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

Memverifikasi topologi instance komputasi dengan membuat kueri kunci metadata

Untuk melihat topologi instance komputasi yang sedang berjalan dengan membuat kueri kunci metadata physical_host_topology, pilih salah satu opsi berikut:

Instance Linux

  1. Hubungkan ke instance Linux Anda.

  2. Buat kueri kunci metadata physical_host_topology menggunakan curl:

    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:

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

Instance Windows

  1. Hubungkan ke instance Windows Anda.

  2. Buat kueri kunci metadata physical_host_topology menggunakan perintah Invoke-RestMethod:

    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:

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

Langkah berikutnya