Java - ClickHouse Documentation

يستخدم ClickStack معيار OpenTelemetry لجمع بيانات القياس عن بُعد (السجلات والتتبعات). وتُنشأ التتبعات تلقائيًا باستخدام instrumentation التلقائي، لذا لا تحتاج إلى instrumentation يدوي للاستفادة من التتبع. يدمج هذا الدليل ما يلي:

✅ السجلات

✅ المقاييس

✅ التتبعات

البدء

حاليًا، هذا التكامل متوافق فقط مع Java 8+

تنزيل OpenTelemetry Java agent

نزّل opentelemetry-javaagent.jar وضع ملف JAR في الدليل الذي تفضّله. يحتوي ملف JAR على الوكيل ومكتبات instrumentation. ويمكنك أيضًا استخدام الأمر التالي لتنزيل الوكيل:

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

اضبط متغيرات البيئة

بعد ذلك، ستحتاج إلى ضبط متغيرات البيئة التالية في shell لديك لإرسال بيانات القياس عن بُعد إلى ClickStack عبر OpenTelemetry Collector:

Managed ClickStack
ClickStack Open Source

export JAVA_TOOL_OPTIONS="-javaagent:PATH/TO/opentelemetry-javaagent.jar" \
OTEL_EXPORTER_OTLP_ENDPOINT=https://your-otel-collector:4318 \
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf \
OTEL_LOGS_EXPORTER=otlp \
OTEL_SERVICE_NAME='<NAME_OF_YOUR_APP_OR_SERVICE>'

export JAVA_TOOL_OPTIONS="-javaagent:PATH/TO/opentelemetry-javaagent.jar" \
OTEL_EXPORTER_OTLP_ENDPOINT=https://your-otel-collector:4318 \
OTEL_EXPORTER_OTLP_HEADERS='authorization=<YOUR_INGESTION_API_KEY>' \
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf \
OTEL_LOGS_EXPORTER=otlp \
OTEL_SERVICE_NAME='<NAME_OF_YOUR_APP_OR_SERVICE>'

يُستخدم متغير البيئة OTEL_SERVICE_NAME للتعريف بخدمتك في تطبيق HyperDX، ويمكن أن يكون أي اسم تريده. يحتوي متغير البيئة OTEL_EXPORTER_OTLP_HEADERS على مفتاح API المتاح عبر تطبيق HyperDX ضمن Team Settings → API Keys.

شغّل التطبيق باستخدام OpenTelemetry Java agent

java -jar target/<APPLICATION_JAR_FILE>

اقرأ المزيد عن instrumentation في Java لـ OpenTelemetry هنا: https://opentelemetry.io/docs/instrumentation/java/

​البدء

​تنزيل OpenTelemetry Java agent

​اضبط متغيرات البيئة

​شغّل التطبيق باستخدام OpenTelemetry Java agent

البدء

تنزيل OpenTelemetry Java agent

اضبط متغيرات البيئة

شغّل التطبيق باستخدام OpenTelemetry Java agent