Java

ClickStack использует стандарт OpenTelemetry для сбора данных телеметрии (логов и трейсов). Трейсы автоматически создаются с помощью автоматического инструментиования, поэтому ручное инструментиование не требуется, чтобы извлекать пользу из трассировки.

Это руководство охватывает интеграцию:

✅ Логи

✅ Метрики

✅ Трейсы

Начало работы

Примечание

В настоящее время интеграция поддерживает только Java 8+.

Загрузка Java-агента OpenTelemetry

Скачайте opentelemetry-javaagent.jar и поместите JAR-файл в выбранный каталог. JAR-файл содержит агент и библиотеки инструментирования. Вы также можете использовать следующую команду, чтобы скачать агент:

curl -L -O https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar

Настройте переменные окружения

Далее необходимо настроить в оболочке следующие переменные окружения для отправки телеметрии в ClickStack:

export JAVA_TOOL_OPTIONS="-javaagent:ПУТЬ/К/opentelemetry-javaagent.jar" \
OTEL_EXPORTER_OTLP_ENDPOINT=https://localhost:4318 \
OTEL_EXPORTER_OTLP_HEADERS='authorization=<ВАШ_API_КЛЮЧ_ДЛЯ_ИНГЕСТИИ>' \
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf \
OTEL_LOGS_EXPORTER=otlp \
OTEL_SERVICE_NAME='<НАЗВАНИЕ_ВАШЕГО_ПРИЛОЖЕНИЯ_ИЛИ_СЕРВИСА>'

Переменная окружения OTEL_SERVICE_NAME используется для идентификации сервиса в приложении HyperDX. Можно указать любое удобное имя.

Переменная окружения OTEL_EXPORTER_OTLP_HEADERS содержит ключ API, доступный в приложении HyperDX в разделе Team Settings → API Keys.

Запустите приложение с Java-агентом OpenTelemetry

java -jar target/<APPLICATION_JAR_FILE>

Подробнее об инструментировании Java с помощью OpenTelemetry читайте здесь: https://opentelemetry.io/docs/instrumentation/java/