Mengumpulkan informasi diagnostik

Dokumen ini menjelaskan cara mengumpulkan informasi tentang instance virtual machine (VM) menggunakan alat diagnostik. Gunakan informasi yang dikumpulkan alat tersebut untuk membantu pemecahan masalah dasar sebelum menghubungi Dukungan.

Alat ini akan melakukan hal berikut:

  • Mengumpulkan informasi hanya dari VM yang Anda tentukan.

  • Menyimpan informasi hanya di project Anda.

  • Menyimpan informasi selama 10 hari di bucket Cloud Storage, yang secara default hanya dapat diakses oleh Anda.

Sebelum membagikan informasi yang dikumpulkan kepada Dukungan Google, lakukan hal berikut:

  1. Tinjau informasi tersebut untuk menemukan informasi rahasia atau identitas pribadi (PII).

  2. Hapus atau samarkan informasi tersebut jika diperlukan.

Informasi diagnostik yang dikumpulkan dari VM

Alat diagnostik ini mengumpulkan informasi tentang hal berikut:

Untuk informasi mendetail tentang cara Compute Engine mengumpulkan informasi ini, lihat repositori publik.

Batasan

  • Anda hanya dapat mengumpulkan informasi diagnostik dari VM yang dibuat berdasarkan Windows Server.

Sebelum memulai

  • Compute Engine secara default menginstal alat diagnostik pada image Windows Server versi publik yang lebih baru daripada v20190714. Atau, jika versi image Windows Server Anda lebih lama daripada v20190714, atau Anda menggunakan image kustom, instal alat tersebut menggunakan perintah googet install google-compute-engine-diagnostics.
  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    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

    1. Menginstal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

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

    2. Set a default region and zone.

    REST

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

      Menginstal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      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 .

Mengumpulkan informasi diagnostik dari VM

Jalankan alat diagnostik secara langsung dari VM, atau secara jarak jauh menggunakan Google Cloud CLI. Pada VM berbasis Windows, temukan alat diagnostik ini di direktori C:\Program Files\Google\Compute Engine\diagnostics.

Izin yang diperlukan untuk tugas ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

  • roles/iam.serviceAccountTokenCreator pada project

gcloud

  1. Berikan peran iam.serviceAccountTokenCreator pada project:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member user:EMAIL \
    --role roles/iam.serviceAccountTokenCreator

    Ganti kode berikut:

    • PROJECT_ID: project ID
    • EMAIL: alamat email untuk memberikan peran iam.serviceAccountTokenCreator

  2. Ekspor informasi diagnostik sebagai objek ke bucket Cloud Storage.

    gcloud compute diagnose export-logs VM_NAME \
  [--collect-process-traces]

    Flag --collect-process-traces (opsional) menentukan apakah alat diagnostik mengumpulkan trace 10 menit untuk sistem yang sedang berjalan, yang mencakup CPU, disk, file, dan aktivitas jaringan. Pada VM berbasis Windows, tindakan ini menggunakan Windows Performance Recorder.

    Ganti kode berikut:

    • VM_NAME: nama VM dari mana informasi diagnostik akan dikumpulkan

  3. Proses ekspor log mungkin memerlukan waktu beberapa menit. Lihat statusnya menggunakan perintah gcloud compute instances get-serial-port-output.

  4. Compute Engine memformat nama bucket yang berisi informasi diagnostik sebagai diagnostic_logs_project_PROJECT_NUMBER. Lihat atau download bucket menggunakan gcloud CLI, atau, di Google Cloud konsol, dari halaman Cloud Storage:

    Buka Storage

Langkah berikutnya