Compartilhar via

Ler dados do aplicativo em tempo real com o Painel do .NET Aspire nos Aplicativos de Contêiner do Azure (versão prévia)

  • Artigo

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.

Captura de tela de uma janela de rastreamento do 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.

  1. Acesse o portal do Azure.

  2. Navegue até seu aplicativo contêiner.

  3. Na página Visão Geral, localize o rótulo Painel do .NET Aspire e selecione habilitar. Essa ação abrirá a página de configurações do Painel do .NET Aspire.

  4. Na página de configurações, ao lado do rótulo Painel do .NET Aspire, marque a caixa de seleção Habilitado. Você pode ignorar as outras configurações dessa página, pois elas se referem ao registro em log e não ao Painel do .NET Aspire.

  5. Na página Visão Geral do seu aplicativo contêiner, localize o rótulo Painel do .NET Aspire. O link de habilitar foi substituído por um link de Abrir painel. Selecione esse link. Talvez seja necessário recarregar a página Visão Geral para que o link apareça.

Você também pode encontrar as configurações do Painel do .NET Aspire navegando até o ambiente de Aplicativos de Contêiner e selecionando Monitoramento>Opções de registro em log.

Você pode habilitar o Painel do .NET Aspire em qualquer ambiente do aplicativo de contêiner existente usando os comandos a seguir. Substitua os valores de <PLACEHOLDERS> pelos seus valores.

az containerapp env dotnet-component create \
  --environment <ENVIRONMENT_NAME> \
  --name aspire-dashboard \
  --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 404 ou 421.

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

    Esse problema ocorre porque as permissões do grupo de segurança não se propagam para o Ambiente de Aplicativo de Contêiner. Para resolver esse problema, certifique-se de atribuir explicitamente uma função de Colaborador ou Proprietário em seu ambiente de Aplicativos de Contêiner. Isso pode ser feito executando as seguintes etapas:

    • Navegue até o Recurso:
      • Abra o Portal do Azure e pesquise seu ambiente de aplicativo de contêiner.
    • Acessar a folha do IAM (Controle de Acesso):
      • Clique no IAM (Controle de Acesso) do ambiente do aplicativo de contêiner.
    • Verificar atribuições de função existentes:
      • Verifique se você (ou sua conta) tem alguma atribuição de função. Observe que as permissões atualmente não se propagam por meio de grupos de segurança.
      • Se não tiver, siga as etapas restantes para atribuir a função.
    • Atribuição de função explícita: – Clique em Adicionar >Adicionar atribuição de função. - Escolha Função: Colaborador ou Proprietário, conforme apropriado para o nível de acesso necessário. - Atribua a função explicitamente à sua conta de usuário (por exemplo, youremail@domain.com).
    • Salvar e Confirmar:
      • Salve as alterações. Verifique se a função está visível na seção Atribuições de Função.
    • Verificar Acesso ao Painel:
      • Teste tentando acessar o painel do Aspire. Se você continuar recebendo o erro, entre em contato com nossa equipe.

Conteúdo relacionado

Visão geral do painel do .NET Aspire