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 layanan Google Cloud 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 konsol Google Cloud untuk mengakses layanan dan API Google Cloud , 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 guna menjalankan alat diagnostik menggunakan Google Cloud CLI, minta administrator untuk memberi Anda peran IAM Service Account Token Creator (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.

Untuk melampirkan informasi diagnostik ke kasus dukungan, Anda juga memerlukan peran Tech Support Editor (roles/cloudsupport.techSupportEditor).

Mengumpulkan informasi diagnostik dari VM

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

gcloud

  1. Jika Anda belum melakukannya, berikan peran iam.serviceAccountTokenCreator pada 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.

    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 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 konsolGoogle Cloud , 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: menangkap informasi pelacakan tambahan. Alat ini merekam trace sistem selama 10 menit menggunakan Windows Performance Recorder, yang mencakup aktivitas CPU, disk, file, dan jaringan.

Melampirkan informasi diagnostik ke kasus dukungan

Jika Anda memiliki kasus terbuka dengan Cloud Customer Care, Anda dapat melampirkan informasi diagnostik langsung ke kasus tersebut saat mengumpulkannya. Dengan opsi ini, Anda tidak perlu mendownload arsip dari Cloud Storage dan melampirkannya sendiri ke kasus.

Informasi diagnostik dilampirkan ke kasus tanpa langkah peninjauan. Jika Anda perlu meninjau informasi atau menghapus informasi rahasia atau informasi identitas pribadi (PII) sebelum membagikannya, jangan gunakan opsi ini. Sebagai gantinya, kumpulkan informasi seperti yang dijelaskan dalam Mengumpulkan informasi diagnostik dari VM, tinjau arsip di Cloud Storage, lalu lampirkan ke kasus.

Sebelum Anda melampirkan informasi diagnostik ke kasus dukungan, pastikan:

  • Organisasi Anda memiliki paket layanan pelanggan yang memungkinkan Anda membuat kasus dukungan teknis (Dukungan Standard, Enhanced, atau Premium).
  • Anda memiliki peran Tech Support Editor (roles/cloudsupport.techSupportEditor). Jika kasus tersebut milik organisasi, Anda memerlukan peran di organisasi tersebut.
  • Cloud Support API diaktifkan dalam project.
  • Kasus ini terbuka.

Untuk melampirkan informasi diagnostik ke kasus dukungan, lakukan hal berikut:

  1. Pastikan Anda telah menginstal komponen perintah alfa:

    gcloud components install alpha

  2. Jalankan perintah gcloud alpha compute diagnose export-logs dengan flag --support-case:

    gcloud alpha compute diagnose export-logs INSTANCE_NAME \
    --zone=ZONE \
    --support-case=CASE_NUMBER

    Ganti kode berikut:

    • INSTANCE_NAME: nama instance komputasi Windows Server.
    • ZONE: zona instance.
    • CASE_NUMBER: nomor kasus dukungan yang terbuka.

    Perintah ini akan memeriksa apakah kasus tersebut ada dan apakah Anda dapat menambahkan lampiran ke kasus tersebut sebelum mulai mengumpulkan. Kemudian, alat ini akan menunggu instance selesai mengumpulkan informasi diagnostik, yang mungkin memerlukan waktu beberapa menit, dan mengupload arsip ke kasus. Arsip juga tetap berada di bucket Cloud Storage, sama seperti saat Anda menghilangkan flag --support-case.

Langkah berikutnya