Painel de .NET.NET Aspire autônomo

O painel de .NET.NET Aspire fornece uma ótima interface do usuário para exibir a telemetria. O painel:

• É fornecida como uma imagem de contêiner que pode ser usada com qualquer aplicativo habilitado para OpenTelemetry.
• Pode ser usado autônomo, sem o rest de .NET Aspire.

Iniciar o painel

O painel é iniciado usando a linha de comando Docker.

Bash

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

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. O 4317 de porta recebe dados OpenTelemetry de aplicativos. Os aplicativos enviam dados usandoOTLP (Protocolo ).
  • 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 exibir o painel.

Fazer logon 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 logon.

Quando o painel é executado de um contêiner autônomo, o token de logon é impresso nos logs de contêiner. Depois de copiar o token realçado para a página de logon, selecione o botão Logon.

Ponta

Para evitar o logon, você pode desabilitar o requisito de autenticação definindo a variável de ambiente DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS como true. A configuração adicional está disponível, consultede configuração do Painel de .

Para obter mais informações sobre como fazer logon no painel, consultede autenticação do Painel de .

Explorar o painel

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

• de logs estruturados
• da página rastreamentos
• página Métricas

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

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

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

Enviar telemetria para o painel

Os aplicativos enviam telemetria para o painel usandoOTLP (Protocolo ). 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 ado painel. Ele configurou o contêiner para receber dados 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 OpenTelemetrydo SDK de do idioma.

Opções importantes do SDK do OpenTelemetry para configurar:

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

Para configurar aplicativos:

• Usar as APIs do SDK OpenTelemetry dentro do 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 Aspireautônomo.

Próximas etapas

Configurar o painel de .NET.NET Aspire