Opcje magazynu dzienników i monitorowania w usłudze Azure Container Apps

Usługa Azure Container Apps udostępnia opcje przechowywania i wyświetlania dzienników aplikacji. Opcje rejestrowania można skonfigurować na poziomie środowiska Usługi Container Apps. Jeśli wybierzesz usługę Azure Monitor jako miejsce docelowe dzienników, możesz skonfigurować ustawienia diagnostyczne zarówno na poziomie środowiska, jak i na poziomie aplikacji kontenera.

Dzienniki aplikacji usługi Container Apps składają się z dwóch różnych kategorii:

• Komunikaty wyjściowe konsoli kontenera (stdout/stderr).
• Dzienniki systemowe generowane przez usługę Azure Container Apps.
• Dzienniki konsoli aplikacji Spring.

Możesz wybrać między tymi destynacjami logów.

• Log Analytics: Usługa Azure Monitor Log Analytics jest domyślną opcją przechowywania i wyświetlania. Dzienniki są przechowywane w obszarze roboczym usługi Log Analytics, w którym można je wyświetlać i analizować przy użyciu zapytań usługi Log Analytics. Aby dowiedzieć się więcej na temat usługi Log Analytics, zobacz Azure Monitor Log Analytics.
• Azure Monitor: usługa Azure Monitor kieruje dzienniki do co najmniej jednego miejsca docelowego:
  • Obszar roboczy usługi Log Analytics do wyświetlania i analiz.
  • Konto przechowywania Azure do archiwizacji.
  • Centrum zdarzeń platformy Azure na potrzeby pozyskiwania danych i usług analitycznych. Aby uzyskać więcej informacji, zobacz Azure Event Hubs.
  • Rozwiązanie do monitorowania partnerów platformy Azure, takie jak Datadog, Elastic, Logz.io i inne. Aby uzyskać więcej informacji, zobacz Rozwiązania partnerskie.
• Nie zapisuj dzienników: możesz wyłączyć przechowywanie danych dziennika. Po wyłączeniu nadal można wyświetlać dzienniki kontenerów w czasie rzeczywistym za pośrednictwem funkcji strumienia dzienników w aplikacji kontenera. Aby uzyskać więcej informacji, zobacz Przesyłanie strumieniowe dzienników.

Jeśli zostanie wybrana opcja Nie zapisuj dzienników lub Azure Monitor, element menu Dzienniki, udostępniający edytor zapytań Log Analytics w portalu Azure, jest wyłączony.

Konfigurowanie opcji rejestrowania

Wykonaj następujące kroki, aby skonfigurować opcje rejestrowania dla środowiska w witrynie Azure Portal:

1. Przejdź do środowiska Container Apps w portalu.

2. Wybierz Monitorowanie>Opcje rejestrowania.

3. Możesz wybrać jedną z następujących opcji miejsca docelowego dzienników :

   • Azure Log Analytics: za pomocą tej opcji wybierz obszar roboczy usługi Log Analytics do przechowywania danych dziennika. Dzienniki można wyświetlać za pomocą zapytań usługi Log Analytics. Aby dowiedzieć się więcej na temat usługi Log Analytics, zobacz Azure Monitor Log Analytics.
   • Azure Monitor: usługa Azure Monitor kieruje dzienniki do miejsca docelowego. Po wybraniu tej opcji należy wybrać pozycję Ustawienia diagnostyczne, aby ukończyć konfigurację po wybraniu pozycji Zapisz na tej stronie.
   • Nie zapisuj dzienników: ta opcja wyłącza przechowywanie danych dziennika.

4. Wybierz pozycję Zapisz.

Ustawienia diagnostyczne

W przypadku wybrania usługi Azure Monitor jako miejsca docelowego dzienników należy również skonfigurować ustawienia diagnostyczne. Ustawienia diagnostyczne można skonfigurować zarówno na poziomie środowiska, jak i na poziomie aplikacji kontenera.

Konfigurowanie ustawień diagnostycznych na poziomie środowiska

Wykonaj następujące kroki, aby skonfigurować ustawienia diagnostyczne dla środowiska:

1. Przejdź do środowiska w portalu.

2. Wybierz pozycję Monitorowanie>ustawień diagnostycznych. Jeśli właśnie ustawiono lokalizację docelową dzienników środowiska na usługę Azure Monitor, może być konieczne odświeżenie strony, aby ten element konfiguracji był wyświetlany.

Szczegóły lokalizacji docelowej są zapisywane jako ustawienia diagnostyczne. Dla środowiska można utworzyć maksymalnie pięć ustawień diagnostycznych. Dla każdego ustawienia diagnostycznego można skonfigurować różne kategorie dzienników. Możesz na przykład utworzyć jedno ustawienie diagnostyczne, aby wysłać kategorię dzienników systemowych do jednego miejsca docelowego, a drugą, aby wysłać kategorię dzienników konsoli kontenera do innego miejsca docelowego.

Aby utworzyć nowe ustawienie diagnostyczne:

1. Wybierz pozycję Dodaj ustawienia diagnostyczne.

2. W polu Nazwa ustawienia diagnostycznego wprowadź nazwę ustawienia diagnostycznego.

3. Wybierz grupy kategorii dziennika lub kategorie, które chcesz wysłać do tego miejsca docelowego. Możesz wybrać co najmniej jedną kategorię.

4. Jeśli chcesz wysłać metryki na poziomie aplikacji, wybierz Metryki>Wszystkie metryki.

5. Wybierz co najmniej jeden element docelowy:

   • Wyślij do obszaru roboczego usługi Log Analytics: wybierz z istniejących obszarów roboczych usługi Log Analytics.
   • Archiwizowanie na koncie magazynu: wybierz z kont usługi Azure Storage.
   • Przesyłanie strumieniowe do centrum zdarzeń: wybierz z usługi Azure Event Hubs.
   • Wyślij do rozwiązania partnerskiego: wybierz z rozwiązań partnerskich platformy Azure.

6. Wybierz pozycję Zapisz.

Aby uzyskać więcej informacji na temat ustawień diagnostycznych, zobacz Ustawienia diagnostyczne w usłudze Azure Monitor.

Konfigurowanie ustawień diagnostycznych na poziomie aplikacji kontenera

Wykonaj następujące kroki, aby skonfigurować ustawienia diagnostyczne dla aplikacji kontenera:

1. Przejrzyj aplikację kontenerową na portalu.

2. Wybierz pozycję Monitorowanie>ustawień diagnostycznych. Jeśli właśnie ustawiono lokalizację docelową dzienników środowiska aplikacji kontenera na usługę Azure Monitor, może być konieczne odświeżenie strony, aby ten element konfiguracji był wyświetlany.

3. Wybierz pozycję Dodaj ustawienia diagnostyczne.

4. W polu Nazwa ustawienia diagnostycznego wprowadź nazwę ustawienia diagnostycznego.

5. W obszarze Metryki wybierz pozycję Wszystkie metryki.

6. Wybierz co najmniej jeden element docelowy:

   • Wyślij do obszaru roboczego usługi Log Analytics: wybierz z istniejących obszarów roboczych usługi Log Analytics.
   • Archiwizowanie na koncie magazynującym: Wybierz konto magazynujące.
   • Przesyłanie strumieniowe do centrum zdarzeń: wybierz z usługi Azure Event Hubs.
   • Wyślij do rozwiązania partnerskiego: wybierz z rozwiązań partnerskich platformy Azure.

7. Wybierz pozycję Zapisz.

Konfigurowanie opcji rejestrowania

Skonfiguruj lokalizację docelową dzienników dla środowiska usługi Container Apps za pomocą Azure CLI az containerapp create i poleceń az containerapp update z argumentem --logs-destination.

Najpierw zarejestruj Microsoft.Insights przestrzeń nazw.

az provider register --namespace Microsoft.Insights

Wysyłanie do obszaru roboczego usługi Log Analytics

Aby utworzyć środowisko usługi Container Apps przy użyciu istniejącego obszaru roboczego usługi Log Analytics jako miejsca docelowego dzienników, uruchom następujące polecenie. Zastąp element <PLACEHOLDERS> swoimi wartościami. Identyfikator zasobu obszaru roboczego usługi Log Analytics można uzyskać ze strony obszaru roboczego usługi Log Analytics w portalu Azure lub za pomocą polecenia 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>

Argument --logs-destination akceptuje wartości log-analytics, azure-monitori none.

Wyślij do usługi Azure Monitor

Aby zaktualizować istniejące środowisko usługi Container Apps do używania usługi Azure Monitor jako miejsca docelowego dzienników, uruchom następujące polecenie. Zastąp <PLACEHOLDERS> swoimi wartościami.

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

Konfigurowanie ustawień diagnostycznych

Gdy --logs-destination zostanie ustawione na azure-monitor, należy utworzyć ustawienia diagnostyczne, aby skonfigurować szczegóły lokalizacji docelowej dla kategorii dzienników za pomocą polecenia az monitor diagnostics-settings. Te ustawienia diagnostyczne można skonfigurować zarówno na poziomie środowiska, jak i na poziomie aplikacji kontenera.

Aby utworzyć ustawienia diagnostyczne na poziomie środowiska, uruchom następujące polecenie. Zastąp element <PLACEHOLDERS> swoimi wartościami. Identyfikator środowiska można uzyskać na stronie Środowiska w portalu Azure lub za pomocą polecenia az containerapp env show.

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>

Upewnij się, że w wartościach JSON podanych dla parametrów --logs i --metrics nie ma spacji.

Dla parametru --logs można określić wartość category lub wartość categoryGroup, ale nie obie jednocześnie. W przypadku categoryGroup dostępne wartości to audit i allLogs. W przypadku category dostępne wartości to ContainerAppConsoleLogs i ContainerAppSystemLogs.

Dla parametru jedyną dostępną kategorią --metrics jest AllMetrics.

Aby uzyskać więcej informacji, zobacz LogSettings i MetricSettings.

Aby utworzyć ustawienia diagnostyczne na poziomie aplikacji kontenera, uruchom następujące polecenie. Zastąp element <PLACEHOLDERS> swoimi wartościami. Identyfikator aplikacji kontenera można pobrać z „Azure Portal”, lub za pomocą polecenia az containerapp show.

Podczas tworzenia ustawień diagnostycznych na poziomie aplikacji kontenerowej, parametr --logs nie jest obsługiwany, a dla parametru --metrics jedyną dostępną kategorią jest AllMetrics.

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

Aby uzyskać więcej informacji na temat poleceń dotyczących konfiguracji diagnostycznych usługi Azure Monitor, zobacz az monitor diagnostic-settings.

Ograniczenia

Podczas konfigurowania opcji dziennika obowiązują następujące ograniczenia.

• Link prywatny: wysyłanie dzienników bezpośrednio do obszaru roboczego usługi Log Analytics za pośrednictwem usługi Private Link nie jest obsługiwane. Możesz jednak użyć usługi Azure Monitor i wysłać dzienniki do tego samego obszaru roboczego usługi Log Analytics. Ta pośrednia jest wymagana, aby zapobiec utracie danych dziennika systemu.

Następne kroki

Monitorowanie dzienników za pomocą usługi Log Analytics