Настройка демо-приложения Java и сбор телеметрии

Установите 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.yacloudkz.tech: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.yaml

Collector начнет слушать порты 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 слева выберите раздел с нужным типом данных:

• Метрики.
• Логи.
• Трейсы.

Вверху на шкале времени задайте промежуток поиска данных.

В строке поиска введите запрос для поиска данных телеметрии:

• project = <идентификатор_проекта> — выберите проект, заданный в параметре x-monium-project в конфигурации передачи телеметрии приложения.

  Это может быть проект облака (cloud__<идентификатор_облака>), каталога (folder__<идентификатор_каталога>) или другой проект.

• cluster = <имя_кластера> — выберите имя инсталляции, в которой запущено ваше приложение. Если кластер не задан, то по умолчанию cluster = default.

• service = <имя_сервиса> — имя вашего приложения или сервиса. Может передаваться в переменной окружения OTEL_SERVICE_NAME.

  Если нужных меток нет в подсказках, их можно ввести вручную. Но, скорее всего, в систему не поступали данные с такими метками. Решение возможных проблем см. в разделе Устранение неполадок при поставке данных.

Нажмите Выполнить запрос или Выполнить.

На странице будут показаны данные, соответствующие запросу.

Подробнее о работе с метриками.

Подробнее о работе с логами.

Подробнее о работе с трейсами.

Чтобы посмотреть информацию о шарде с данными, слева выберите Шарды и затем шард с названием вашего сервиса.