بدء الاستخدام (تكميلي)

مقالة
04/22/2024

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

"Azure App Service"

لمزيد من المعلومات، راجع مراقبة التطبيق ل Azure App Service وJava.

دالات Azure

لمزيد من المعلومات، راجع مراقبة وظائف Azure باستخدام Azure Monitor Application Insights.

Azure Spring Apps

لمزيد من المعلومات، راجع عامل Application Insights Java قيد المعالجة في Azure Spring Apps.

الحاويات

إشعار

مع تطبيقات Spring Boot Native Image، استخدم Azure Monitor OpenTelemetry Distro / Application Insights في مشروع تطبيق Java للصورة الأصلية ل Spring Boot بدلا من وكيل Application Insights Java.

نقطة إدخال Docker

إذا كنت تستخدم نموذج exec، فقم بإضافة المعلمة إلى قائمة المعلمات -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" في مكان ما قبل المعلمة "-jar"، على سبيل المثال:

ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.5.2.jar", "-jar", "<myapp.jar>"]

إذا كنت تستخدم نموذج shell ، أضف arg -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" جهاز Java الظاهري (JVM) في مكان ما قبل -jar، على سبيل المثال:

ENTRYPOINT java -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" -jar <myapp.jar>

ملف Docker

مثال Dockerfile:

FROM ...

COPY target/*.jar app.jar

COPY agent/applicationinsights-agent-3.5.2.jar applicationinsights-agent-3.5.2.jar 

COPY agent/applicationinsights.json applicationinsights.json

ENV APPLICATIONINSIGHTS_CONNECTION_STRING="CONNECTION-STRING"
        
ENTRYPOINT["java", "-javaagent:applicationinsights-agent-3.5.2.jar", "-jar", "app.jar"]

في هذا المثال، يمكنك نسخ الملفات applicationinsights-agent-3.5.2.jar و applicationinsights.json من agent مجلد (يمكنك اختيار أي مجلد من جهازك). يجب أن يكون هذان الملفان في نفس المجلد في حاوية Docker.

صور حاوية الشريك

إذا كنت تستخدم صورة حاوية شريك لا يمكنك تعديلها، فحمل جرة وكيل Application Insights Java في الحاوية من الخارج. تعيين متغير البيئة للحاوية JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jar.

Spring Boot

لمزيد من المعلومات، راجع استخدام Azure Monitor Application Insights مع Spring Boot.

خوادم تطبيقات Java

للحصول على معلومات حول إعداد عامل Application Insights Java، راجع تمكين Azure Monitor OpenTelemetry ل Java. توفر الأقسام التالية تفاصيل قد تكون مفيدة عند تكوين -javaagent:... JVM arg على خوادم تطبيقات مختلفة.

Tomcat 8 (Linux)

تم تثبيت Tomcat عبر apt-get أو yum

إذا قمت بتثبيت Tomcat عبر apt-get أو yum، يجب أن يكون لديك ملف /etc/tomcat8/tomcat8.conf. قم بإضافة هذا السطر إلى نهاية هذا الملف:

JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.5.2.jar"

يتم تثبيت Tomcat من خلال التنزيل وإلغاء الضغط

إذا قمت بتثبيت Tomcat عبر التنزيل وفك الضغط من https://tomcat.apache.org، يجب أن يكون لديك ملف <tomcat>/bin/catalina.sh. إنشاء ملف جديد في الدليل نفسه المُسمى <tomcat>/bin/setenv.sh بالمحتوى التالي:

CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.5.2.jar"

إذا كان الملف <tomcat>/bin/setenv.sh موجودا بالفعل، فعدل هذا الملف وأضف -javaagent:path/to/applicationinsights-agent-3.5.2.jar إلى CATALINA_OPTS.

Tomcat 8 (Windows)

تشغيل Tomcat من سطر الأوامر

حدد موقع الملف <tomcat>/bin/catalina.bat. إنشاء ملف جديد في الدليل نفسه المُسمى <tomcat>/bin/setenv.bat بالمحتوى التالي:

set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.5.2.jar

لا يلزم عروض الأسعار، ولكن إذا كنت تريد تضمينها، فإن الموضع المناسب ما يلي:

set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.5.2.jar"

إذا كان الملف <tomcat>/bin/setenv.bat موجودا بالفعل، فعدل هذا الملف وأضف -javaagent:path/to/applicationinsights-agent-3.5.2.jar إلى CATALINA_OPTS.

تشغيل Tomcat كخدمة Windows

حدد موقع الملف <tomcat>/bin/tomcat8w.exe. قم بتشغيل هذا الملف القابل للتنفيذ وإضافة -javaagent:path/to/applicationinsights-agent-3.5.2.jar إلى Java Options أسفل علامة التبويب Java.

JBoss Enterprise Application Platform 7

في Red Hat JBoss Enterprise Application Platform (EAP) 7، يمكنك إعداد خادم مستقل أو خادم مجال.

خادم مستقل

قم بإضافة -javaagent:path/to/applicationinsights-agent-3.5.2.jar إلى متغير البيئة JAVA_OPTSالموجود في الملف JBOSS_HOME/bin/standalone.conf (Linux) أو JBOSS_HOME/bin/standalone.conf.bat (Windows):

    JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.5.2.jar -Xms1303m -Xmx1303m ..."
    ...

خادم المجال

إضافة -javaagent:path/to/applicationinsights-agent-3.5.2.jar إلى الموجودة jvm-optionsفي JBOSS_HOME/domain/configuration/host.xml :

...
<jvms>
    <jvm name="default">
        <heap size="64m" max-size="256m"/>
        <jvm-options>
            <option value="-server"/>
            <!--Add Java agent jar file here-->
            <option value="-javaagent:path/to/applicationinsights-agent-3.5.2.jar"/>
            <option value="-XX:MetaspaceSize=96m"/>
            <option value="-XX:MaxMetaspaceSize=256m"/>
        </jvm-options>
    </jvm>
</jvms>
...

إذا كنت تقوم بتشغيل عدة خوادم مدارة على مضيف واحد، فستحتاج إلى إضافة applicationinsights.agent.id إلى system-properties لكل server:

...
<servers>
    <server name="server-one" group="main-server-group">
        <!--Edit system properties for server-one-->
        <system-properties> 
            <property name="applicationinsights.agent.id" value="..."/>
        </system-properties>
    </server>
    <server name="server-two" group="main-server-group">
        <socket-bindings port-offset="150"/>
        <!--Edit system properties for server-two-->
        <system-properties>
            <property name="applicationinsights.agent.id" value="..."/> 
        </system-properties>
    </server>
</servers>
...

يجب أن تكون القيمة المحددة applicationinsights.agent.id فريدة. يمكنك استخدام القيمة لإنشاء دليل فرعي ضمن دليل Application Insights. تحتاج كل عملية JVM إلى تكوين Application Insights المحلي الخاص بها وملف سجل Application Insights المحلي. أيضا، إذا كانت التقارير إلى المجمع المركزي، تشترك عدة خوادم مدارة في applicationinsights.properties الملف، لذلك فإن المحدد applicationinsights.agent.id مطلوب لتجاوز agent.id الإعداد في هذا الملف المشترك. applicationinsights.agent.rollup.id يمكن تحديد بالمثل في الخادم system-properties إذا كنت بحاجة إلى تجاوز agent.rollup.id الإعداد لكل خادم مدار.

Jetty 9

أضف هذه الأسطر إلى start.ini:

--exec
-javaagent:path/to/applicationinsights-agent-3.5.2.jar

Payara 5

إضافة -javaagent:path/to/applicationinsights-agent-3.5.2.jar إلى الموجودة jvm-optionsفي glassfish/domains/domain1/config/domain.xml :

...
<java-config ...>
    <!--Edit the JVM options here-->
    <jvm-options>
        -javaagent:path/to/applicationinsights-agent-3.5.2.jar>
    </jvm-options>
        ...
</java-config>
...

WebSphere 8

افتح وحدة تحكم الإدارة.
انتقل إلى Servers>WebSphere application servers>Application servers. اختر خوادم التطبيق المناسبة وحدد Java وتعريف>عملية إدارة>العمليات Java Virtual Machine.
في Generic JVM arguments، أضف وسيطة JVM التالية.
```
-javaagent:path/to/applicationinsights-agent-3.5.2.jar
```
حفظ خادم التطبيق وإعادة تشغيله.

OpenLiberty 18

إنشاء ملف jvm.options جديد في دليل الخادم (على سبيل المثال، <openliberty>/usr/servers/defaultServer)، وإضافة هذا السطر:

-javaagent:path/to/applicationinsights-agent-3.5.2.jar

آخرون

راجع وثائق خادم التطبيق حول كيفية إضافة JVM args.