> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> حزمة Java SDK لـ ClickStack - حزمة الرصد من ClickHouse

# Java

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

**يدمج هذا الدليل ما يلي:**

<table>
  <tbody>
    <tr>
      <td className="pe-2">✅ السجلات</td>
      <td className="pe-2">✅ المقاييس</td>
      <td className="pe-2">✅ التتبعات</td>
    </tr>
  </tbody>
</table>

<div id="getting-started">
  ## البدء
</div>

<Note>
  حاليًا، هذا التكامل متوافق فقط مع **Java 8+**
</Note>

<div id="download-opentelemetry-java-agent">
  ### تنزيل OpenTelemetry Java agent
</div>

نزّل [`opentelemetry-javaagent.jar`](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar)
وضع ملف JAR في الدليل الذي تفضّله. يحتوي ملف JAR على الوكيل
ومكتبات instrumentation. ويمكنك أيضًا استخدام الأمر التالي
لتنزيل الوكيل:

```shell theme={null}
curl -L -O https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar
```

<div id="configure-environment-variables">
  ### اضبط متغيرات البيئة
</div>

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

<Tabs>
  <Tab title="Managed ClickStack">
    ```shell theme={null}
    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>'
    ```
  </Tab>

  <Tab title="ClickStack Open Source">
    ```shell theme={null}
    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>'
    ```
  </Tab>
</Tabs>

*يُستخدم متغير البيئة `OTEL_SERVICE_NAME` للتعريف بخدمتك في تطبيق HyperDX، ويمكن أن يكون أي اسم تريده.*

يحتوي متغير البيئة `OTEL_EXPORTER_OTLP_HEADERS` على مفتاح API المتاح عبر تطبيق HyperDX ضمن `Team Settings → API Keys`.

<div id="run-the-application-with-otel-java-agent">
  ### شغّل التطبيق باستخدام OpenTelemetry Java agent
</div>

```shell theme={null}
java -jar target/<APPLICATION_JAR_FILE>
```

<br />

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