Leia dados em tempo real de aplicativos com o painel Aspire no Aplicativos de Contêiner do Azure

O painel do Aspire exibe dados em tempo real sobre como aplicações e outros recursos estão rodando dentro de um ambiente.

A imagem a seguir é uma captura de tela de uma visualização de rastreamento gerada pelo Painel do Aspire.

Captura de tela de uma janela de rastreamento do Painel do Aspire.

As informações exibidas no painel são provenientes de duas fontes:

  • OpenTelemetry (OTel), uma estrutura de observabilidade de código aberto para coletar traços, métricas e logs de suas aplicações.

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

  • O serviço de recursos Aspire fornece o modelo de recursos da aplicação, status, endpoints e logs do console.

Para mais informações, consulte Telemetria no Aspire e Explorar os recursos do painel.

O painel é protegido contra acesso e modificação não autorizados. Para usar o painel, um usuário precisa ter permissões de ‘Gravação’ ou superior. Em outras palavras, ele precisa ser Colaborador ou Proprietário no ambiente.

Habilitar o painel

Dica

Para ambientes gerenciados pelo Aspire, configure e implante o painel com a CLI do Aspire. Se você tiver problemas usando o portal, crie um problema no repositório Container Apps GitHub.

Você pode habilitar o Painel do Aspire em qualquer aplicativo de contêiner existente usando as etapas a seguir.

  1. Acesse o portal Azure.

  2. Navegue até seu aplicativo contêiner.

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

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

  5. Na página Visão geral do seu aplicativo de contêiner, localize o rótulo do Painel do Aspire . O link habilitar foi substituído por um link 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 Aspire navegando até o ambiente de Aplicativos de Contêiner e selecionando Monitoramento>Opções de log.

Observação

Não há suporte para domínios personalizados para acessar o Painel do Aspire. Você deve usar o nome de domínio padrão fornecido pelo Aplicativos de Contêiner do Azure, como: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

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

az containerapp env dotnet-component create \
  --environment <ENVIRONMENT_NAME> \
  --name aspire-dashboard \
  --resource-group <RESOURCE_GROUP_NAME>

O create comando retorna a URL do painel que você pode abrir em um navegador.

Observação

Não há suporte para domínios personalizados para acessar o Painel do Aspire. Você deve usar o nome de domínio padrão fornecido pelo Aplicativos de Contêiner do Azure, como: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

A integração do ambiente Aplicativos de Contêiner do Azure inclui o painel Aspire por padrão. Para criar e implantar um aplicativo Aspire com o painel:

  1. Crie um aplicativo inicial no Aspire e adicione a integração com Aplicativos de Contêiner do Azure:

    aspire new aspire-starter --name AspireApp --output AspireApp
cd AspireApp
aspire add Aspire.Hosting.Azure.AppContainers

  2. Em AppHost.cs, adicione um ambiente Aplicativos de Contêiner do Azure:

    builder.AddAzureContainerAppEnvironment("aca-env");

  3. Autenticar e implantar:

    az login
aspire deploy

O aspire deploy comando retorna a URL do painel que você pode abrir em um navegador. Para omitir o painel, encadeie .WithDashboard(false) no recurso de ambiente.

Para mais informações, veja Deploy to Aplicativos de Contêiner do Azure e WithDashboard.

Observação

Não há suporte para domínios personalizados para acessar o Painel do Aspire. Você deve usar o nome de domínio padrão fornecido pelo Aplicativos de Contêiner do Azure, como: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

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 um erro 421.

  • Se você encontrar um 421 erro de "Solicitação Mal redirecionada", 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 Azure e pesquise seu ambiente de aplicativo de contêiner.
    • Acesse o Painel de Controle de Acesso (IAM):
      • Clique em Controle de Acesso (IAM) para o ambiente do aplicativo de contêiner.
    • Verifique as 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 você ainda não o fez, siga as etapas restantes para atribuir a função.
    • Atribuição de função explícita: – Clique em 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 o acesso ao painel:
      • Teste tentando acessar o painel do Aspire. Se você continuar recebendo o erro, entre em contato com nossa equipe.

  • Não há suporte para domínios personalizados para acessar o Painel do Aspire. Você deve usar o nome de domínio padrão fornecido pelo Aplicativos de Contêiner do Azure, como: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Conteúdo relacionado

Visão geral do painel do Aspire

  • Última atualização em