Skema log wawasan kontainer

Wawasan kontainer menyimpan data log yang dikumpulkannya dalam tabel yang disebut ContainerLogV2. Artikel ini menjelaskan skema tabel ini serta perbandingan dan migrasinya dari tabel ContainerLog warisan.

Penting

ContainerLogV2 akan menjadi skema default melalui ConfigMap untuk CLI versi 2.54.0 dan yang lebih besar. ContainerLogV2 akan menjadi format penyerapan default untuk pelanggan yang akan melakukan onboarding wawasan kontainer dengan Autentikasi Identitas Terkelola menggunakan arm, Bicep, Terraform, Policy dan Portal onboarding. ContainerLogV2 dapat diaktifkan secara eksplisit melalui CLI versi 2.51.0 atau yang lebih tinggi menggunakan pengaturan Pengumpulan data.

Dukungan untuk tabel ContainerLog akan dihentikan pada 30 September 2026.

Perbandingan tabel

Tabel berikut menyoroti perbedaan utama antara menggunakan skema ContainerLogV2 dan ContainerLog.

Perbedaan fitur ContainerLog ContainerLogV2
Skema Detail di ContainerLog. Detail di ContainerLogV2.
Kolom tambahan adalah:
- ContainerName
- PodName
- PodNamespace.
Onboarding Hanya dapat dikonfigurasi melalui ConfigMap. Dapat dikonfigurasi melalui ConfigMap dan DCR. 1
Harga Hanya kompatibel dengan log analitik dengan harga penuh. Mendukung tingkat log dasar biaya rendah selain log analitik.
Melakukan Permintaan Memerlukan beberapa operasi gabungan dengan tabel inventaris untuk kueri standar. Termasuk metadata pod dan kontainer tambahan untuk mengurangi kompleksitas kueri dan menggabungkan operasi.
Multibaris Tidak didukung, entri multibaris dibagi menjadi beberapa baris. Dukungan untuk pengelogan multibaris untuk memungkinkan entri tunggal terkonsolidasi untuk output multibaris.

1Konfigurasi DCR tidak didukung untuk kluster menggunakan kluster berbasis autentikasi perwakilan layanan. Migrasikan kluster Anda dengan perwakilan layanan ke identitas terkelola untuk menggunakan pengalaman ini.

Catatan

Ekspor ke Event Hub dan Akun Penyimpanan tidak didukung jika LogMessage masuk bukan JSON yang valid. Untuk performa terbaik, sebaiknya keluarkan log kontainer dalam format JSON.

Menilai dampak pada pemberitahuan yang ada

Sebelum mengaktifkan skema ContainerLogsV2 , Anda harus menilai apakah Anda memiliki aturan pemberitahuan yang bergantung pada tabel ContainerLog . Setiap pemberitahuan tersebut perlu diperbarui untuk menggunakan tabel baru.

Untuk memindai pemberitahuan yang mereferensikan tabel ContainerLog , jalankan kueri Azure Resource Graph berikut ini:

resources
| where type in~ ('microsoft.insights/scheduledqueryrules') and ['kind'] !in~ ('LogToMetric')
| extend severity = strcat("Sev", properties["severity"])
| extend enabled = tobool(properties["enabled"])
| where enabled in~ ('true')
| where tolower(properties["targetResourceTypes"]) matches regex 'microsoft.operationalinsights/workspaces($|/.*)?' or tolower(properties["targetResourceType"]) matches regex 'microsoft.operationalinsights/workspaces($|/.*)?' or tolower(properties["scopes"]) matches regex 'providers/microsoft.operationalinsights/workspaces($|/.*)?'
| where properties contains "ContainerLog"
| project id,name,type,properties,enabled,severity,subscriptionId
| order by tolower(name) asc

Mengaktifkan skema ContainerLogV2

Anda dapat mengaktifkan skema ContainerLogV2 untuk kluster baik menggunakan Aturan Pengumpulan Data (DCR) kluster atau ConfigMap. Jika kedua pengaturan diaktifkan, ConfigMap akan diutamakan. Log stdout dan stderr hanya akan diserap ke tabel ContainerLog ketika DCR dan ConfigMap secara eksplisit diatur ke nonaktif.

Pengelogan multibaris di Container Insights

Dengan pengelogan multibaris diaktifkan, log kontainer yang dibagi sebelumnya dijahit bersama-sama dan dikirim sebagai entri tunggal ke tabel ContainerLogV2. Jika baris log yang dijahit lebih besar dari 64 KB, baris log akan dipotong karena batas ruang kerja Analitik Log. Fitur ini juga memiliki dukungan untuk jejak tumpukan .NET, Go, Python, dan Java, yang muncul sebagai entri tunggal dalam tabel ContainerLogV2. Aktifkan pengelogan multibaris dengan ConfigMap seperti yang dijelaskan dalam Mengonfigurasi pengumpulan data dalam wawasan Kontainer menggunakan ConfigMap.

Catatan

Peta konfigurasi sekarang menampilkan opsi spesifikasi bahasa, di mana pelanggan hanya dapat memilih bahasa yang mereka minati. Fitur ini dapat diaktifkan dengan mengedit bahasa dalam opsi stacktrace_languages di peta konfigurasi.

Cuplikan layar berikut menunjukkan pengelogan multibaris untuk jejak tumpukan pengecualian Go:

Pengelogan multibaris dinonaktifkan

Screenshot that shows Multi-line logging disabled.

Pengelogan multibaris diaktifkan

Screenshot that shows Multi-line enabled.

Pelacakan tumpukan Java

Screenshot that shows Multi-line enabled for Java.

Pelacakan tumpukan Python

Screenshot that shows Multi-line enabled for Python.

Langkah berikutnya