Lesen Sie Echtzeit-App-Daten mit dem Aspire-Dashboard in Azure Container Apps

Das Aspire Dashboard zeigt Livedaten darüber an, wie Anwendungen und andere Ressourcen in einer Umgebung ausgeführt werden.

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

Die auf dem Dashboard angezeigten Informationen stammen aus zwei Quellen:

• OpenTelemetry (OTel), eine Open-Source-Bibliothek zum Nachverfolgen von Traces, Metriken und Protokollen für Ihre Anwendungen. Diese Dokumentation enthält weitere Informationen dazu, wie das Aspire-Dashboard in OTel integriert wird.

  • Ablaufverfolgungen verfolgen den Lebenszyklus von Anforderungen – wie eine Anforderung empfangen und verarbeitet wird, während sie zwischen verschiedenen Teilen der Anwendung verschoben wird. Diese Informationen sind nützlich, um Engpässe und andere Probleme zu identifizieren.
  • Metriken sind Echtzeitmessungen der allgemeinen Integrität und Leistung der Infrastruktur , z. B. wie viele CPU-Ressourcen verbraucht werden und wie viele Transaktionen die Anwendung pro Sekunde verarbeitet. Diese Informationen sind hilfreich, um die Reaktionsfähigkeit Ihrer App zu verstehen oder frühe Warnhinweise auf Leistungsprobleme zu erkennen.
  • Protokolliert alle Ereignisse und Fehler, die während der Ausführung der Anwendung stattfinden. Diese Informationen sind hilfreich, um herauszufinden, wann ein Problem aufgetreten ist, sowie korrelierte Ereignisse.

• Die Kubernetes-API enthält Informationen zu den zugrunde liegenden Kubernetes-Pods, auf denen Ihre Anwendung ausgeführt wird, und deren Protokolle.

Das Dashboard ist vor unbefugtem Zugriff und Änderungen geschützt. Um das Dashboard zu verwenden, muss eine benutzende Person mindestens über die Berechtigung „Schreiben“ verfügen, d. h., sie muss mitwirkende oder besitzende Person in der Umgebung sein.

Aktivieren Sie das Dashboard

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

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

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“.

  Dieses Problem tritt auf, da Berechtigungen für Sicherheitsgruppen nicht an die Container-App-Umgebung weitergegeben werden. Um dieses Problem zu lösen, stellen Sie sicher, dass Sie sich explizit eine Rolle "Mitwirkender " oder "Besitzer " in Ihrer Container-Apps-Umgebung zuweisen. Dies kann durch die folgenden Schritte durchgeführt werden:

  • Navigieren Sie zur Ressource:
    • Öffnen Sie das Azure Portal, und suchen Sie nach Ihrer Container-App-Umgebung.
  • Greifen Sie auf das Zugriffssteuerungs-Blade (IAM) zu:
    • Klicken Sie auf Access Control (IAM) für die Container-App-Umgebung.
  • Überprüfen vorhandener Rollenzuweisungen:
    • Überprüfen Sie, ob Ihnen (oder Ihrem Konto) Rollen zugewiesen sind. Beachten Sie, dass Berechtigungen derzeit nicht über Sicherheitsgruppen verteilt werden.
    • Wenn Sie dies nicht sind, führen Sie die verbleibenden Schritte aus, um die Rolle zuzuweisen.
  • Explizite Rollenzuweisung: - Klicken Sie auf "Rollenzuweisung hinzufügen > ". – Wählen Sie die Rolle aus: Mitwirkender oder Besitzer, je nach Ihrem erforderlichen Zugriffsniveau. - Weisen Sie die Rolle explizit Ihrem Benutzerkonto zu (z. B. youremail@domain.com).
  • Speichern und Bestätigen:
    • Speichern Sie die Änderungen. Stellen Sie sicher, dass die Rolle im Abschnitt „Rollenzuweisungen“ sichtbar ist.
  • Dashboardzugriff überprüfen:
    • Testen Sie das, indem Sie versuchen, auf das Aspire-Dashboard zuzugreifen. Wenn Sie den Fehler weiterhin erhalten, wenden Sie sich bitte an unser Team.

• Benutzerdefinierte Domänen werden für den Zugriff auf das Aspire Dashboard nicht unterstützt. Sie müssen den von Azure Container Apps bereitgestellten Standarddomänennamen verwenden, z. B.: https://<DOTNET_COMPONENT_NAMNE>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Zugehöriger Inhalt

Übersicht über das Aspire-Dashboard