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. Abra a janela Visão geral do seu aplicativo de contêiner.

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

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

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