Partilhar via


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 .

Captura de ecrã de uma janela de rastreio do .NET Aspire Dashboard.

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.

  1. Aceda ao portal do Azure.

  2. Abra a janela Visão geral do seu aplicativo de contêiner.

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

  4. 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ê.

  5. 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 ou 421 .

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

Visão geral do painel do .NET Aspire