كيفية مراقبة تطبيقات Spring Boot باستخدام عامل New Relic Java
إشعار
يعد Azure Spring Apps هو الاسم الجديد لخدمة Azure Spring Cloud. رغم أن الخدمة تحمل اسماً جديداً، سترى الاسم القديم في بعض الأماكن لفترة من الوقت بينما نعمل على تحديث الأصول مثل لقطات الشاشة، ومقاطع الفيديو، والرسوم التخطيطية.
تنطبق هذه المقالة على: ✔️ الاستهلاك القياسي والمخصصة (معاينة) ✔️ 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 في عامل التصنيع
استخدم الإجراء التالي للوصول إلى العامل:
قم بإنشاء مثال على Azure Spring Apps.
قم بإنشاء التطبيق.
az spring app create \ --resource-group <resource-group-name> \ --service <Azure-Spring-Apps-instance-name> \ --name <app-name> \ --is-public true \إنشاء نشر مع عامل 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 باتباع الإجراء التالي.
في مثيل Azure Spring Apps، حدد التطبيقات في جزء التنقل.
حدد التطبيق من القائمة، ثم حدد Configuration في جزء التنقل.
استخدم علامة التبويب الإعدادات العامة لتحديث قيم مثل خيارات JVM.
حدد متغيرات البيئة لإضافة أو تحديث المتغيرات المستخدمة من قبل التطبيق الخاص بك.
اعرض صفحة واجهة برمجة تطبيقات / بوابة التطبيق الملخص من لوحة معلومات New Relic.
اعرض صفحة التطبيق customers-service الملخص من لوحة معلومات New Relic.
اعرض صفحة خريطة الخدمة من لوحة معلومات New Relic.
اطلع على صفحة JVMs من التطبيق من لوحة تحكم 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