Compartir a través de

Panel de .NET.NET Aspire independiente

  • Artículo

El panel de .NET.NET Aspire proporciona una excelente interfaz de usuario para ver la telemetría. El panel:

  • Se distribuye como una imagen de contenedor que se puede usar con cualquier aplicación habilitada OpenTelemetry.
  • Se puede usar de forma independiente, sin el rest de .NET Aspire.

Captura de pantalla del panel de .NET.NET Aspire que se ejecuta en modo independiente.

Inicio del panel

El panel se inicia mediante la línea de comandos de Docker.

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

El comando Docker anterior:

  • Inicia un contenedor desde la imagen de mcr.microsoft.com/dotnet/aspire-dashboard:9.0.
  • El contenedor expone dos puertos:
    • Asignación del puerto OTLP del panel 18889 al puerto del host 4317. El puerto 4317 recibe datos OpenTelemetry de las aplicaciones. Las aplicaciones envían datos mediante OpenTelemetry Protocol (OTLP).
    • Asignación del puerto del panel 18888 al puerto del host 18888. El puerto 18888 tiene la interfaz de usuario del panel. Vaya a http://localhost:18888 en el explorador para ver el panel.

Inicio de sesión en el panel

Los datos que se muestran en el panel pueden ser confidenciales. De forma predeterminada, el panel está protegido con autenticación que requiere un token para iniciar sesión.

Cuando el panel se ejecuta desde un contenedor independiente, el token de inicio de sesión se imprime en los registros de contenedor. Después de copiar el token resaltado en la página de inicio de sesión, seleccione el botón inicio de sesión de .

Captura de pantalla de los registros de contenedor del panel de .NET.NET Aspire.

Propina

Para evitar el inicio de sesión, puede deshabilitar el requisito de autenticación estableciendo la variable de entorno DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS en true. Hay disponible una configuración adicional, consulte Configuración del panel.

Para obtener más información sobre el inicio de sesión en el panel, consulte Autenticación del panel.

Exploración del panel

El panel ofrece una interfaz de usuario para ver la telemetría. Consulte la documentación para explorar la funcionalidad de telemetría:

Aunque no hay ninguna restricción en el lugar en el que se ejecuta el panel, el panel está diseñado como una herramienta de diagnóstico a corto plazo y desarrollo. El panel conserva la telemetría en memoria, lo que crea algunas limitaciones:

  • La telemetría se quita automáticamente si se superan límites de telemetría.
  • No se conserva la telemetría cuando se reinicia el panel.

El panel también tiene funcionalidad para ver .NET.NET Aspire recursos. Las características de recursos del panel se deshabilitan cuando se ejecuta en modo independiente. Para habilitar la interfaz de usuario de recursos, agregar configuración para un servicio de recursos.

Envío de telemetría al panel

Las aplicaciones envían telemetría al panel mediante OpenTelemetry Protocol (OTLP). El panel debe exponer un puerto para recibir datos de OpenTelemetry y las aplicaciones están configuradas para enviar datos a esa dirección.

Anteriormente se mostró un comando Docker para iniciar el panel. Configuró el contenedor para recibir OpenTelemetry datos en el puerto 4317. La dirección completa del punto de conexión de OTLP es http://localhost:4317.

Configuración del SDK de OpenTelemetry

Las aplicaciones recopilan y envían telemetría mediante el SDK de OpenTelemetry de su idioma.

Importante OpenTelemetry opciones del SDK para configurar:

  • Punto de conexión de OTLP, que debe coincidir con la configuración del panel, por ejemplo, http://localhost:4317.
  • Protocolo OTLP, con el panel que admite actualmente solo elprotocolo OTLP/gRPC de . Configure las aplicaciones para que usen el protocolo grpc.

Para configurar aplicaciones:

  • Uso de las API del SDK de OpenTelemetry dentro de la aplicación o
  • Inicie la aplicación con variables de entorno conocidas:
    • OTEL_EXPORTER_OTLP_PROTOCOL con un valor de grpc.
    • OTEL_EXPORTER_OTLP_ENDPOINT con un valor de http://localhost:4317.

Muestra

Para obtener un ejemplo de uso del panel independiente, consulte la aplicación de ejemplo .NET.NET Aspirepanel independiente.

Pasos siguientes

Configurar el panel de .NET.NET Aspire