Поделиться через

Автономная панель мониторинга .NET.NET Aspire

  • Статья

Панель мониторинга .NET.NET Aspire предоставляет отличный пользовательский интерфейс для просмотра телеметрии. Панель мониторинга:

  • Поставляется как образ контейнера, который можно использовать с любым OpenTelemetry включенным приложением.
  • Можно использовать автономный, без остальных .NET.NET Aspire.

Снимок экрана панели мониторинга .NET.NET Aspire, работающей в автономном режиме.

Запуск панели мониторинга

Панель мониторинга запущена с помощью командной строки Docker.

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

Предыдущая команда Docker:

  • Запускает контейнер из образа mcr.microsoft.com/dotnet/aspire-dashboard:9.0.
  • Контейнер предоставляет два порта:
    • Сопоставление порта OTLP панели мониторинга с 18889 порта узла 4317. Порт 4317 получает OpenTelemetry данные из приложений. Приложения отправляют данные с помощьюпротокола (OTLP).
    • Сопоставление порта панели мониторинга 18888 с портом узла 18888. Порт 18888 имеет пользовательский интерфейс панели мониторинга. Перейдите к http://localhost:18888 в браузере, чтобы просмотреть панель мониторинга.

Вход на панель мониторинга

Данные, отображаемые на панели мониторинга, могут быть конфиденциальными. По умолчанию панель мониторинга защищена с помощью проверки подлинности, требующей входа маркера.

При запуске панели мониторинга из автономного контейнера маркер входа выводится в журналы контейнеров. После копирования выделенного токена на страницу входа нажмите кнопку "Вход".

снимок экрана журналов контейнеров панели мониторинга .NET.NET Aspire.

Кончик

Чтобы избежать входа, можно отключить требование проверки подлинности, установив для переменной среды DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS значение true. Доступна дополнительная конфигурация, см. сведения оконфигурации панели мониторинга .

Дополнительные сведения о входе на панель мониторинга см. в проверки подлинности панели мониторинга.

Изучение панели мониторинга

Панель мониторинга предоставляет пользовательский интерфейс для просмотра телеметрии. Ознакомьтесь с документацией по функциям телеметрии:

  • страница структурированных журналов
  • страницы трассировки
  • страница метрик

Хотя нет ограничений на то, где выполняется панель мониторинга, панель мониторинга разработана как средство разработки и краткосрочной диагностики. Панель мониторинга сохраняет данные телеметрии в памяти, что создает некоторые ограничения:

  • Данные телеметрии автоматически удаляются при превышении ограничений телеметрии.
  • При перезапуске панели мониторинга данные телеметрии не сохраняются.

Панель мониторинга также имеет функциональные возможности для просмотра .NET.NET Aspire ресурсов. Функции ресурсов панели мониторинга отключены при запуске в автономном режиме. Чтобы включить пользовательский интерфейс ресурсов, добавить конфигурацию для службы ресурсов.

Отправка данных телеметрии на панель мониторинга

Приложения отправляют данные телеметрии на панель мониторинга с помощьюпротокола (OTLP). Панель мониторинга должна предоставлять порт для получения OpenTelemetry данных, а приложения настроены для отправки данных в этот адрес.

Команда Docker была показана ранее, чтобы запуститьпанели мониторинга. Он настроит контейнер для получения OpenTelemetry данных через порт 4317. Полный адрес конечной точки OTLP http://localhost:4317.

Настройка пакета SDK для OpenTelemetry

Приложения собирают и отправляют данные телеметрии с помощью OpenTelemetrySDK языка.

Важные параметры пакета SDK OpenTelemetry для настройки:

  • Конечная точка OTLP, которая должна соответствовать конфигурации панели мониторинга, например http://localhost:4317.
  • Протокол OTLP, с панелью мониторинга, поддерживающей только протокол OTLP/gRPC, который в настоящее время поддерживает только протокол OTLP/gRPC. Настройте приложения для использования протокола grpc.

Чтобы настроить приложения, выполните приведенные действия.

  • Используйте API пакета SDK OpenTelemetry в приложении или
  • Запустите приложение с известными переменными среды:
    • OTEL_EXPORTER_OTLP_PROTOCOL со значением grpc.
    • OTEL_EXPORTER_OTLP_ENDPOINT со значением http://localhost:4317.

Образец

Пример использования автономной панели мониторинга см. в примере автономной панели мониторинга .NET.NET Aspire.

Дальнейшие действия

.NET панели мониторинга .NET Aspire