Saat Anda menggunakan VM Extension Manager untuk mengelola ekstensi di instance Compute Engine (VM), agen tamu di setiap VM mencatat peristiwa tentang penerapan ekstensi. Gunakan Cloud Logging untuk melihat log ini di Logs Explorer guna memantau dan memecahkan masalah ekstensi VM Anda.
Sebelum memulai
- Baca dokumentasi VM Extension Manager.
- Baca cara menggunakan Logs Explorer.
-
Siapkan autentikasi jika Anda belum melakukannya.
Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan
kode atau sampel 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 Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.
gcloud
-
Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud initJika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
-
- Tetapkan 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.
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Melihat log ekstensi VM
Untuk melihat log ekstensi VM, gunakan konsol Google Cloud , Google Cloud CLI, atau REST.
Konsol
- Di konsol Google Cloud , buka halaman Logs Explorer.
Di kolom Query, masukkan kueri berikut:
resource.type="gce_instance" resource.labels.instance_id="INSTANCE_ID" jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" jsonPayload.extensionName="EXTENSION_NAME" timestamp >= START_TIME timestamp <= END_TIMEGanti kode berikut:
INSTANCE_ID: ID instance VM.EXTENSION_NAME: nama ekstensi (misalnya,ops-agent).START_TIME: awal rentang waktu (misalnya,2024-01-01T00:00:00Z).END_TIME: akhir rentang waktu (misalnya,2024-02-01T00:00:00Z).
Contoh kueri:
resource.type="gce_instance" resource.labels.instance_id="projects/7654321/zones/us-central1-a/instances/123456" jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" jsonPayload.extensionName="ops-agent" timestamp >= "2024-01-01T00:00:00Z" timestamp <= "2024-02-01T01:00:00Z"Klik Run query.
gcloud
Untuk mencari log ekstensi VM, gunakan perintah logging read. Contoh:
gcloud logging read 'resource.type="gce_instance" AND \
resource.labels.instance_id="INSTANCE_ID" AND \
jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND \
jsonPayload.extensionName="YOUR_EXTENSION_NAME" AND \
timestamp >= "START_TIME" AND \
timestamp <= "END_TIME"'
Ganti kode berikut:
INSTANCE_ID: ID instance VM.YOUR_EXTENSION_NAME: nama ekstensi (misalnya,ops-agent).START_TIME: awal rentang waktu (misalnya,2024-01-01T00:00:00Z).END_TIME: akhir rentang waktu (misalnya,2024-02-01T00:00:00Z).
REST
Buat permintaan ke Logging V2
API. Isi permintaan harus
berisi parameter filter. Contoh:
POST https://logging.googleapis.com/v2/entries:list
{
"filter": "resource.type="gce_instance" AND
"resource.labels.instance_id="INSTANCE_ID" AND
"jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND
"jsonPayload.extensionName="EXTENSION_NAME" AND
"timestamp >= "START_TIME" AND
"timestamp <= "END_TIME",
"pageSize": 10,
"resourceNames": [
"projects/PROJECT_ID"
]
}
Ganti kode berikut:
INSTANCE_ID: ID instance VM.EXTENSION_NAME: nama ekstensi (misalnya,ops-agent).START_TIME: awal rentang waktu (misalnya,2024-01-01T00:00:00Z).END_TIME: akhir rentang waktu (misalnya,2024-02-01T00:00:00Z).PROJECT_ID: Google Cloud Project ID Anda.
Entri log peristiwa ekstensi VM
Berikut adalah contoh entri log untuk peristiwa ekstensi VM:
{
"insertId": "rsiudxbck",
"jsonPayload": {
"eventMessage": "Enforcement State: Installing ops-agent@4bda61add3e5c989.; Extension Health: Plugin is running ok",
"timestamp": "2026-03-23T16:13:40.496755675Z",
"extensionName": "ops-agent",
"revisionId": "4bda61add3e5c989",
"@type": "type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent",
"eventType": "INSTALLED"
},
"resource": {
"type": "gce_instance",
"labels": {
"project_id": "27654321",
"instance_id": "projects/7654321/zones/us-west1-a/instances/1234567",
"zone": "us-west1-a"
}
},
"timestamp": "2026-03-23T16:13:40.496854498Z",
"severity": "INFO",
"logName": "projects/my-project/logs/compute.googleapis.com%2Fvm_extension_policies",
"receiveTimestamp": "2026-03-23T16:13:40.906133199Z"
}
Detail entri log
Tabel berikut menjelaskan parameter yang dapat Anda temukan di log ekstensi VM:
| Kolom | Deskripsi |
|---|---|
eventMessage |
Pesan yang menjelaskan peristiwa, termasuk status penegakan dan respons ekstensi. |
extensionName |
Nama ekstensi (misalnya, ops-agent).
Untuk mengetahui daftar ekstensi yang didukung dan namanya, lihat ekstensi yang didukung. |
extensionVersion |
Versi ekstensi yang telah dipilih untuk diinstal. Versi ini adalah versi yang disematkan dalam kebijakan ekstensi atau versi terbaru jika tidak ada versi yang disematkan. |
revisionId |
Biner tertentu dari versi ekstensi. Setiap versi ekstensi dapat memiliki beberapa revisi untuk mendukung sistem operasi yang berbeda, dan Google otomatis memilih yang benar untuk VM tertentu. Memberikan ID revisi ini kepada tim dukungan Google dapat membantu men-debug apakah biner yang benar dipilih untuk VM. |
eventType |
Jenis peristiwa. Nilainya dapat berupa salah satu dari nilai berikut:
|