Mengumpulkan informasi proses debug menggunakan sosreport

Container-Optimized OS menyertakan utilitas sosreport, yang mengumpulkan informasi sesuai permintaan untuk membantu Anda men-debug masalah di instance virtual machine Container-Optimized OS. Informasi dikumpulkan dan disimpan secara lokal di sistem file instance. Google tidak mengumpulkan atau menyimpan data ini di tempat lain.

Jika Anda membuka kasus dukungan dengan dukungan Google Cloud karena masalah pada instance, Anda mungkin akan diminta untuk memberikan data sosreport sebagai bagian dari penyelidikan. Halaman ini menunjukkan cara mengumpulkan informasi ini.

Catatan: Membuat laporan akan menggunakan resource CPU dan memori, serta menyimpan laporan akan menggunakan kapasitas disk dan resource bandwidth I/O disk di node. Jumlah resource yang digunakan tidak dapat diperkirakan dengan mudah.

Catatan: Saat memecahkan masalah ketersediaan node dan masalah startup, mengumpulkan sosreport mungkin sulit. Perbaikan otomatis node akan menghentikan dan membuat ulang node setelah beberapa waktu tidak tersedia. Lihat Menonaktifkan perbaikan otomatis node jika pengumpulan sosreport tidak dapat dilakukan sebelum node dihentikan oleh perbaikan otomatis. Jika perbaikan otomatis tidak dapat dinonaktifkan karena cluster berada di saluran rilis, hubungi Cloud Customer Care untuk mendapatkan bantuan.

Output sosreport disimpan tanpa enkripsi dalam arsip .tar.xz. Arsip tersebut mungkin berisi informasi identitas pribadi (PII), karena mengumpulkan data dari banyak komponen sistem penting (misalnya, journald). Arsip dapat diperiksa di instance, dan sebagian besar konten dalam teks biasa. Alat sosreport adalah open source, dan Anda dapat meninjau kodenya.

Mengumpulkan data sosreport

Untuk membuat laporan, gunakan ssh ke instance virtual machine yang relevan menggunakan perintah gcloud compute ssh:

gcloud compute ssh [INSTANCE_NAME]

Kemudian, jalankan perintah sosreport berikut:

sudo sos report --all-logs --batch --tmp-dir=/var

Catatan: Untuk Container-Optimized OS 85 dan versi yang lebih lama, sosreport dapat dikumpulkan menggunakan perintah sudo sosreport --all-logs --batch --tmp-dir=/var

Anda dapat mengubah direktori tempat laporan disimpan dengan meneruskan direktori lain ke opsi --tmp-dir. Anda juga dapat mengubah perilaku default perintah dengan mengedit /etc/sos.conf pada instance.

Output disimpan dalam file .tar.xz di direktori yang Anda tentukan menggunakan opsi --tmp-dir. Lokasi dan checksum file .tar.xz ditampilkan di STDOUT.

Your sosreport has been generated and saved in:
  /var/sosreport-cos-20181106231224.tar.xz

The checksum is: 5a8b97c6020346a688254c8b04ef86ec

Melihat data yang dikumpulkan

Laporan dimiliki oleh root dan tidak dapat dibaca oleh pengguna lain. Gunakan perintah berikut untuk mengubah pemilik menjadi pengguna saat ini dan membuatnya dapat dibaca oleh Anda. Jangan membuatnya dapat dibaca semua orang.

TARBALL=[PATH/TO/TARBALL]
sudo chown $(whoami) $TARBALL
chmod +r $TARBALL

Kemudian, jika ingin melihat konten laporan di node, Anda dapat mengekstraknya dengan menjalankan perintah di bawah ini:

tar xvf $TARBALL

Setiap file laporan kini tersedia di direktori di lokasi yang sama dengan .tar.xz. Anda dapat melihat log menggunakan perintah seperti less, atau Anda dapat menggunakan perintah seperti grep untuk menemukan informasi di dalamnya.

Catatan: Jika Anda berencana membagikan laporan kepada Google, jangan ubah file apa pun dalam laporan. Jika Anda harus mengubah beberapa file, beri tahu kami juga apa yang diubah saat membagikan laporan.

Download laporannya

Untuk mendownload laporan ke komputer lokal, gunakan perintah gcloud compute scp:

gcloud compute scp $(whoami)@[INSTANCE_NAME]:[PATH/TO/FILE] [LOCAL/PATH/TO/DIRECTORY]