مشاركة عبر

كيفية مراقبة تطبيقات Spring Boot باستخدام عامل New Relic Java

  • مقالة

إشعار

سيتم إهمال الخطط الأساسية والقياسية والمؤسسة بدءا من منتصف مارس 2025، مع فترة تقاعد 3 سنوات. نوصي بالانتقال إلى Azure Container Apps. لمزيد من المعلومات، راجع إعلان إيقاف Azure Spring Apps.

سيتم إهمال الاستهلاك القياسي والخطة المخصصة بدءا من 30 سبتمبر 2024، مع إيقاف التشغيل الكامل بعد ستة أشهر. نوصي بالانتقال إلى Azure Container Apps. لمزيد من المعلومات، راجع ترحيل استهلاك Azure Spring Apps القياسي وخطة مخصصة إلى Azure Container Apps.

تنطبق هذه المقالة على: ✔️ الاستهلاك القياسي والمخصصة (معاينة) ✔️ Basic/Standard ❌ Enterprise

توضح لك هذه المقالة كيفية مراقبة تطبيقات Spring Boot في Azure Spring Apps باستخدام وكيل New Relic Java.

مع عامل New Relic Java يمكنك:

  • استهلك عامل New Relic Java.
  • قم بتكوين عامل New Relic Java باستخدام متغيرات البيئة.
  • تحقق من جميع بيانات المراقبة من لوحة تحكم New Relic.

يصف الفيديو التالي كيفية تنشيط ومراقبة تطبيقات Spring Boot في Azure Spring Apps من خلال New Relic One.


المتطلبات الأساسية

نشط New Relic Java في عامل التصنيع

استخدم الإجراء التالي للوصول إلى العامل:

  1. قم بإنشاء مثال على Azure Spring Apps.

  2. قم بإنشاء التطبيق.

    az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --is-public true \

  3. إنشاء نشر مع عامل New Relic والمتغيرات البيئية.

    az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --artifact-path app.jar \
    --jvm-options="-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar" \
    --env NEW_RELIC_APP_NAME=appName \
          NEW_RELIC_LICENSE_KEY=newRelicLicenseKey

تقوم Azure Spring Apps بتثبيت عامل New Relic Java مسبقا إلى /opt/agents/newrelic/java/newrelic-agent.jar. يمكن للعملاء تنشيط العامل من خيارات JVM للتطبيقات، وتكوين العامل باستخدام متغيرات بيئة عامل New Relic Java.

مدخل Azure

يمكنك أيضا تنشيط هذا العامل من مدخل Microsoft Azure باتباع الإجراء التالي.

  1. في مثيل Azure Spring Apps، حدد التطبيقات في جزء التنقل.

    لقطة شاشة لمدخل Azure تعرض صفحة التطبيقات لمثيل Azure Spring Apps.

  2. حدد التطبيق من القائمة، ثم حدد Configuration في جزء التنقل.

  3. استخدم علامة التبويب الإعدادات العامة لتحديث قيم مثل خيارات JVM.

    لقطة شاشة لمدخل Azure تعرض صفحة التكوين لتطبيق مع تحديد علامة التبويب الإعدادات العامة.

  4. حدد متغيرات البيئة لإضافة أو تحديث المتغيرات المستخدمة من قبل التطبيق الخاص بك.

    لقطة شاشة لمدخل Azure تعرض صفحة التكوين لتطبيق مع تحديد علامة التبويب متغيرات البيئة.

  5. اعرض صفحة واجهة برمجة تطبيقات / بوابة التطبيق الملخص من لوحة معلومات New Relic.

    لقطة شاشة للوحة معلومات New Relic تعرض صفحة ملخص بوابة API.

  6. اعرض صفحة التطبيق customers-service الملخص من لوحة معلومات New Relic.

    لقطة شاشة للوحة معلومات New Relic تعرض صفحة خدمة العملاء.

  7. اعرض صفحة خريطة الخدمة من لوحة معلومات New Relic.

    لقطة شاشة للوحة معلومات New Relic تعرض صفحة Service Map.

  8. اطلع على صفحة JVMs من التطبيق من لوحة تحكم New Relic.

    لقطة شاشة للوحة معلومات New Relic تعرض صفحة JVM.

  9. عرض ملف تعريف التطبيق من لوحة تحكم New Relic.

    لقطة شاشة للوحة معلومات New Relic تعرض صفحة ملف تعريف التطبيق.

أتمتة التوفير

يمكنك أيضا تشغيل مسار أتمتة التوفير باستخدام Terraform أو Bicep أو قالب Azure Resource Manager (قالب ARM). يمكن أن توفر البنية الأساسية لبرنامج ربط العمليات التجارية هذا تجربة عدم التدخل الكاملة للأداة ومراقبة أي تطبيقات جديدة تقوم بإنشائها ونشرها.

أتمتة تزويد باستخدام Terraform

لتكوين متغيرات البيئة في نموذج Terraform، قم بإضافة التعليمات البرمجية التالية إلى القالب، واستبدل العناصر النائبة <...> بقيمك الخاصة. لمزيد من المعلومات، راجع إدارة توزيع تطبيقات Active Azure Spring.

resource "azurerm_spring_cloud_java_deployment" "example" {
  ...
  jvm_options = "-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar"
  ...
    environment_variables = {
      "NEW_RELIC_APP_NAME": "<app-name>",
      "NEW_RELIC_LICENSE_KEY": "<new-relic-license-key>"
  }
}

أتمتة التوفير باستخدام ملف Bicep

لتكوين متغيرات البيئة في ملف Bicep، أضف التعليمات البرمجية التالية إلى القالب، واستبدل <العناصر النائبة ...> بقيمك الخاصة. لمزيد من المعلومات، راجع Microsoft.AppPlatform Spring/التطبيقات/النشر .

deploymentSettings: {
  environmentVariables: {
    NEW_RELIC_APP_NAME : '<app-name>',
    NEW_RELIC_LICENSE_KEY : '<new-relic-license-key>'
  },
  jvmOptions: '-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar',
  ...
}

أتمتة تزويد التوفير باستخدام قالب ARM

لتكوين متغيرات البيئة في قالب ARM، قم بإضافة التعليمة البرمجية التالية إلى القالب، واستبدل العناصر النائبة <...> بقيمك الخاصة. لمزيد من المعلومات، راجع Microsoft.AppPlatform Spring/التطبيقات/النشر .

"deploymentSettings": {
  "environmentVariables": {
    "NEW_RELIC_APP_NAME" : "<app-name>",
    "NEW_RELIC_LICENSE_KEY" : "<new-relic-license-key>"
  },
  "jvmOptions": "-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar",
  ...
}

إعادة توجيه سجلات التطبيق إلى New Relic

يمكن لعامل New Relic جمع سجلات التطبيقات مباشرة من تطبيقاتك، وإعادة توجيهها إلى New Relic. لمزيد من المعلومات، راجع إعادة توجيه سجلاتك إلى سجلات New Relic و APM في السياق.

عرض سجلات عامل New Relic Java

بشكل افتراضي، يقوم Azure Spring Apps بطباعة سجلات عامل New Relic Java إلى STDOUT. يتم خلط السجلات مع سجلات التطبيق. يمكنك العثور على نسخة العامل الصريحة من سجلات التطبيق.

يمكنك أيضًا الحصول على سجلات عامل New Relic من المواقع التالية:

  • السجلات الخاصة بـ Azure Spring Apps
  • تطبيق تطبيقات Application Insights Azure Spring
  • Azure Spring Apps LogStream

يمكنك استخدام بعض متغيرات البيئة التي يوفرها New Relic لتكوين تسجيل عامل جديد، مثل، NEW_RELIC_LOG_LEVEL للتحكم في مستوى السجلات. لمزيد من المعلومات، راجع تكوين تسجيل Relic جديد.

إشعار

لا تستخدم finer أو finest ما لم يطلب منك New Relic Support القيام بذلك. يمكن أن تولد مستويات التسجيل هذه حملا زائدا. بالنسبة لمعظم الحالات، استخدم info.

تنبيه

نوصي بشدة بعدم تجاوز سلوك التسجيل الافتراضي الذي توفره Azure Spring Apps for New Relic. إذا قمت بذلك، يتم حظر سيناريوهات التسجيل الموضحة مسبقا، وقد يتم فقدان ملف (ملفات) السجل. على سبيل المثال، يجب عدم تمرير متغيرات البيئة التالية إلى تطبيقاتك. قد يفقد ملف (ملفات) السجل بعد إعادة التشغيل أو إعادة نشر الطلب (الطلبات).

  • الشعار الخاص ب New Relic
  • NEW_RELIC_LOG_FILE_PATH

تحديث/ترقية عامل Relic Java الجديد

يقوم عامل New Relic Java بتحديث/ترقية JDK بانتظام. قد يؤثر تحديث/ترقية العامل على السيناريوهات التالية.

  • التطبيقات الموجودة التي تستخدم عامل New Relic Java قبل التحديث/الترقية لم تتغير.
  • تتطلب التطبيقات الحالية التي تستخدم عامل Relic Java الجديد قبل التحديث/الترقية إعادة التشغيل أو إعادة الانتشار لإشراك الإصدار الجديد من عامل New Relic Java.
  • تستخدم التطبيقات الجديدة التي تم إنشاؤها بعد التحديث/الترقية الإصدار الجديد من عامل New Relic Java.

حالة حقن Vnet تكوين نسبة استخدام الشبكة الخارجية

للحصول على مثال حقن vnet من Azure Spring Apps، تحتاج إلى التأكد من تكوين نسبة استخدام الشبكة الخارجية بشكل صحيح لعامل New Relic Java. لمزيد من المعلومات، انظر Networks of New Relic .

الخطوات التالية

قم باستخدام Application Insights Java In-Process Agent في Azure Spring Apps