Leia dados de aplicações em tempo real com o painel Aspire no Azure Container Apps

O painel do Aspire apresenta dados em tempo real sobre como as aplicações e outros recursos estão a funcionar num ambiente.

A imagem seguinte é uma captura de ecrã de uma visualização de rastreio gerada pelo Painel de Controlo do Aspire .

Captura de ecrã de uma janela de rastreamento do Aspire Dashboard.

As informações exibidas no painel vêm de duas fontes:

  • OpenTelemetry (OTel), uma estrutura de observabilidade open-source para recolher traços, métricas e logs das suas aplicações.

    • Os rastreios acompanham o ciclo de vida dos pedidos – como um pedido é recebido e processado à medida que se move entre diferentes partes da aplicação. Estas informações são úteis para identificar gargalos e outras questões.
    • As métricas são medições em tempo real da saúde geral e desempenho da infraestrutura – por exemplo, quantos recursos da CPU são consumidos e quantas transações a aplicação gere 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 registos registam todos os eventos e erros que ocorrem durante o funcionamento da aplicação. Essas informações são úteis para encontrar quando ocorreu um problema e eventos correlacionados.

  • O serviço de recursos do Aspire fornece o modelo de recursos da aplicação, o estado, os pontos finais e os registos da consola.

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

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

Para ambientes geridos pela Aspire, configure e implemente o painel com a CLI da Aspire. Se tiveres problemas a usar o portal, cria um problema no repositório Container Apps GitHub.

Pode ativar o Painel de Controlo do Aspire em qualquer aplicação de contentores existente utilizando os seguintes passos.

  1. Vai ao portal Azure.

  2. Navegue até seu aplicativo de contêiner.

  3. Na página de Visão Geral , encontre a etiqueta do Aspire Dashboard e selecione ativar. Esta ação abre a página de definições do Aspire Dashboard.

  4. Na página de definições, ao lado do rótulo Aspire Dashboard, selecione a caixa de seleção Ativada. Pode ignorar as outras definições nesta página, uma vez que se referem ao registo e não ao Painel Aspire.

  5. Na página de Visão Geral da sua aplicação de contentores, encontre a etiqueta do Aspire Dashboard . O link de ativação foi substituído por um link do painel aberto . Selecione esta ligação. Pode ser necessário recarregar a página de Visão Geral para que o link apareça.

Também pode encontrar as definições do Aspire Dashboard navegando até ao ambiente de Aplicações em Contêiner e selecionando Monitorização>opções de Registo.

Observação

Não há suporte para domínios personalizados para acessar o Painel do Aspire . Deve usar o nome de domínio padrão fornecido por Azure Container Apps, tais como: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Pode ativar o Painel de Controlo do Aspire em qualquer ambiente de aplicação de contentor existente utilizando os seguintes comandos. Substitua o <PLACEHOLDERS> pelos seus valores.

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

O create comando devolve o URL do dashboard que podes abrir num navegador.

Observação

Não há suporte para domínios personalizados para acessar o Painel do Aspire . Deve usar o nome de domínio padrão fornecido por Azure Container Apps, tais como: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

A integração com o ambiente Azure Container Apps inclui o dashboard Aspire por defeito. Para criar e implementar uma aplicação Aspire com o dashboard:

  1. Crie uma aplicação inicial Aspire e adicione a integração com Azure Container Apps:

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

  2. Em AppHost.cs, adicione um ambiente Azure Container Apps:

    builder.AddAzureContainerAppEnvironment("aca-env");

  3. Autenticar e implementar:

    az login
aspire deploy

O aspire deploy comando devolve o URL do dashboard que podes abrir num navegador. Para omitir o dashboard, encadeie .WithDashboard(false) o recurso de ambiente.

Para mais informações, consulte Deploy to Azure Container Apps e WithDashboard.

Observação

Não há suporte para domínios personalizados para acessar o Painel do Aspire . Deve usar o nome de domínio padrão fornecido por Azure Container Apps, tais como: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

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 tentar aceder ao dashboard antes de estar pronto, o servidor devolve um erro 404 ou 421.

  • Se encontrar um 421 erro de "Pedido Mal Direcionado", feche a janela do navegador, espere 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".

    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 este problema, certifique-se de que lhe atribui explicitamente um papel de Contribuidor ou Proprietário no seu ambiente de Aplicações de Container. Isso pode ser feito através das seguintes etapas:

    • Navegue até ao Recurso:
      • Abra o portal do Azure e procure o ambiente da sua aplicação de contentores.
    • Aceda ao Painel de Controlo de Acesso (IAM):
      • Clique em Controlo de Acesso (IAM) para o ambiente da aplicação container.
    • Verifique as atribuições de funções existentes:
      • Verifique se você (ou sua conta) recebeu alguma função. Observe que, atualmente, as permissões não se propagam por meio de grupos de segurança.
      • Se não estiver, siga as etapas restantes para atribuir a função.
    • Atribuição explícita de funções: - Clique em adicionar > atribuição de funções. - Escolher Função: Contribuinte ou Proprietário, conforme apropriado ao nível de acesso exigido. - Atribuir o papel explicitamente à sua conta de utilizador (por exemplo, youremail@domain.com).
    • Guardar e confirmar:
      • Guarde as alterações. Verifique se a função está visível na seção Atribuições de função.
    • Verificar o Acesso ao Dashboard:
      • Teste tentando aceder ao painel do Aspire . Se você continuar a receber o erro, entre em contato com nossa equipe.

  • Não há suporte para domínios personalizados para acessar o Painel do Aspire . Deve usar o nome de domínio padrão fornecido por Azure Container Apps, tais como: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Conteúdos relacionados

Visão geral do dashboard Aspire

  • Última atualização a