Melihat output port serial


Instance virtual machine (VM) memiliki empat port serial virtual. Sistem operasi instance, BIOS, dan entitas level sistem lainnya sering menulis output ke port serial, sehingga output port serial berguna untuk memecahkan masalah error, booting gagal, masalah startup, atau masalah shutdown.

Halaman ini menjelaskan metode untuk melihat output port serial, termasuk menggunakan Cloud Logging untuk mempertahankan output port serial bahkan setelah instance dihentikan atau dihapus. Jika Anda perlu mengirim perintah ke port serial saat instance sedang berjalan, lihat Berinteraksi dengan konsol serial.

Output port serial dapat diakses melalui Google Cloud Console, gcloud CLI, dan REST, tetapi hanya saat instance VM berjalan. Log dibatasi hingga 1 MB output terbaru per port.

Jika Anda mengaktifkan logging output port serial, Cloud Logging akan menyediakan logging 50 gigabyte (GiB) pertama per bulan secara gratis dan mempertahankan log selama 30 hari.

Sebelum memulai

  • Jika ingin mencatat output port serial ke dalam log di Cloud Logging, pahami Cloud Logging.
  • 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

Mengaktifkan dan menonaktifkan logging output port serial

Anda dapat mengontrol apakah instance Anda mengirim output port serial ke Cloud Logging dengan menetapkan metadata level project atau instance. Anda juga dapat menonaktifkan fitur ini untuk semua pengguna di organisasi dengan menyetel kebijakan organisasi.

Menetapkan metadata project dan instance

Secara default, logging output port serial ke Cloud Logging dinonaktifkan. Jika logging output port serial ke Cloud Logging tidak dibatasi untuk organisasi Anda, Anda dapat mengaktifkan atau menonaktifkannya untuk project dan setiap instance VM dengan menetapkan entri metadata serial-port-logging-enable ke true atau false.

Jika Anda menetapkan entri metadata di seluruh project, semua instance VM dalam project akan mewarisi setelan tersebut secara implisit. Jika Anda menetapkan entri metadata instance, entri metadata tersebut hanya akan diaktifkan untuk VM tersebut, terlepas dari setelan project.

Anda dapat menetapkan entri metadata menggunakan konsol Google Cloud, gcloud CLI, atau Compute Engine API. Untuk mengetahui informasi lebih lanjut, lihat Menyetel metadata kustom.

Misalnya, perintah gcloud CLI berikut memungkinkan logging output port serial ke Cloud Logging untuk project Anda:

gcloud compute project-info add-metadata \
    --metadata serial-port-logging-enable=true

Demikian pula, perintah gcloud CLI berikut memungkinkan logging output port serial ke Cloud Logging untuk instance tertentu:

gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata serial-port-logging-enable=true

Untuk menonaktifkan logging output port serial ke Cloud Logging, tetapkan serial-port-logging-enable ke false:

gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata serial-port-logging-enable=false

Filter pengecualian

Dari dalam Cloud Logging, Anda dapat membuat filter pengecualian untuk menghapus entri port serial tertentu dari Logs Explorer. Misalnya, dengan entri metadata tingkat project yang ditetapkan ke serial-port-logging-enable=true, Anda dapat menonaktifkan logging output port serial untuk instance VM tertentu menggunakan filter lanjutan:

logName = "projects/PROJECT_ID/logs/serialconsole.googleapis.com%2Fserial_port_1_output"
resource.type = "gce_instance"
resource.labels.instance_id != "INSTANCE_1_ID"
resource.labels.instance_id != "INSTANCE_2_ID"

Menetapkan kebijakan organisasi

Anda dapat menonaktifkan logging output port serial ke Cloud Logging untuk seluruh organisasi dengan menetapkan Kebijakan Organisasi, yang membatasi konfigurasi tertentu resource Google Cloud. Secara khusus, tetapkan batasan boolean berikut: constraints/compute.disableSerialPortLogging. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola kebijakan organisasi.

Menonaktifkan logging port serial dengan menetapkan constraints/compute.disableSerialPortLogging ke true tidak berlaku. Instance VM yang ada dengan entri metadata yang memungkinkan logging port serial ke Cloud Logging akan terus dicatat ke Cloud Logging, kecuali jika Anda mereset metadata untuk instance tersebut.

Setelah menetapkan batasan organisasi ini ke true, Anda tidak dapat menetapkan metadata instance atau project untuk mengaktifkan logging output port serial ke Cloud Logging untuk instance apa pun dalam organisasi.

Melihat output port serial

Konsol

  1. Di Konsol Google Cloud, buka halaman VM instances.

    Buka halaman instance VM

  2. Pilih instance VM yang ingin Anda lihat output port serialnya.

  3. Di bagian Log, klik Port serial 1, 2, 3, atau 4. Entitas level sistem biasanya menggunakan port serial pertama (port 1), yang juga dikenal sebagai konsol serial.

gcloud

Gunakan perintah gcloud compute instances get-serial-port-output.

gcloud compute instances get-serial-port-output INSTANCE_NAME \
  --port PORT \
  --start START \
  --zone ZONE

Ganti kode berikut:

  • INSTANCE_NAME: nama instance.
  • PORT: jumlah port (1, 2, 3, atau 4) yang ingin Anda lihat output-nya. Entity level sistem biasanya menggunakan port serial pertama (port 1), yang juga dikenal sebagai konsol serial. Secara default, output port serial pertama akan ditampilkan.
  • START: indeks byte (berbasis nol) dari byte pertama yang ingin Anda tampilkan. Gunakan flag ini jika Anda ingin terus mendapatkan output dari permintaan sebelumnya yang terlalu panjang untuk ditampilkan dalam satu kali percobaan.
  • ZONE: zona instance Anda.

REST

Di API, buat permintaan get ke metode instances.getSerialPortOutput.

GET https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/serialPort

Cloud Logging

  1. Aktifkan logging port serial ke Cloud Logging.
  2. Buka halaman Instance VM.

    Buka halaman instance VM

  3. Pilih instance VM dengan log agen startup yang ingin Anda lihat.

  4. Di bagian Log, klik Cloud Logging untuk melihat log Cloud Logging.

    Klik Cloud Logging untuk melihat log
Cloud Logging.

  5. Luaskan menu drop-down Semua log lalu pilih output port serial yang ingin Anda lihat. Entitas level sistem biasanya menggunakan port serial pertama (port 1), yang juga dikenal sebagai konsol serial. Jika port tidak muncul di menu drop-down, berarti port tersebut tidak memiliki output yang tersedia.

  6. Secara opsional, luaskan menu drop-down Level log mana pun untuk menonaktifkan log yang berada di bawah level keparahan yang ingin Anda lihat. Misalnya, jika memilih level log "Info", Anda akan membisukan entri log "Debug". Entri "Debug" biasanya hanya digunakan oleh BIOS saat booting.

Untuk informasi lebih lanjut, termasuk informasi tentang pemfilteran, lihat Menggunakan Logs Explorer.

Menangani karakter non-UTF8

Output port serial di-escape dengan menggunakan metode CHexEscape() library C++ Abseil open source, sehingga karakter non-UTF8 dienkode sebagai string heksadesimal. Anda dapat menggunakan metode CUnescape() yang sesuai untuk mendapatkan output yang tepat yang dikirim ke port serial.

Error port serial umum

Berikut adalah contoh error umum yang mungkin Anda temui dalam output port serial.

Terjadi error saat mengonfigurasi IPv6

Error berikut mungkin terjadi di log jurnal OS saat IPv6 tidak dikonfigurasi:

ERROR addresses.go:301 Error configuring IPv6: Internet Systems Consortium DHCP Client 4.2.5

Abaikan error ini. Error ini tidak memengaruhi VM Anda.