Aracılığıyla paylaş

Azure Container Apps'te günlük depolama ve izleme seçenekleri

Azure Container Apps, uygulama günlüklerinizi depolama ve görüntüleme seçenekleri sunar. Günlük tutma seçeneklerini Container Apps ortam düzeyinde yapılandırabilirsiniz. Günlüklerin hedefi olarak Azure İzleyici'yi seçerseniz, hata ayıklama ayarlarını hem ortam düzeyinde hem de kapsayıcı uygulaması düzeyinde yapılandırabilirsiniz.

Container Apps uygulama günlükleri iki farklı kategoriden oluşur:

  • Kapsayıcı konsolu çıkış (stdout/stderr) iletileri.
  • Azure Container Apps tarafından oluşturulan sistem günlükleri.
  • Spring App konsol günlükleri.

Bu günlük hedefleri arasında seçim yapabilirsiniz:

  • Log Analytics: Azure İzleyici Log Analytics varsayılan depolama ve görüntüleme seçeneğidir. Günlükleriniz, Günlük Analiz sorguları kullanılarak görüntülenip analiz edilebilecekleri bir Günlük Analiz çalışma alanında depolanır. Log Analytics hakkında daha fazla bilgi edinmek için bkz . Azure İzleyici Log Analytics.
  • Azure İzleyici: Azure İzleyici günlükleri bir veya daha fazla hedefe yönlendirir:
    • Görüntüleme ve analiz için Log Analytics çalışma alanı.
    • Arşivleme için Azure depolama hesabı.
    • Veri alımı ve analiz hizmetleri için Azure event hub'ı. Daha fazla bilgi için bkz . Azure Event Hubs.
    • Datadog, Elastic, Logz.io ve diğerleri gibi bir Azure iş ortağı izleme çözümü. Daha fazla bilgi için bkz . İş ortağı çözümleri.
  • Günlükleri kaydetme: Günlük verilerinin depolanmasını devre dışı bırakabilirsiniz. Devre dışı bırakıldığında, kapsayıcı uygulamanızdaki Günlükler akışı özelliği aracılığıyla gerçek zamanlı kapsayıcı günlüklerini görüntülemeye devam edebilirsiniz. Daha fazla bilgi için bkz . Günlük akışı.

Günlükleri kaydetme veya Azure İzleyici hedefi seçildiğinde, Azure portalında Log Analytics sorgu düzenleyicisini sağlayan Günlükler menü öğesi devre dışı bırakılır.

Günlük kaydı seçeneklerini yapılandırma

Azure portalında ortamınız için günlük seçeneklerini yapılandırmak için şu adımları kullanın:

  1. Portalda Container Apps ortamınıza göz atın.

  2. İzleme Günlüğü seçenekleri'ni> seçin.

  3. Aşağıdaki Günlükler Hedefi seçeneklerinden birini seçebilirsiniz:

    • Azure Log Analytics: Bu seçenekle, günlük verilerinizi depolamak için bir Log Analytics çalışma alanı seçersiniz. Günlükleriniz Log Analytics sorguları aracılığıyla görüntülenebilir. Log Analytics hakkında daha fazla bilgi edinmek için bkz . Azure İzleyici Log Analytics.
    • Azure İzleyici: Azure İzleyici günlüklerinizi bir hedefe yönlendirir. Bu seçeneği belirlediğinizde, bu sayfada Kaydet'i seçtikten sonra yapılandırmayı tamamlamak için Tanılama ayarları'nı seçmeniz gerekir.
    • Günlükleri kaydetme: Bu seçenek günlük verilerinin depolanmasını devre dışı bırakır.

  4. Kaydet'i seçin.

Tanılama ayarları

Günlük hedefiniz olarak Azure İzleyici'yi seçtiyseniz tanılama ayarlarını da yapılandırmanız gerekir. Tanılama ayarlarını hem ortam düzeyinde hem de kapsayıcı uygulaması düzeyinde yapılandırabilirsiniz.

Ortam düzeyinde tanılama ayarlarını yapılandırma

Ortamınız için tanılama ayarlarını yapılandırmak için şu adımları kullanın:

  1. Portalda ortamınıza göz atın.

  2. İzleme Tanılama ayarları'nı Ortamınızın günlüklerinin hedefini Azure İzleyici olarak yeni ayarladıysanız, bu yapılandırma öğesinin görünmesi için sayfayı yenilemeniz gerekebilir.

Hedef ayrıntıları tanılama ayarları olarak kaydedilir. Ortamınız için en fazla beş tanılama ayarı oluşturabilirsiniz. Her tanılama ayarı için farklı günlük kategorileri yapılandırabilirsiniz. Örneğin, sistem günlükleri kategorisini bir hedefe göndermek için bir tanılama ayarı ve kapsayıcı konsolu günlükleri kategorisini başka bir hedefe göndermek için başka bir tanılama ayarı oluşturun.

Yeni bir tanılama ayarı oluşturmak için:

  1. Tanılama ayarı ekle’yi seçin.

  2. Tanılama ayarı adı alanına tanılama ayarınız için bir ad girin.

  3. Bu hedefe göndermek istediğiniz Kategori gruplarını veya Kategorileri günlüğe yazın. Bir veya daha fazla kategori seçebilirsiniz.

  4. Uygulama düzeyinde ölçümler göndermek istiyorsanız Ölçümler Tüm Ölçümler'i> seçin.

  5. Bir veya daha fazla Hedef ayrıntısı seçin:

    • Log Analytics çalışma alanına gönder: Mevcut Log Analytics çalışma alanlarından seçim yapın.
    • Depolama hesabına arşivle: Azure depolama hesaplarından seçim yapın.
    • Bir olay hub'ına akışla aktarma: Azure olay hub'ları arasından seçim yapın.
    • İş ortağı çözümüne gönder: Azure iş ortağı çözümlerinden seçim yapın.

  6. Kaydet'i seçin.

Tanılama ayarları hakkında daha fazla bilgi için bkz . Azure İzleyici'de tanılama ayarları.

Kapsayıcı uygulaması düzeyinde tanılama ayarlarını yapılandırma

Kapsayıcı uygulamanızın tanılama ayarlarını yapılandırmak için şu adımları kullanın:

  1. Portalda kapsayıcı uygulamanıza göz atın.

  2. İzleme Tanılama ayarları'nı Kapsayıcı uygulama ortamınızın günlüklerinin hedefini Azure İzleyici olarak ayarladıysanız, bu yapılandırma ekranının görünmesi için sayfayı yenilemeniz gerekebilir.

  3. Tanılama ayarı ekle’yi seçin.

  4. Tanılama ayarı adı alanına tanılama ayarınız için bir ad girin.

  5. Ölçümler'in altında AllMetrics'i seçin.

  6. Bir veya daha fazla Hedef ayrıntısı seçin:

    • Log Analytics çalışma alanına gönder: Mevcut Log Analytics çalışma alanlarından seçim yapın.
    • Depolama hesabında arşivle: Bu seçenek kullanım dışıdır.
    • Bir olay hub'ına akışla aktarma: Azure olay hub'ları arasından seçim yapın.
    • İş ortağı çözümüne gönder: Azure iş ortağı çözümlerinden seçim yapın.

  7. Kaydet'i seçin.

Günlük kaydı seçeneklerini yapılandırma

Bağımsız değişkeniyle Azure CLI az containerapp create ve az containerapp update komutlarını kullanarak Container Apps ortamınız için günlük hedefini --logs-destination yapılandırın.

İlk olarak ad alanını Microsoft.Insights kaydedin.

az provider register --namespace Microsoft.Insights

Log Analytics çalışma alanına gönderme

Mevcut bir Log Analytics çalışma alanını günlüklerin hedefi olarak kullanarak bir Container Apps ortamı oluşturmak için aşağıdaki komutu çalıştırın. <PLACEHOLDERS> ifadesini değerlerinizle değiştirin. Log Analytics çalışma alanı kaynak kimliğini Azure portalındaki Log Analytics çalışma alanı sayfasından veya komutundan az monitor log-analytics workspace show alabilirsiniz.

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

--logs-destination bağımsız değişkeni log-analytics, azure-monitor ve none değerlerini kabul eder.

Azure İzleyici'ye gönderme

Mevcut bir Container Apps ortamını günlük hedefi olarak Azure Monitor'ü kullanacak şekilde güncellemek için aşağıdaki komutu çalıştırın. <PLACEHOLDERS> yerine kendi değerlerinizi koyun.

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

Tanılama ayarlarını yapılandırma

--logs-destination olarak ayarlandığındaazure-monitor, komutuyla az monitor diagnostics-settings günlük kategorilerinin hedef ayrıntılarını yapılandırmak için tanılama ayarları oluşturmanız gerekir. Bu tanılama ayarlarını hem ortam düzeyinde hem de kapsayıcı uygulaması düzeyinde yapılandırabilirsiniz.

Ortam düzeyinde tanılama ayarları oluşturmak için aşağıdaki komutu çalıştırın. <PLACEHOLDERS> ifadesini değerlerinizle değiştirin. Ortam kimliğini Azure portalındaki Ortam sayfasından veya komutundan az containerapp env show alabilirsiniz.

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>

ve --logs parametrelerine sağlanan --metrics JSON değerlerinde boşluk olmadığından emin olun.

parametresi için --logs veya categorybelirtebilirsinizcategoryGroup, ancak ikisini birden belirtemezsiniz. Mevcut değerler, categoryGroup ve audit için allLogs şeklindedir. Mevcut değerler, category ve ContainerAppConsoleLogs için ContainerAppSystemLogs şeklindedir.

parametresi için --metrics , kullanılabilir tek kategori olur AllMetrics.

Daha fazla bilgi için bkz . LogSettings ve MetricSettings.

Kapsayıcı uygulaması düzeyinde tanılama ayarları oluşturmak için aşağıdaki komutu çalıştırın. <PLACEHOLDERS> ifadesini değerlerinizle değiştirin. Kapsayıcı uygulama kimliğini Azure portalından veya komutundan az containerapp show alabilirsiniz.

Kapsayıcı uygulaması düzeyinde --logs tanılama ayarları oluşturulurken parametresi desteklenmez ve parametresi için --metrics tek kullanılabilir kategori olur AllMetrics.

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

Azure İzleyici tanılama ayarları komutları hakkında daha fazla bilgi için bkz . az monitor diagnostic-settings.

Sınırlamalar

Günlük seçeneklerinizi ayarlarken aşağıdaki sınırlamalar geçerlidir.

  • Özel bağlantı: Günlükleri Özel Bağlantı aracılığıyla doğrudan Log Analytics Çalışma Alanına gönderme desteklenmez. Ancak Azure İzleyici'yi kullanabilir ve günlüklerinizi aynı Log Analytics Çalışma Alanına gönderebilirsiniz. Bu dolaylı işlem, sistem günlüğü veri kaybını önlemek için gereklidir.

Sonraki adımlar

Log Analytics ile günlükleri izleme