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

Das Aspire-Dashboard zeigt Live-Daten darüber an, wie Anwendungen und andere Ressourcen innerhalb einer Umgebung laufen.

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

Screenshot eines Trace-Fensters des Aspire Dashboard.

Die auf dem Dashboard angezeigten Informationen stammen aus zwei Quellen:

  • OpenTelemetry (OTel), ein Open-Source-Observabilitäts-Framework zur Sammlung von Traces, Metriken und Logs aus Ihren Anwendungen.

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

  • Der Aspire-Ressourcendienst stellt das Anwendungsressourcenmodell, den Status, Endpunkte und Konsolenprotokolle bereit.

Weitere Informationen finden Sie unter Telemetrie in Aspire und Explore-Dashboard-Funktionen.

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

Tipp

Für von Aspire verwaltete Umgebungen konfigurieren und bereiten Sie das Dashboard mit der Aspire CLI bereit. Wenn du Probleme mit dem Portal hast, erstelle ein Problem im Container Apps GitHub-Repo.

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

  1. Wechseln Sie zum portal Azure.

  2. Navigieren Sie zu Ihrer Container-App.

  3. Suchen Sie auf der Seite "Übersicht " die Bezeichnung "Aspire Dashboard ", und wählen Sie "Aktivieren" aus. Diese Aktion öffnet die Einstellungsseite des Aspire-Dashboards.

  4. Aktivieren Sie auf der Seite "Einstellungen" neben der Bezeichnung "Aspire Dashboard " das Kontrollkästchen "Aktiviert ". Sie können die anderen Einstellungen auf dieser Seite ignorieren, da sie sich auf die Protokollierung und nicht auf das Aspire Dashboard beziehen.

  5. Auf der Seite "Übersicht" für Ihre Container-App finden Sie die Bezeichnung "Aspire Dashboard ". Der Link "Aktivieren" wurde durch einen Link "Dashboard öffnen " ersetzt. Wählen Sie diese Verknüpfung aus. Möglicherweise müssen Sie die Übersichtsseite neu laden, damit der Link angezeigt wird.

Sie können auch die Einstellungen des Aspire-Dashboards finden, indem Sie zu Ihrer Container-Apps-Umgebung navigieren unddie Optionen für die Überwachungsprotokollierung> auswählen.

Hinweis

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_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Sie können das Aspire-Dashboard in jeder vorhandenen Container-App-Umgebung aktivieren, indem Sie die folgenden Befehle verwenden. Ersetzen Sie <PLACEHOLDERS> durch Ihre eigenen Werte.

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

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

Hinweis

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_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Die Integration der Azure Container Apps-Umgebung enthält standardmäßig das Aspire-Dashboard. Um eine Aspire-App mit dem Dashboard zu erstellen und bereitzustellen:

  1. Erstellen Sie eine Aspire-Starter-App und fügen Sie die Integration von Azure Container Apps hinzu:

    aspire new aspire-starter --name AspireApp --output AspireApp
cd AspireApp
aspire add Aspire.Hosting.Azure.AppContainers

  2. Fügen Sie in AppHost.cs eine Azure-Container-Apps-Umgebung hinzu:

    builder.AddAzureContainerAppEnvironment("aca-env");

  3. Authentifizieren und bereitstellen:

    az login
aspire deploy

Der aspire deploy Befehl gibt die Dashboard-URL zurück, die Sie in einem Browser öffnen können. Um das Dashboard wegzulassen, hängen Sie .WithDashboard(false) an die Umgebungsressource an.

Weitere Informationen finden Sie unter Deploy to Azure Container Apps und WithDashboard.

Hinweis

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_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

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_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Zugehöriger Inhalt

Übersicht über das Aspire-Dashboard

  • Zuletzt aktualisiert um