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

Установите Git и Java, подходящие для вашей ОС. Например:

sudo apt update
sudo apt install -y git openjdk-17-jdk

Установите Fluent Bit версии 4.0 и выше.

Установите переменные окружения:

export MONIUM_PROJECT=<идентификатор_проекта>
export MONIUM_API_KEY=<api_ключ>

Создайте файл конфигурации (например, fluent-bit.yaml). Используйте конфигурацию раздела Настройка Fluent Bit. Пример для gRPC:

pipeline:
  inputs:
    - name: opentelemetry
      listen: 127.0.0.1
      port: 4318

  outputs:
    - name: opentelemetry
      match: "*"
      host: ingest.monium.yandex.cloud
      port: 443
      tls: on
      compress: zstd
      grpc: on
      header:
        - Authorization Api-Key ${MONIUM_API_KEY}
        - x-monium-project ${MONIUM_PROJECT}

Запустите Fluent Bit:

fluent-bit -c fluent-bit.yaml

Fluent Bit начнет принимать телеметрию по OTLP на 127.0.0.1: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-агентом. Телеметрия будет отправляться во Fluent Bit на порт 4318. Не задавайте OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE="delta" — при передаче через Fluent Bit дельта-метрики обрабатываются некорректно.

OTEL_SERVICE_NAME=spring-petclinic \
OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE="cumulative" \
java -javaagent:./opentelemetry-javaagent.jar -jar target/*.jar

Откройте приложение Spring PetClinic http://localhost:8080 и выполняйте в нем действия пользователей.

На главной странице Monium слева выберите Шарды.

В списке выберите шард с названием вашего сервиса.

Имя шарда формируется как <имя_проекта>_<имя_кластера>_<имя_сервиса>, например folder__b1g86q4m5vej********_default_spring-petclinic.

Чтобы посмотреть отдельный тип данных, слева выберите:

• Метрики.

  В строке запроса последовательно выберите project, cluster, service и нажмите Выполнить запрос.

  Пример графика с метриками

  

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

• Логи.

  В строке запроса последовательно выберите project, cluster, service и нажмите Выполнить запрос.

  Пример страницы с логами

  

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

• Трейсы.

  В строке запроса последовательно выберите project и service и нажмите Выполнить.

  Пример страницы с трейсами

  

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