توصيف Java

• توصيف اسم التطبيق
• مقاييس JMX المهيأة
• جاري ايقاف اتاحة الأدوات الآلية
• اتاحة ارتباط التتبع الى IBM MQ

توصيف اسم التطبيق

اذا كان موجودا ، سيتم الحصول على اسم التطبيق آليا من.jarالملف الذي يتم بدءه ، والا سيتم استخدام سطر الأمر بنفس الطريقة التي تقوم بها أدوات Java بعرض ملفات JVMs.

خلال.jarحفظ الخصائص المميزة القياسية فيMETA-INF/Manifest.MFهي :

Implementation-Title=Demo App
Implementation-Version=1.0.0

باستخدام أدوات البناء ، يمكن تحديد كلا من الخصائص المميزة عند بناء التطبيق. للحصول على مزيد من المعلومات ، ارجع الى وثائق Oracle.

اذا لم يتم الحصول على اسم باستخدام الاجراء السابق ، يتم تحديده بواسطة فحص خصائص النظام المختلفة ، على سبيل المثال-Dcatalina.homeلحاويات Tomcat.

لتحديد اسم التطبيق صراحة ، عند بدء JVM المحدد-Dcom.instana.agent.jvm.name="My Custom Name"الخاصية المميزة.

للحصول على agent استخدم خاصية النظام العادية الموجودة بالفعل ، حدد كشف بالخصائص الموجودة في البرنامج الوسيطconfiguration.yaml. أول خاصية موجودة ستقوم بتسمية JVM :

com.instana.plugin.java:
  name-properties:
    - 'acme.app'
    - 'DEPLOYMENT'

مقاييس Custom JMX

لتوصيف مقاييس JMX التي سيتم مراقبتها ، قم بتحرير البرنامج الوسيطconfiguration.yamlملف.

com.instana.plugin.java:
  jmx:
    # JMX is NOT hot-reloaded and needs to be set before a JVM is discovered.
    # Supported attribute types are Number and Boolean
    # delta calculation is only supported for Number
    - object_name: 'java.lang:type=Compilation'
      metrics:
        - attributes: 'TotalCompilationTime'
          type: 'delta' # delta will report the change to the previous second
    - object_name: 'java.lang:type=ClassLoading'
      metrics:
        - attributes: 'LoadedClassCount'
          type: 'absolute' # absolute will report the value as-is

يتم تحديد نوعين من المقاييس في المثال السابق :

• deltaيتم استخدامها للقيم التي تزيد بمرور الوقت ، مثل العدادات ، حيث يتم اعتبار التغيير النسبي مثيرا للاهتمام.
• absoluteيتم استخدامه لعرض القيمة الفعلية في كل مرة يتم فيها التوصل الى المقياس المتري.

الخاصية المميزة المحددة يجب أن تكون اماNumber(أو أحد الفئات الفرعية الخاصة به مثلIntegerأوDouble) أوStringتمثل رقما.

في واجهة تعامل JVM ، يتم عرض مقاييس JMX تحت مقاييس JMX المهيأة.

و#object_nameقد يحتوي على نماذج احلال كما هو محدد في Java's المطبوعات الفنية الى ObjectName API. فيما يلي مثال للتوصيف مع نماذج الاحلال :

com.instana.plugin.java:
  jmx:
    - object_name: 'kafka.*:type=*-metrics,client-id=*,*'
      metrics:
        - attributes: 'incoming-byte-rate'
          type: 'absolute'
        - attributes: 'incoming-byte-total'
          type: 'absolute'
        - attributes: 'outgoing-byte-rate'
          type: 'absolute'
        - attributes: 'outgoing-byte-total'
          type: 'absolute'

عدم اتاحة الأجهزة الآلية

تتضمن مجموعة برامج Incastic هذه الأجهزة الآلية التي تم اعدادها للبدء في تحميل مجموعة البرامج. تتيح هذه الأدوات معلومات التتبع التي تم توزيعها لواجهة التعامل البيانية الخاصة بك.

لالغاء اتاحة الأدوات الآلية (تتبع) ، قم بتحرير البرنامج الوسيطconfiguration.yamlملف.

com.instana.plugin.javatrace:
  instrumentation:
    # Lightweight Bytecode Instrumentation, enabled by default
    # Disabling currently requires an agent restart
    enabled: true

اتاحة ارتباط التتبع الى IBM MQ

في بعض الوحدات التابعة لنظام IBM MQ المستهلك ، يمكن أن يؤدي وجود بيانات عنوان اضافية في رسائل IBM MQ الى حدوث أخطاء في تشغيل الرسالة ورفض الرسالة. هذا هو السبب في أنه لم يتم اتاحة ارتباط عنوان التتبع غير الوارد افتراضيا بالنسبة لتطبيقات IBM MQ Java.

وهو يوصى بشدة لاختبار ارتباط تتبع IBM MQ في بيئة التشغيل غير المنتجة قبل أن تقوم باتاحته في بيئة الانتاج. اذا كان اتاحة دعم ارتباط التتبع يؤدي الى حدوث أخطاء في تطبيقات وحدة IBM MQ التابعة ، قم بتنفيذ أي من التصرفات التالية :

• اذا كان التطبيق عبارة عن تطبيق يمكن تغييره ، قم بتعديل التطبيق لتجاهل بيانات عنوان IBM MQ الاضافية التي يتم اضافتها بواسطة Incerانة. يمكنك الاتصال بدعم IBM MQ اذا كانت هناك حاجة للمساعدة لعمل تغييرات على وحدة IBM MQ التابعة.
• اذا كان التطبيق لا يمكن تغييره ، لا تقوم باتاحة دعم ارتباط تتبع IBM MQ .

لاتاحة ارتباط التتبع الى IBM MQ، قم بتحرير البرنامج الوسيطconfiguration.yamlملف.

# General Tracing Settings
com.instana.tracing:
  ibm-mq:
    trace-correlation: true

سيتم التقاط هذا التوصيف لـJVMs الجديدة ، عند تعديل Java Trace Sensor أو بعد اغلاق agent agent لمدة 15 دقيقة تقريبا. لن يتم اعادة تحميله خلال وقت التشغيل ، ولن يقوم برنامج وسيط سريع باستلام هذا التوصيف (يعد هذا هو التشغيل الأمثل ، حيث أن تغيير المواصفات يحتاج الى اعادة تركيب كامل).

وكبديل ، يمكن تحديد خاصية النظام على برامج JVMs للتطبيق التي تحتوي على IBM MQ Clients :

-Dinstana.ibm.mq.trace.correlation.enable=true

يقدم جهاز استشعار IBM MQ امكانية تتبع باستخدام برامج خروج المستخدم. للحصول على مزيد من المعلومات عن وحدة استشعار IBM MQ ، ارجع الى مراقبة IBM MQ.