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.
  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

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

    Konsol

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

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init
    2. Menetapkan 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 initialize dengan menjalankan perintah berikut: 

      gcloud init

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 langkah 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 gsutil tool, atau, di Konsol Google Cloud, dari halaman Cloud Storage:

    Buka Storage

Langkah selanjutnya