Anzeigen von Protokollstreams in Azure Container-Apps

Bei der Entwicklung und Problembehandlung ihrer Container-App ist es wichtig, die Protokolle für Ihre Container-App in Echtzeit anzuzeigen. Mit Azure Container-Apps können Sie Folgendes streamen:

  • Systemprotokolle aus der Container-Apps-Umgebung und Ihrer Container-App.
  • Containerkonsolenprotokolle aus Ihrer Container-App.

Auf Protokolldatenströme kann über die Azure-Portal oder die Azure CLI zugegriffen werden.

Anzeigen von Protokolldatenströmen über die Azure-Portal

Sie können Systemprotokolle und Konsolenprotokolle im Azure-Portal anzeigen. Systemprotokolle werden von der Laufzeit der Container-App generiert. Konsolenprotokolle werden von Ihrer Container-App generiert.

Umgebungssystemprotokolldatenstrom

Um Probleme in Ihrer Container-App-Umgebung zu beheben, können Sie den Systemprotokolldatenstrom von Ihrer Umgebungsseite aus anzeigen. Der Protokolldatenstrom zeigt die Systemprotokolle für den Container-Apps-Dienst und die Apps an, die in der Umgebung aktiv ausgeführt werden:

  1. Wechseln Sie in der Azure-Portal zu Ihrer Umgebung.

  2. Wählen Sie im Abschnitt Überwachung im Randleistenmenü die Option Protokollstream aus.

    Screenshot of Container Apps environment system log stream page.

Container-App-Protokolldatenstrom

Sie können einen Protokolldatenstrom des System- oder Konsolenprotokolls Ihrer Container-App auf ihrer Container-App-Seite anzeigen.

  1. Wechseln Sie in der Azure-Portal zu Ihrer Container-App.

  2. Wählen Sie im Abschnitt Überwachung im Randleistenmenü die Option Protokollstream aus.

  3. Um den Konsolenprotokolldatenstrom anzuzeigen, wählen Sie "Konsole" aus.

    1. Wenn Sie über mehrere Überarbeitungen, Replikate oder Container verfügen, können Sie in den Dropdownmenüs auswählen, um einen Container auszuwählen. Wenn Ihre App nur einen Container hat, können Sie diesen Schritt überspringen.

    Screenshot of Container Apps console log stream from app page.

  4. Um den Systemprotokolldatenstrom anzuzeigen, wählen Sie "System" aus. Der Systemprotokolldatenstrom zeigt die Systemprotokolle für alle ausgeführten Container in Ihrer Container-App an.

    Screenshot of Container Apps system log stream from app page.

Anzeigen von Protokolldatenströmen über die Azure CLI

Sie können die Protokolldatenströme Ihrer Container-App über die Azure CLI mit dem az containerapp logs show Befehl oder dem Umgebungsprotokolldatenstrom Ihrer Container-App mit dem az containerapp env logs show Befehl anzeigen.

Steuern Sie den Protokolldatenstrom mit den folgenden Argumenten:

  • --tail (Standard) Zeigen Sie die letzten n Protokollmeldungen an. Werte sind 0-300 Nachrichten. Der Standardwert ist 20.
  • --follow Zeigen Sie einen kontinuierlichen Livestream der Protokollnachrichten an.

Stream Container-App-Protokolle

Sie können die System- oder Konsolenprotokolle für Ihre Container-App streamen. Verwenden Sie zum Streamen der Container-App-Systemprotokolle das --type Argument mit dem Wert system. Verwenden Sie das --type Argument mit dem Wert console, um die Containerkonsolenprotokolle zu streamen. Der Standardwert ist console.

Anzeigen des Systemprotokolldatenstroms der Container-App

In diesem Beispiel wird das --tail Argument verwendet, um die letzten 50 Systemprotokollmeldungen aus der Container-App anzuzeigen. Ersetzen Sie die <Platzhalter> durch die Werte Ihrer Container-App.

az containerapp logs show \
  --name <ContainerAppName> \
  --resource-group <ResourceGroup> \
  --type system \
  --tail 50

In diesem Beispiel wird ein fortlaufender Livestream von Systemprotokollmeldungen aus der Container-App mithilfe des --follow Arguments angezeigt. Ersetzen Sie die <Platzhalter> durch die Werte Ihrer Container-App.

az containerapp logs show \
  --name <ContainerAppName> \
  --resource-group <ResourceGroup> \
  --type system \
  --follow

Verwenden Ctrl-C oder Cmd-C beenden Sie den Livestream.

Anzeigen des Containerkonsolenprotokolldatenstroms

Um eine Verbindung mit dem Konsolenprotokolldatenstrom eines Containers in einer Container-App mit mehreren Überarbeitungen, Replikaten und Containern herzustellen, schließen Sie die folgenden Parameter in den az containerapp logs show Befehl ein.

Argument Beschreibung
--revision Der Überarbeitungsname.
--replica Der Replikatname in der Überarbeitung.
--container Der Containername, mit dem eine Verbindung hergestellt werden soll.

Sie können die Revisionsnamen mit dem Befehl az containerapp revision list abrufen. Ersetzen Sie die <Platzhalter> durch die Werte Ihrer Container-App.

az containerapp revision list \
  --name <ContainerAppName> \
  --resource-group <ResourceGroup> \
  --query "[].name"

Verwenden Sie den Befehl az containerapp replica list, um die Replikat- und Containernamen abzurufen. Ersetzen Sie die <Platzhalter> durch die Werte Ihrer Container-App.

az containerapp replica list \
  --name <ContainerAppName> \
  --resource-group <ResourceGroup> \
  --revision <RevisionName> \
  --query "[].{Containers:properties.containers[].name, Name:name}"

Livestream der Containerkonsole mit dem az container app show Befehl mit dem --follow Argument. Ersetzen Sie die <Platzhalter> durch die Werte Ihrer Container-App.

az containerapp logs show \
  --name <ContainerAppName> \
  --resource-group <ResourceGroup> \
  --revision <RevisionName> \
  --replica <ReplicaName> \
  --container <ContainerName> \
  --type console \
  --follow

Verwenden Ctrl-C oder Cmd-C beenden Sie den Livestream.

Zeigen Sie die letzten 50 Konsolenprotokollmeldungen mithilfe des az containerapp logs show Befehls mit dem --tail Argument an. Ersetzen Sie die <Platzhalter> durch die Werte Ihrer Container-App.

az containerapp logs show \
  --name <ContainerAppName> \
  --resource-group <ResourceGroup> \
  --revision <RevisionName> \
  --replica <ReplicaName> \
  --container <ContainerName> \
  --type console \
  --tail 50

Anzeigen des Umgebungssystemprotokolldatenstroms

Verwenden Sie den folgenden Befehl mit dem --follow Argument, um den Live-Systemprotokolldatenstrom aus der Container-Apps-Umgebung anzuzeigen. Ersetzen Sie die <Platzhalter durch Ihre Umgebungswerte> .

az containerapp env logs show \
  --name <ContainerAppEnvironmentName> \
  --resource-group <ResourceGroup> \
  --follow

Verwenden Ctrl-C oder Cmd-C beenden Sie den Livestream.

In diesem Beispiel wird das --tail Argument verwendet, um die letzten 50 Protokollmeldungen des Umgebungssystems anzuzeigen. Ersetzen Sie die <Platzhalter durch Ihre Umgebungswerte> .

az containerapp env logs show \
  --name <ContainerAppName> \
  --resource-group <ResourceGroup> \
  --tail 50