Leia dados de aplicativos em tempo real com o Painel do .NET Aspire nos Aplicativos de Contêiner do Azure (visualização)
O Painel do .NET Aspire exibe dados em tempo real sobre como os aplicativos e outros recursos estão sendo executados em um ambiente.
A imagem a seguir é uma captura de tela de uma visualização de rastreamento gerada pelo Painel do .NET Aspire .
As informações exibidas no painel vêm de duas fontes:
OpenTelemetry (OTel), uma biblioteca de código aberto para rastrear rastreamentos, métricas e logs para seus aplicativos. Esta documentação fornece mais informações sobre como o painel de instrumentos do Aspire se integra com o OTel.
- Os rastreamentos rastreiam o ciclo de vida das solicitações - como uma solicitação é recebida e processada à medida que se move entre diferentes partes do aplicativo. Estas informações são úteis para identificar estrangulamentos e outras questões.
- As métricas são medições em tempo real da integridade geral e do desempenho da infraestrutura - por exemplo, quantos recursos da CPU são consumidos e quantas transações o aplicativo lida por segundo. Essas informações são úteis para entender a capacidade de resposta do seu aplicativo ou identificar sinais de alerta precoce de problemas de desempenho.
- Os logs registram todos os eventos e erros que ocorrem durante a execução do aplicativo. Essas informações são úteis para encontrar quando ocorreu um problema e eventos correlacionados.
A API do Kubernetes fornece informações sobre os pods Kubernetes subjacentes nos quais seu aplicativo está sendo executado e seus logs.
O painel está protegido contra acesso e modificação não autorizados. Para usar o painel, um usuário deve ter permissões de 'Gravação' ou superiores - em outras palavras, ele deve ser um Colaborador ou Proprietário no ambiente.
Ativar o dashboard
Gorjeta
Embora você tenha o portal como opção, a abordagem recomendada para habilitar seu painel é com azd. Se você tiver problemas ao usar o portal, crie um problema no repositório GitHub de Aplicativos de Contêiner.
Pode ativar o Painel do .NET Aspire em qualquer aplicação de contentor existente utilizando os seguintes passos.
Aceda ao portal do Azure.
Abra a janela Visão geral do seu aplicativo de contêiner.
Encontre o rótulo do Painel do .NET Aspire e selecione o link ativar .
Esta ação abre a janela de configurações do .NET Aspire Dashboard.
Ao lado do rótulo do Painel do .NET Aspire , marque a caixa de seleção Habilitado .
Agora o URL do Painel do .NET Aspire é exibido para você.
Selecione o URL para o seu painel.
Pode ativar o Painel do .NET Aspire em qualquer ambiente de aplicação de contentor existente utilizando os seguintes comandos.
az containerapp env dotnet-component create \
--environment <ENVIRONMENT_NAME> \
--name <CONTAINER_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
O create
comando retorna a URL do painel que você pode abrir em um navegador.
Pode ativar o Painel do .NET Aspire em qualquer aplicação de contentor existente utilizando os seguintes passos.
dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up
O up
comando retorna a URL do painel que você pode abrir em um navegador.
Resolução de Problemas
Consulte os seguintes itens se tiver problemas ao ativar o seu painel:
O portal pode levar até dois minutos para que o painel seja ativado. Se você tentar ir para o painel antes que ele esteja pronto, o servidor retornará um
404
erro ou421
.Se encontrar um
421
erro de "Pedido Mal Direcionado", feche a janela do navegador, aguarde alguns minutos e tente novamente.Você pode receber um erro de autenticação ao acessar o painel que diz: "Não foi possível autenticar o usuário com o recurso solicitado".
Para resolver esse problema, certifique-se de conceder as funções de Microsoft.App/managedEnvironments/write, Colaborador ou Proprietário em seu ambiente de Aplicativos de Contêiner.