opentelemetry java instrumentation تحميل - opentelemetry java instrumentation تحميل كود المصدر

opentelemetry java instrumentation

جافا كود المصدر

Version 2.10.0

تنزيل

البدء • المشاركة • التواصل

المساهمة • النطاق

أدوات القياس عن بعد المفتوحة لجافا

عن
ابدء
تكوين الوكيل
المكتبات والأطر وخوادم التطبيقات المدعومة
إنشاء ملحقات الوكيل
الأجهزة يدويا
مسجل MDC الأجهزة التلقائية
استكشاف الأخطاء وإصلاحها
المساهمة

عن

يوفر هذا المشروع وكيل Java JAR الذي يمكن إرفاقه بأي تطبيق Java 8+ ويقوم بإدخال كود بايت ديناميكيًا لالتقاط القياس عن بعد من عدد من المكتبات والأطر الشائعة. يمكنك تصدير بيانات القياس عن بعد بتنسيقات متنوعة. يمكنك أيضًا تكوين الوكيل والمصدر عبر وسيطات سطر الأوامر أو متغيرات البيئة. والنتيجة النهائية هي القدرة على جمع بيانات القياس عن بعد من تطبيق Java دون تغيير التعليمات البرمجية.

ينشر هذا المستودع أيضًا أدوات مستقلة للعديد من المكتبات (والمتنامية) التي يمكن استخدامها إذا كنت تفضل ذلك على استخدام وكيل Java. يرجى الاطلاع على عمود أدوات المكتبة المستقلة في المكتبات المدعومة. إذا كنت تبحث عن وثائق حول استخدام تلك.

ابدء

قم بتنزيل أحدث إصدار.

تتضمن هذه الحزمة وكيل الأجهزة بالإضافة إلى أدوات لجميع المكتبات المدعومة وجميع مصدري البيانات المتاحين. توفر الحزمة تجربة تلقائية بالكامل خارج الصندوق.

ملاحظة: هناك إصدارات 2.x وإصدارات 1.x. يتضمن الإصدار 2.0 تغييرات جذرية كبيرة، يمكن العثور على تفاصيلها في ملاحظات الإصدار. يوصى باستخدام الإصدار 2.x الأحدث الذي سيحتوي على أحدث الميزات والتحسينات. 1.x سيتلقى تصحيحات الأمان لفترة محدودة ولن يتضمن إصلاحات وتحسينات للأخطاء الأخرى.

قم بتمكين وكيل الأجهزة باستخدام علامة -javaagent إلى JVM.

 java -javaagent:path/to/opentelemetry-javaagent.jar 
     -jar myapp.jar

افتراضيًا، يستخدم وكيل OpenTelemetry Java مصدر OTLP الذي تم تكوينه لإرسال البيانات إلى أداة تجميع OpenTelemetry على http://localhost:4318 .

يتم تمرير معلمات التكوين كخصائص نظام Java (إشارات -D ) أو كمتغيرات بيئة. راجع وثائق التكوين للحصول على القائمة الكاملة لعناصر التكوين. على سبيل المثال:

 java -javaagent:path/to/opentelemetry-javaagent.jar 
     -Dotel.resource.attributes=service.name=your-service-name 
     -Dotel.traces.exporter=zipkin 
     -jar myapp.jar

تكوين الوكيل

الوكيل قابل للتكوين بدرجة كبيرة! يمكن تكوين العديد من جوانب سلوك الوكيل وفقًا لاحتياجاتك، مثل اختيار المصدر، وتكوين المصدر (مثل مكان إرسال البيانات)، ورؤوس نشر سياق التتبع، وغير ذلك الكثير.

للحصول على قائمة مفصلة بخيارات تكوين الوكيل، راجع مستندات تكوين الوكيل.

للحصول على قائمة مفصلة بمتغيرات بيئة تكوين SDK الإضافية وخصائص النظام، راجع مستندات تكوين SDK.

ملاحظة: من المحتمل جدًا أن تتغير أسماء معلمات التكوين بمرور الوقت، لذا يرجى التحقق مرة أخرى هنا عند تجربة إصدار جديد! يرجى الإبلاغ عن أي أخطاء أو سلوك غير متوقع تجده.

المكتبات والأطر وخوادم التطبيقات المدعومة

نحن ندعم عددًا كبيرًا جدًا من المكتبات وأطر العمل وغالبية خوادم التطبيقات الأكثر شهرة...مباشرة خارج الصندوق! انقر هنا لرؤية القائمة الكاملة ولمعرفة المزيد حول الأجهزة المعطلة وكيفية منع الأجهزة غير المرغوب فيها.

إنشاء ملحقات الوكيل

تضيف الإضافات ميزات وقدرات جديدة إلى الوكيل دون الحاجة إلى إنشاء توزيع منفصل أو تقسيم هذا المستودع. على سبيل المثال، يمكنك إنشاء عينات مخصصة أو مصدرين ممتدين، وتعيين إعدادات افتراضية جديدة، وتضمينها كلها في الوكيل للحصول على ملف jar واحد.

الأجهزة يدويا

بالنسبة لمعظم المستخدمين، تعد الأدوات الجاهزة كافية تمامًا ولا يلزم القيام بأي شيء آخر. ومع ذلك، في بعض الأحيان، يرغب المستخدمون في إضافة سمات إلى الامتدادات التلقائية، أو قد يرغبون في إنشاء امتدادات يدويًا للتعليمات البرمجية المخصصة الخاصة بهم.

للحصول على تعليمات مفصلة، راجع الأجهزة اليدوية.

مسجل MDC (سياق التشخيص المعين) الأجهزة التلقائية

من الممكن إدخال معلومات التتبع مثل معرفات التتبع والمعرفات الممتدة في سجلات التطبيق المخصصة الخاصة بك. للحصول على التفاصيل، راجع الأجهزة التلقائية لـ Logger MDC.