Partilhar via

Painel de .NET.NET Aspire autônomo

  • Artigo

O painel .NET.NET Aspire fornece uma ótima interface do usuário para visualização de telemetria. O painel:

  • Envia como uma imagem de contêiner que pode ser usada com qualquer aplicativo habilitado para OpenTelemetry.
  • Pode ser usado de forma independente, sem a rest de .NET Aspire.

Uma captura de tela do painel de .NET.NET Aspire em execução no modo autônomo.

Iniciar o painel

O painel é iniciado usando a linha de comando Docker.

docker run --rm -it -d \
    -p 18888:18888 \
    -p 4317:18889 \
    --name aspire-dashboard \
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

O comando Docker anterior:

  • Inicia um contêiner a partir da imagem mcr.microsoft.com/dotnet/aspire-dashboard:9.0.
  • O contêiner expõe duas portas:
    • Mapeando a porta OTLP do painel 18889 para a porta do host 4317. A porta 4317 recebe dados OpenTelemetry de aplicativos. Os aplicativos enviam dados usando o Protocolo OpenTelemetry (OTLP).
    • Mapeando a porta do painel 18888 para a porta do host 18888. A porta 18888 tem a interface do usuário do painel. Navegue até http://localhost:18888 no navegador para visualizar o painel.

Login no painel

Os dados exibidos no painel podem ser confidenciais. Por padrão, o painel é protegido com autenticação que requer um token para fazer login.

Quando o painel é executado a partir de um contêiner autônomo, o token de login é impresso nos logs do contêiner. Depois de copiar o token destacado para a página de login, selecione o botão de login.

Captura de tela dos logs de contêiner do painel .NET.NET Aspire.

Dica

Para evitar o login, você pode desabilitar o requisito de autenticação definindo a variável de ambiente DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS como true. Configuração adicional está disponível, consulte Configuração do painel.

Para obter mais informações sobre como fazer login no painel, consulte Autenticação do painel.

Explore o painel

O painel oferece uma interface do usuário para visualização de telemetria. Consulte a documentação para explorar a funcionalidade de telemetria:

Embora não haja nenhuma restrição sobre onde o painel é executado, o painel é projetado como uma ferramenta de desenvolvimento e diagnóstico de curto prazo. O painel persiste a telemetria na memória, o que cria algumas limitações:

  • A telemetria é automaticamente removida se limites de telemetria forem excedidos.
  • Nenhuma telemetria é mantida quando o painel é reiniciado.

O painel também tem funcionalidade para visualizar .NET.NET Aspire recursos. Os recursos do painel são desativados quando ele é executado no modo autônomo. Para habilitar a interface do usuário de recursos, adicionar configuração para um serviço de recursos.

Enviar telemetria para o painel

Os aplicativos enviam telemetria para o painel usando o protocolo OpenTelemetry (OTLP). O painel deve expor uma porta para receber dados OpenTelemetry e os aplicativos são configurados para enviar dados para esse endereço.

Um comando Docker foi mostrado anteriormente para iniciar o painel. Ele configurou o contêiner para receber dados de OpenTelemetry na porta 4317. O endereço completo do ponto de extremidade OTLP é http://localhost:4317.

Configurar OpenTelemetry SDK

Os aplicativos coletam e enviam telemetria usando SDK de OpenTelemetry de seu idioma.

Importante OpenTelemetry opções do SDK para configurar:

  • Ponto de extremidade OTLP, que deve corresponder à configuração do painel, por exemplo, http://localhost:4317.
  • Protocolo OTLP, com o painel atualmente suportando apenas o protocolo OTLP/gRPC . Configure aplicativos para usar o protocolo grpc.

Para configurar aplicativos:

  • Use as APIs do SDK OpenTelemetry no aplicativo ou
  • Inicie o aplicativo com variáveis de ambiente conhecidas:
    • OTEL_EXPORTER_OTLP_PROTOCOL com um valor de grpc.
    • OTEL_EXPORTER_OTLP_ENDPOINT com um valor de http://localhost:4317.

Amostra

Para obter um exemplo de como usar o painel autônomo, consulte o aplicativo de exemplo de painel .NET.NET Aspire autônomo.

Próximos passos

Configurar o painel .NET.NET Aspire