يستخدم 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
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>
