Opsi pemantauan dan penyimpanan log di Azure Container Apps

Azure Container Apps memberi Anda opsi untuk menyimpan dan melihat log aplikasi Anda. Anda dapat mengonfigurasi opsi pengelogan di tingkat lingkungan Container Apps. Jika Anda memilih Azure Monitor sebagai tujuan log, Anda dapat mengonfigurasi pengaturan diagnostik di tingkat lingkungan dan tingkat aplikasi kontainer.

Log aplikasi Container Apps terdiri dari dua kategori berbeda:

• Pesan keluaran konsol kontainer (stdout/stderr).
• Log sistem yang dibuat oleh Azure Container Apps.
• Log konsol Spring Aplikasi.

Anda dapat memilih di antara tujuan log ini:

• Log Analytics: Azure Monitor Log Analytics merupakan opsi penyimpanan dan tampilan default. Log Anda disimpan di ruang kerja Analitik Log tempat log dapat dilihat dan dianalisis menggunakan kueri Analitik Log. Untuk mempelajari selengkapnya tentang Log Analytics, lihat Azure Monitor Log Analytics.
• Azure Monitor: Azure Monitor merutekan log ke satu atau beberapa tujuan:
  • Ruang kerja Log Analytics untuk melihat dan menganalisis.
  • Akun penyimpanan Azure untuk mengarsipkan.
  • Hub peristiwa Azure untuk penyerapan data dan layanan analitik. Untuk mengetahui informasi selengkapnya, lihat Azure Event Hubs.
  • Solusi pemantauan mitra Azure seperti Datadog, Elastic, Logz.io, dan lainnya. Untuk informasi selengkapnya, lihat Solusi mitra.
• Jangan simpan log: Anda dapat menonaktifkan penyimpanan data log. Saat dinonaktifkan, Anda masih dapat melihat log kontainer real-time melalui fitur Aliran log di aplikasi kontainer Anda. Untuk informasi selengkapnya, lihat Streaming log.

Saat Jangan simpan log atau tujuan Azure Monitor dipilih, item menu Log yang menyediakan fitur editor kueri Analitik Log di portal Azure akan dinonaktifkan.

Mengonfigurasi opsi pengelogan

Gunakan langkah-langkah ini untuk mengonfigurasi opsi pengelogan untuk lingkungan Anda di portal Microsoft Azure:

1. Telusuri ke lingkungan Aplikasi Kontainer Anda di portal.

2. Pilih Pemantauan>Opsi Pengelogan.

3. Anda dapat memilih dari opsi Tujuan Log berikut:

   • Azure Log Analytics: Dengan opsi ini, Anda memilih ruang kerja Analitik Log untuk menyimpan data log Anda. Melalui kueri Log Analytics, log Anda dapat dilihat. Untuk mempelajari selengkapnya tentang Log Analytics, lihat Azure Monitor Log Analytics.
   • Azure Monitor: Azure Monitor merutekan log Anda ke tujuan. Saat Anda memilih opsi ini, Anda harus memilih Pengaturan diagnostik untuk menyelesaikan konfigurasi setelah memilih Simpan di halaman ini.
   • Jangan simpan log: Opsi ini menonaktifkan penyimpanan data log.

4. Pilih Simpan.

Pengaturan diagnostik

Jika Anda memilih Azure Monitor sebagai tujuan log, Anda juga harus mengonfigurasi pengaturan diagnostik. Anda dapat mengonfigurasi pengaturan diagnostik di tingkat lingkungan dan tingkat aplikasi kontainer.

Mengonfigurasi pengaturan diagnostik di tingkat lingkungan

Gunakan langkah-langkah ini untuk mengonfigurasi pengaturan diagnostik untuk lingkungan Anda:

1. Telusuri lingkungan Anda di portal.

2. Pilih . Jika Anda baru saja mengatur tujuan log lingkungan Anda ke Azure Monitor, Anda mungkin perlu me-refresh halaman agar item konfigurasi ini muncul.

Rincian tujuan disimpan sebagai pengaturan diagnostik. Anda dapat membuat hingga lima pengaturan diagnostik untuk lingkungan Anda. Anda dapat mengonfigurasi kategori log yang berbeda untuk setiap pengaturan diagnostik. Misalnya, buat satu pengaturan diagnostik untuk mengirim kategori log sistem ke satu tujuan, dan yang lain untuk mengirim kategori log konsol kontainer ke tujuan lain.

Untuk membuat pengaturan diagnostik baru:

1. Pilih Menambahkan pengaturan diagnostik.

2. Di Nama pengaturan diagnostik, masukkan nama untuk pengaturan diagnostik Anda.

3. Pilih grup Kategori log atau Kategori yang ingin Anda kirim ke tujuan ini. Anda dapat memilih satu atau beberapa kategori.

4. Jika Anda ingin mengirim metrik tingkat aplikasi, pilih Metrik>AllMetrics.

5. Pilih satu atau beberapa Detail tujuan:

   • Kirim ke ruang kerja Log Analytics: Pilih dari ruang kerja Log Analytics yang ada.
   • Arsipkan ke akun penyimpanan: Pilih dari akun penyimpanan Azure.
   • Streaming ke hub acara: Pilih dari hub acara Azure.
   • Kirim ke solusi mitra: Pilih solusi mitra dari Azure.

6. Pilih Simpan.

Untuk informasi selengkapnya tentang Pengaturan diagnostik, lihat Pengaturan diagnostik di Azure Monitor.

Mengonfigurasi pengaturan diagnostik di tingkat aplikasi kontainer

Gunakan langkah-langkah ini untuk mengonfigurasi pengaturan diagnostik untuk aplikasi kontainer Anda:

1. Telusuri ke aplikasi kontainer Anda di portal.

2. Pilih . Jika Anda baru saja mengatur tujuan log lingkungan aplikasi kontainer ke Azure Monitor, Anda mungkin perlu me-refresh halaman agar item konfigurasi ini muncul.

3. Pilih Menambahkan pengaturan diagnostik.

4. Di Nama pengaturan diagnostik, masukkan nama untuk pengaturan diagnostik Anda.

5. Di bawah Metrik, pilih AllMetrics.

6. Pilih satu atau beberapa Detail tujuan:

   • Kirim ke ruang kerja Log Analytics: Pilih dari ruang kerja Log Analytics yang ada.
   • Arsipkan ke akun penyimpanan: Pilih akun penyimpanan.
   • Streaming ke hub acara: Pilih dari hub acara Azure.
   • Kirim ke solusi mitra: Pilih solusi mitra dari Azure.

7. Pilih Simpan.

Mengonfigurasi opsi pengelogan

Konfigurasikan tujuan log untuk lingkungan Container Apps Anda menggunakan perintah Azure CLI az containerapp create dan az containerapp update dengan argumen --logs-destination.

Pertama, daftarkan namespace Microsoft.Insights.

az provider register --namespace Microsoft.Insights

Mengirim ke ruang kerja Analitik Log

Untuk membuat lingkungan Aplikasi Kontainer menggunakan ruang kerja Analitik Log yang ada sebagai tujuan log, jalankan perintah berikut. <PLACEHOLDERS> Ganti dengan nilai Anda. Anda bisa mendapatkan ID Log Analytics workspace dari halaman Log Analytics workspace di portal Azure, atau dari perintah az monitor log-analytics workspace show.

az containerapp env create \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination log-analytics \
  --logs-workspace-id <LOG_ANALYTICS_WORKSPACE_ID>

Argumen --logs-destination menerima nilai log-analytics, , azure-monitordan none.

Kirim ke Azure Monitor

Untuk memperbarui lingkungan Container Apps yang ada untuk menggunakan Azure Monitor sebagai tujuan log, jalankan perintah berikut. <PLACEHOLDERS> Ganti dengan nilai Anda:

az containerapp env update \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination azure-monitor

Mengonfigurasi pengaturan diagnostik

Ketika --logs-destination diatur ke azure-monitor, Anda harus membuat pengaturan diagnostik untuk mengonfigurasi detail tujuan untuk kategori log dengan az monitor diagnostics-settings perintah . Anda dapat mengonfigurasi pengaturan diagnostik ini di tingkat lingkungan dan tingkat aplikasi kontainer.

Untuk membuat pengaturan diagnostik di tingkat lingkungan, jalankan perintah berikut. <PLACEHOLDERS> Ganti dengan nilai Anda. Anda bisa mendapatkan ID lingkungan dari halaman Lingkungan di portal Microsoft Azure, atau dari az containerapp env show perintah .

az monitor diagnostic-settings create \
  --name "AllMetricsToLogAnalytics" \
  --resource <ENVIRONMENT_ID> \
  --logs '[{"categoryGroup":"allLogs","enabled":true}]' \
  --metrics '[{"category":"AllMetrics","enabled":true}]' \
  --workspace <LOG_ANALYTICS_RESOURCE_ID>

Pastikan tidak ada spasi dalam nilai JSON yang disediakan untuk --logs parameter dan --metrics .

--logs Untuk parameter , Anda dapat menentukan category atau categoryGroup, tetapi tidak keduanya sekaligus. Untuk categoryGroup, nilai yang tersedia adalah audit dan allLogs. Untuk category, nilai yang tersedia adalah ContainerAppConsoleLogs dan ContainerAppSystemLogs.

Untuk parameter --metrics, satu-satunya kategori yang tersedia adalah AllMetrics.

Untuk informasi selengkapnya, lihat LogSettings dan MetricSettings.

Untuk membuat pengaturan diagnostik di tingkat aplikasi kontainer, jalankan perintah berikut. <PLACEHOLDERS> Ganti dengan nilai Anda. Anda bisa mendapatkan ID aplikasi kontainer dari portal Microsoft Azure, atau dari az containerapp show perintah .

Saat membuat pengaturan diagnostik di tingkat aplikasi kontainer, --logs parameter tidak didukung, dan untuk --metrics parameter, satu-satunya kategori yang tersedia adalah AllMetrics.

az monitor diagnostic-settings create \
--name "AllMetricsToLogAnalytics" \
--resource <CONTAINER_APP_ID> \
--metrics '[{"category":"AllMetrics","enabled":true}]' \
--workspace <LOG_ANALYTICS_RESOURCE_ID>

Untuk informasi selengkapnya tentang perintah pengaturan diagnostik Azure Monitor, lihat az monitor diagnostic-settings.

Keterbatasan

Batasan berikut berlaku saat Anda menyiapkan opsi log Anda.

• Tautan privat: Mengirim log langsung ke Ruang Kerja Analitik Log melalui Private Link tidak didukung. Namun, Anda dapat menggunakan Azure Monitor dan mengirim log ke Ruang Kerja Analitik Log yang sama. Tidak langsung ini diperlukan untuk mencegah kehilangan data log sistem.

Langkah berikutnya

Memantau log menggunakan Log Analytics