Настройка демо-приложения Java и сбор телеметрии
Перед началом работы
Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:
- Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
- На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе
ACTIVEилиTRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.
Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.
Подробнее об облаках и каталогах.
Настройка демо-приложения и передачи телеметрии
В этом примере вы запустите приложение Spring PetClinic и настроите отправку телеметрии в Monium.
Вы сможете собирать логи, трейсы и метрики о работе механизмов JVM (загрузка классов, потребление CPU, сборка мусора), пула соединений к базе данных и HTTP-эндпоинтов без изменения кода приложения.
-
Установите Git и Java, подходящие для вашей ОС. Например:
sudo apt update sudo apt install -y git openjdk-25-jdk -
Установите переменные окружения для подключения к Monium:
export MONIUM_API_KEY=<api_ключ> export MONIUM_PROJECT=<идентификатор_проекта> export MONIUM_CLUSTER=<имя_кластера> # опционально -
Склонируйте и соберите Spring PetClinic:
git clone https://github.com/spring-projects/spring-petclinic cd spring-petclinic ./mvnw -DskipTests package -
Скачайте OpenTelemetry Java-агент:
curl -L -o opentelemetry-javaagent.jar \ https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar -
Настройте параметры экспорта телеметрии:
export OTEL_EXPORTER_OTLP_PROTOCOL="grpc" export OTEL_EXPORTER_OTLP_ENDPOINT="https://ingest.monium.yandex.cloud:443" export OTEL_EXPORTER_OTLP_HEADERS="x-monium-project=${MONIUM_PROJECT},x-monium-cluster=${MONIUM_CLUSTER},authorization=Api-Key ${MONIUM_API_KEY}" export OTEL_SERVICE_NAME=spring-petclinic -
(Опционально) Включите дельта-темпоральность для метрик:
export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE="delta" -
Запустите приложение с Java-агентом:
java -javaagent:./opentelemetry-javaagent.jar -jar target/*.jar -
Откройте веб-приложение Spring PetClinic по адресу
http://localhost:8080и выполняйте в нем действия пользователей. Метрики создаются при первом вызове соответствующих функций.
Просмотр телеметрии в Monium
-
На главной странице Monium слева выберите Шарды.
-
В списке выберите шард с названием вашего сервиса.
Имя шарда формируется как
<имя_проекта>_<имя_кластера>_<имя_сервиса>, напримерfolder__b1g86q4m5vej********_default_spring-petclinic. -
Чтобы посмотреть отдельный тип данных, слева выберите:
-
Метрики.
В строке запроса последовательно выберите
project,cluster,serviceи нажмите Выполнить запрос.Пример графика с метриками
Подробнее о работе с метриками.
-
Логи.
В строке запроса последовательно выберите
project,cluster,serviceи нажмите Выполнить запрос.Пример страницы с логами
Подробнее о работе с логами.
-
Трейсы.
В строке запроса последовательно выберите
projectиserviceи нажмите Выполнить.Пример страницы с трейсами
Подробнее о работе с трейсами.
-