Lesen von Echtzeitappdaten mit .NET Aspire-Dashboard in Azure Container Apps (Vorschau)

Das .NET Aspire-Dashboard enthält Informationen dazu, wie Ihre App sowohl auf umgebungs- als auch auf einzelner Appebene ausgeführt wird, wodurch Sie Anomalien in Echtzeit erkennen und Fehler debuggen können. Das Dashboard zeigt Daten für alle Container Apps an, die Teil Ihres Projekts sind, unabhängig von Sprache oder Laufzeit.

Die folgende Abbildung ist ein Screenshot einer Ablaufverfolgungsvisualisierung, die vom .NET Aspire-Dashboard generiert wird.

Aktivieren Sie das Dashboard

Tipp

Das Portal ist zwar eine Option, es wird aber empfohlen, das Dashboard mit azd zu aktivieren. Wenn bei der Verwendung des Portals Probleme auftreten, erstellen Sie im GitHub-Repository für Container Apps ein Problem.

Sie können das .NET Aspire-Dashboard in jeder vorhandenen Container-App aktivieren, indem Sie die folgenden Schritte ausführen.

1. Öffnen Sie das Azure-Portal.

2. Öffnen Sie das Fenster Übersicht ihrer Container-App.

3. Suchen Sie die Bezeichnung .NET Aspire-Dashboard, und wählen Sie den Link Aktivieren aus.

   Diese Aktion öffnet das Fenster „Einstellungen des .NET Aspire-Dashboards“.

4. Markieren Sie neben der Bezeichnung .NET Aspire-Dashboard das Kontrollkästchen Aktiviert.

   Jetzt wird die .NET Aspire-Dashboard-URL für Sie angezeigt.

5. Wählen Sie die URL zu Ihrem Dashboard aus.

Sie können das .NET Aspire-Dashboard für jede vorhandene Container-App mit den folgenden Befehlen aktivieren.

az containerapp env dotnet-component create \
  --environment <ENVIRONMENT_NAME> \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

Der Befehl create gibt die Dashboard-URL zurück, die Sie in einem Browser öffnen können.

Sie können das .NET Aspire-Dashboard in jeder vorhandenen Container-App aktivieren, indem Sie die folgenden Schritte ausführen.

dotnet new aspire-starter
azd init --location westus2
azd config set alpha.aspire.dashboard on
azd up

Der Befehl up gibt die Dashboard-URL zurück, die Sie in einem Browser öffnen können.

Problembehandlung

Ziehen Sie die folgenden Informationen heran, wenn beim Aktivieren Ihres Dashboards Probleme auftreten:

• Im Portal kann es bis zu zwei Minuten dauern, bis das Dashboard aktiviert wird. Wenn Sie versuchen, zum Dashboard zu wechseln, bevor es bereit ist, gibt der Server einen 404- oder 421-Fehler zurück.

• Wenn ein 421-Fehler „Fehlgeleitete Anforderung“ auftritt, schließen Sie das Browserfenster, warten Sie einige Minuten, und versuchen Sie es erneut.

• Möglicherweise erhalten Sie beim Zugriff auf das Dashboard einen Authentifizierungsfehler mit dem folgenden Text: „Benutzer konnte mit der angeforderten Ressource nicht authentifiziert werden“.

  Um dieses Problem zu lösen, müssen Sie für Ihre Container Apps-Umgebung die Rollen Microsoft.App/managedEnvironments/write, Mitwirkender oder Besitzer zuweisen.

Zugehöriger Inhalt

Übersicht über das .NET Aspire-Dashboard