Anzeigen von Protokollstreams in Azure Container-Apps

  • Artikel

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:

Auf Protokollstreams kann über das Azure-Portal oder die Azure CLI zugegriffen werden.

Anzeigen von Protokollstreams über das Azure-Portal

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

Systemprotokollstream der Umgebung

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

  1. Rufen Sie im Azure-Portal Ihre Umgebung auf.

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

    Bildschirmfoto der Container Apps-Umgebungsseite mit Systemprotokollstream

Container App-Protokollstream

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

  1. Navigieren Sie im Azure-Portal zu Ihrer Container-App.

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

  3. Wählen Sie Konsole aus, um den Konsolenprotokollstream anzuzeigen.

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

    Screenshot des Container Apps-Konsolenprotokollstreams von der App-Seite

  4. Wählen Sie System aus um den Systemprotokollstream anzuzeigen. Der Systemprotokollstream zeigt die Systemprotokolle für alle ausgeführten Container in Ihrer Container-App an.

    Screenshot des Container Apps-Systemprotokollprotokollstreams von der App-Seite

Anzeigen von Protokollstreams über die Azure CLI

Sie können die Protokollstreams Ihrer Container-App über die Azure CLI mit dem Befehl az containerapp logs show oder den Systemprotokollstream Ihrer Container-App-Umgebung mit dem Befehl az containerapp env logs show anzeigen.

Steuern Sie den Protokollstream mit den folgenden Argumenten:

  • --tail (Standard) Zeigen Sie die letzten n Protokollmeldungen an. Werte von 0–300 Nachrichten sind möglich. Der Standardwert ist 20.
  • --follow Zeigen Sie einen kontinuierlichen Livestreams der Protokollmeldungen an.

Streamen von Container-App-Protokollen

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

Anzeigen des Systemprotokollstreams der Container-App

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

az containerapp logs show \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --type system \
  --tail 50

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

az containerapp logs show \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --type system \
  --follow

Verwenden Sie Ctrl-C oder Cmd-C, um den Livestream zu beenden.

Anzeigen des Protokollstreams der Containerkonsole

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

Argument Beschreibung
--revision Revisionsname
--replica Replikatname in der Revision
--container Containername, mit dem eine Verbindung hergestellt werden soll

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

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

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

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

Livestream der Containerkonsole mithilfe des Befehls az container app show mit dem Argument --follow. Ersetzen Sie die <PLACEHOLDERS> durch die Werte Ihrer Container-App.

az containerapp logs show \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --revision <REVISION_NAME> \
  --replica <REPLICA_NAME> \
  --container <CONTAINER_NAME> \
  --type console \
  --follow

Verwenden Sie Ctrl-C oder Cmd-C, um den Livestream zu beenden.

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

az containerapp logs show \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --revision <REVISION_NAME> \
  --replica <REPLICA_NAME> \
  --container <CONTAINER_NAME> \
  --type console \
  --tail 50

Anzeigen des Systemprotokollstreams der Umgebung

Verwenden Sie den folgenden Befehl mit dem Argument --follow, um den Livestream des Systemprotokolls aus der Container Apps-Umgebung anzuzeigen. Ersetzen Sie <PLACEHOLDERS> durch Ihre Umgebungswerte.

az containerapp env logs show \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --follow

Verwenden Sie Ctrl-C oder Cmd-C, um den Livestream zu beenden.

In diesem Beispiel wird das Argument --tail verwendet, um die letzten 50 Systemprotokollmeldungen der Umgebung App anzuzeigen. Ersetzen Sie <PLACEHOLDERS> durch Ihre Umgebungswerte.

az containerapp env logs show \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --tail 50

Protokollspeicherungs- und Überwachungsoptionen in Azure Container Apps