Ler dados do aplicativo em tempo real com o Painel do .NET Aspire nos Aplicativos de Contêiner do Azure (versão prévia)
O Painel do .NET Aspire exibe dados dinâmicos sobre como 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 são provenientes de duas fontes:
OpenTelemetry (OTel), uma biblioteca de software livre para rastrear rastreamentos, métricase logs para seus aplicativos. Esta documentação fornece mais informações sobre como o painel Aspire se integra ao OTel.
- Rastreamentos acompanham o ciclo de vida das solicitações – como uma solicitação é recebida e processada conforme ela se move entre diferentes partes do aplicativo. Essas informações são úteis para identificar gargalos e outros problemas.
- Métricas são medidas em tempo real da integridade geral e do desempenho da infraestrutura, por exemplo, quantos recursos de CPU são consumidos e quantas transações o aplicativo manipula por segundo. Essas informações são úteis para entender a capacidade de resposta do aplicativo ou identificar sinais de alerta antecipados de problemas de desempenho.
- Logs registram todos os eventos e erros que ocorrem durante a execução do aplicativo. Essas informações são úteis para localizar quando ocorreu um problema e eventos correlacionados.
A API do Kubernetes fornece informações sobre os pods do Kubernetes subjacentes nos quais seu aplicativo está sendo executado e seus logs.
O painel é protegido contra acesso e modificação não autorizados. Para usar o painel, um usuário deve ter permissões de "Gravação" ou superior - em outras palavras, ele deve ser um Colaborador ou Proprietário no ambiente.
Habilitar o painel
Dica
Embora você tenha o portal como uma opção, a abordagem recomendada para habilitar seu painel é com azd. Se você encontrar problemas usando o portal, crie um problema no repositório do GitHub dos Aplicativos de Contêiner.
Você pode habilitar o Painel do .NET Aspire em qualquer aplicativo de contêiner existente usando as etapas a seguir.
Acesse o portal do Azure.
Abra a janela Visão geral do seu aplicativo de contêiner.
Localize o rótulo do Painel do .NET Aspire e selecione o link Habilitar.
Essa ação abrirá a janela de configurações do Painel do .NET Aspire.
Ao lado do rótulo do Painel do .NET Aspire, marque a caixa de seleção Habilitado.
Agora a URL do Painel do .NET Aspire já exibida para você.
Selecione a URL do painel.
Você pode habilitar o Painel do .NET Aspire em qualquer ambiente do aplicativo de contêiner existente usando os comandos a seguir.
az containerapp env dotnet-component create \
--environment <ENVIRONMENT_NAME> \
--name <CONTAINER_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
O comando create retorna a URL do painel que você pode abrir em um navegador.
Você pode habilitar o Painel do .NET Aspire em qualquer aplicativo de contêiner existente usando as etapas a seguir.
dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up
O comando up retorna a URL do painel que você pode abrir em um navegador.
Solução de problemas
Consulte os seguintes itens se tiver problemas ao habilitar seu painel:
O portal pode levar até dois minutos para ativar o painel. Se você tentar ir para o painel antes que ele esteja pronto, o servidor retornará um erro
404ou421.Se você encontrar um erro
421“Misdirected Request”, feche a janela do navegador, aguarde alguns minutos e tente novamente.Você pode receber um erro de autenticação ao acessar o painel com o texto, “Não foi possível autenticar o usuário com o recurso solicitado”.
Para resolver esse problema, conceda as funções Microsoft.App/managedEnvironments/write, Colaborador ou Proprietário em seu ambiente dos Aplicativos de Contêiner.