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 Cloud Customer Care.

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 Layanan Pelanggan, lakukan hal berikut:

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

  2. Hapus atau samarkan informasi tersebut jika diperlukan.

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 memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau contoh 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 Google Cloud konsol untuk mengakses Google Cloud layanan dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal 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 .

  • Tetapkan region dan zona default.

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 GitHub publik.

Batasan

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menjalankan alat diagnostik menggunakan Google Cloud CLI, minta administrator untuk memberi Anda peran IAM Pembuat Token Akun Layanan (roles/iam.serviceAccountTokenCreator) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mengumpulkan informasi diagnostik dari VM

Jalankan alat diagnostik secara langsung dari VM, atau secara jarak jauh menggunakan Google Cloud CLI.

gcloud

  1. Jika belum, berikan peran iam.serviceAccountTokenCreator di project ke akun pengguna atau akun layanan yang akan menjalankan perintah gcloud compute diagnose export-logs:

    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 menggunakan perintah diagnose export-logs command.

    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 VM_NAME dengan nama VM yang akan dikumpulkan informasi diagnostiknya.

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

  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 Penyimpanan

Secara lokal (khusus Windows)

Untuk menjalankan alat diagnostik dari dalam VM Windows, lakukan hal berikut:

  1. Hubungkan ke VM Windows.

  2. Buka jendela command prompt atau PowerShell dengan hak istimewa Administrator.

  3. Buka direktori yang berisi alat diagnostik:

    cd "C:\Program Files\Google\Compute Engine\diagnostics"

  4. Jalankan alat diagnostik:

    .\diagnostics.exe

    Setelah selesai berjalan, alat ini akan menyimpan informasi diagnostik yang dikumpulkan ke file terkompresi logs.zip di direktori kerja Anda saat ini.

Flag opsional

  • -trace: mengambil informasi pelacakan tambahan. Alat ini mengambil trace sistem selama 10 menit menggunakan Windows Performance Recorder, yang mencakup CPU, disk, file, dan aktivitas jaringan.

Langkah berikutnya