Настройка демо-приложения Java и сбор телеметрии
Перед началом работы
Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:
- Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
- На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе
ACTIVEилиTRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.
Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.
Подробнее об облаках и каталогах.
Настройка демо-приложения и передачи телеметрии
В этом примере вы установите приложение Spring PetClinic и настроите отправку телеметрии в Monium.
-
Установите Git и Java, подходящие для вашей ОС. Например:
sudo apt update sudo apt install -y git openjdk-17-jdk -
Скачайте и установите OTel Collector, подходящий для вашей ОС. Например:
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v144.0/otelcol-linux_amd64.tar.gz tar xvf otelcol-linux_amd64.tar.gz -
Установите переменные окружения:
export MONIUM_PROJECT=folder__<идентификатор_каталога> export MONIUM_API_KEY=<api_ключ> -
Создайте файл
otel-collector.yamlи скопируйте в него содержимое:receivers: otlp: protocols: grpc: http: exporters: otlp_grpc/monium: compression: zstd endpoint: ingest.monium.yandex.cloud:443 headers: Authorization: "Api-Key ${env:MONIUM_API_KEY}" x-monium-project: "${env:MONIUM_PROJECT}" sending_queue: batch: service: pipelines: metrics: receivers: [ otlp ] exporters: [ otlp_grpc/monium ] traces: receivers: [ otlp ] exporters: [ otlp_grpc/monium ] logs: receivers: [ otlp ] exporters: [ otlp_grpc/monium ] telemetry: metrics: level: normal readers: - periodic: exporter: otlp: protocol: http/protobuf endpoint: http://localhost:4318 interval: 30000 timeout: 5000 -
Запустите OTel Collector:
./otelcol-linux_amd64 --config otel-collector.yamlCollector начнет слушать порты
4317(gRPC) и4318(HTTP). -
Скачайте и соберите 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 -
Запустите приложение с Java-агентом, который будет передавать телеметрию в OTel Collector:
OTEL_SERVICE_NAME=spring-petclinic \ OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE="delta" \ 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и нажмите Выполнить.Пример страницы с трейсами
Подробнее о работе с трейсами.
-