Realtime-app-gegevens lezen met .NET Aspire Dashboard in Azure Container Apps (preview)
In het .NET Aspire-dashboard worden livegegevens weergegeven over de werking van toepassingen en andere resources in een omgeving.
De volgende afbeelding is een schermopname van een traceringsvisualisatie die wordt gegenereerd door het .NET Aspire Dashboard.
De informatie die op het dashboard wordt weergegeven, is afkomstig uit twee bronnen:
OpenTelemetry (OTel), een opensource-bibliotheek voor het bijhouden van traceringen, metrische gegevens en logboeken voor uw toepassingen. In deze documentatie vindt u meer informatie over de integratie van het Aspire-dashboard met OTel.
- Traceringen volgen de levenscyclus van aanvragen: hoe een aanvraag wordt ontvangen en verwerkt wanneer deze tussen verschillende onderdelen van de toepassing wordt verplaatst. Deze informatie is handig voor het identificeren van knelpunten en andere problemen.
- Metrische gegevens zijn realtimemetingen van de algemene status en prestaties van de infrastructuur, bijvoorbeeld hoeveel CPU-resources worden verbruikt en hoeveel transacties de toepassing per seconde verwerkt. Deze informatie is handig voor inzicht in de reactiesnelheid van uw app of het identificeren van vroegtijdige waarschuwingssignalen van prestatieproblemen.
- Logboeken registreren alle gebeurtenissen en fouten die plaatsvinden tijdens het uitvoeren van de toepassing. Deze informatie is handig om te vinden wanneer er een probleem is opgetreden en gecorreleerde gebeurtenissen.
De Kubernetes-API biedt informatie over de onderliggende Kubernetes-pods waarop uw toepassing wordt uitgevoerd en de bijbehorende logboeken.
Het dashboard is beveiligd tegen onbevoegde toegang en wijziging. Als u het dashboard wilt gebruiken, moet een gebruiker schrijfmachtigingen of hoger hebben, met andere woorden: ze moeten inzender of eigenaar zijn in de omgeving.
Het dashboard inschakelen
Tip
Hoewel u de portal als optie hebt, is de aanbevolen methode voor het inschakelen van uw dashboard met azd. Als u problemen ondervindt met het gebruik van de portal, maakt u een probleem in de GitHub-opslagplaats van Container Apps.
U kunt het .NET Aspire Dashboard inschakelen voor elke bestaande container-app met behulp van de volgende stappen.
Ga naar de Azure Portal.
Open het venster Overzicht van uw container-app.
Zoek het label .NET Aspire Dashboard en selecteer de koppeling inschakelen .
Met deze actie wordt het venster instellingen voor .NET Aspire Dashboard geopend.
Schakel naast het label .NET Aspire Dashboard het selectievakje Ingeschakeld in .
Nu wordt de URL van het .NET Aspire-dashboard voor u weergegeven.
Selecteer de URL naar uw dashboard.
U kunt het .NET Aspire-dashboard inschakelen in elke bestaande container-app-omgeving met behulp van de volgende opdrachten.
az containerapp env dotnet-component create \
--environment <ENVIRONMENT_NAME> \
--name <CONTAINER_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
De create opdracht retourneert de dashboard-URL die u in een browser kunt openen.
U kunt het .NET Aspire Dashboard inschakelen voor elke bestaande container-app met behulp van de volgende stappen.
dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up
De up opdracht retourneert de dashboard-URL die u in een browser kunt openen.
Probleemoplossing
Raadpleeg de volgende items als u problemen ondervindt met het inschakelen van uw dashboard:
Het kan tot twee minuten duren voordat het dashboard is geactiveerd. Als u naar het dashboard wilt gaan voordat het klaar is, retourneert de server een
404of421meer fouten.Als er een
421fout 'Verkeerd gericht verzoek' optreedt, sluit u het browservenster, wacht u enkele minuten en probeert u het opnieuw.Mogelijk ontvangt u een verificatiefout bij het openen van het dashboard met de tekst 'Kan gebruiker niet verifiëren met aangevraagde resource'.
U kunt dit probleem oplossen door ervoor te zorgen dat u de rollen Microsoft.App/managedEnvironments/write, Inzender of Eigenaar verleent in uw Container Apps-omgeving.