تمكين Azure Monitor OpenTelemetry لتطبيقات .NET Node.js وPython وJava

توضح هذه المقالة كيفية تمكين وتكوين جمع البيانات المستندة إلى OpenTelemetry داخل Application Insights. The Azure Monitor OpenTelemetry Distro:

• يوفر توزيع OpenTelemetry الذي يتضمن دعما للميزات الخاصة ب Azure Monitor.
• تمكين القياس التلقائي عن بعد عن طريق تضمين مكتبات أدوات القياس المفتوح لجمع التتبعات والمقاييس والسجلات والاستثناءات.
• يسمح بجمع بيانات تتبع الاستخدام المخصصة .
• يدعم Live Metrics لمراقبة وجمع المزيد من بيانات تتبع الاستخدام من تطبيقات الويب المباشرة في الإنتاج.

لمزيد من المعلومات حول مزايا استخدام Azure Monitor OpenTelemetry Distro، راجع لماذا يجب علي استخدام Azure Monitor OpenTelemetry Distro.

لمعرفة المزيد حول جمع البيانات باستخدام OpenTelemetry، راجع أساسيات تجميع البيانات أو الأسئلة المتداولة حول OpenTelemetry.

حالة إصدار OpenTelemetry

تتوفر عروض القياس المفتوح لتطبيقات .NET Node.js وPython وJava. للحصول على حالة إصدار ميزة بميزة، راجع الأسئلة المتداولة.

تمكين OpenTelemetry باستخدام Application Insights

اتبع الخطوات الواردة في هذا القسم وستبدأ التطبيق الخاص بك مع OpenTelemetry. حدد علامة تبويب للحصول على إرشادات خاصة ب langauge.

إشعار

يغطي .NET سيناريوهات متعددة، بما في ذلك ASP.NET الكلاسيكية وتطبيقات وحدة التحكم وWindows Forms (WinForms) والمزيد.

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

• اشتراك Azure: إنشاء اشتراك Azure مجانًا
• مورد Application Insights: إنشاء مورد Application Insights

ASP.NET Core

• ASP.NET Core Application باستخدام إصدار مدعوم رسميا من .NET

تلميح

إذا كنت تقوم بالترحيل من Application Insights Classic API، فشاهد وثائق الترحيل الخاصة بنا.

NET.

• تطبيق يستخدم إصدارا مدعوما من .NET أو .NET Framework 4.6.2 والإصدارات الأحدث.

تلميح

إذا كنت تقوم بالترحيل من Application Insights Classic API، فشاهد وثائق الترحيل الخاصة بنا.

Java

• تطبيق Java باستخدام Java 8+

Java الأصلي

• تطبيق Java يستخدم GraalVM 17+

Node.js

• تطبيق باستخدام إصدار معتمد رسميًا من وقت التشغيل Node.js:
  • أوقات تشغيل OpenTelemetry المدعومة
  • Azure Monitor OpenTelemetry Exporter supported runtimes

إشعار

إذا كنت لا تعتمد على أي خصائص مدرجة في الجدول غير المدعوم، فإن تحليل ApplicationInsights سيكون أسهل مسار إلى الأمام بمجرد الخروج من الإصدار التجريبي.

إذا كنت تعتمد على أي من هذه الخصائص، فانتقل إلى Azure Monitor OpenTelemetry Distro. سنقدم دليل ترحيل قريبا.

تلميح

إذا كنت تقوم بالترحيل من Application Insights Classic API، فشاهد وثائق الترحيل الخاصة بنا.

Python

• تطبيق Python باستخدام Python 3.8+

تلميح

إذا كنت تقوم بالترحيل من OpenCensus، فشاهد وثائق الترحيل الخاصة بنا.

تثبيت مكتبة العميل

ASP.NET Core

تثبيت أحدث Azure.Monitor.OpenTelemetry.AspNetCore حزمة NuGet:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

NET.

تثبيت أحدث Azure.Monitor.OpenTelemetry.Exporter حزمة NuGet:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

قم بتنزيل أحدث ملف applicationinsights-agent-3.6.1.jar .

تحذير

إذا كنت تقوم بالترقية من إصدار 3.x سابق، فقد تتأثر بتغيير الإعدادات الافتراضية أو الاختلافات الطفيفة في البيانات التي نجمعها. لمزيد من المعلومات، راجع قسم الترحيل في ملاحظات الإصدار. 3.5.0 و3.4.0 و3.3.0 و3.2.0 و3.1.0

Java الأصلي

بالنسبة لتطبيقات Spring Boot الأصلية:

• استيراد فواتير المواد OpenTelemetry (BOM).
• أضف تبعية Spring Cloud Azure Starter Monitor.
• اتبع هذه الإرشادات لملفات Azure SDK JAR (Java Archive).

بالنسبة لتطبيقات Quarkus الأصلية:

• أضف مصدر Quarkus OpenTelemetry لتبعية Azure.

Node.js

تثبيت أحدث حزمة @azure/monitor-opentelemetry :

npm install @azure/monitor-opentelemetry

كما يتم استخدام الحزم التالية لبعض السيناريوهات المحددة الموضحة لاحقًا في هذه المقالة:

• @opentelemetry/api
• @opentelemetry/sdk-metrics
• @opentelemetry/resources
• @opentelemetry/semantic-conventions
• @opentelemetry/sdk-trace-base

npm install @opentelemetry/api
npm install @opentelemetry/sdk-metrics
npm install @opentelemetry/resources
npm install @opentelemetry/semantic-conventions
npm install @opentelemetry/sdk-trace-base

Python

تثبيت أحدث حزمة azure-monitor-opentelemetry PyPI:

pip install azure-monitor-opentelemetry

تعديل التطبيق الخاص بك

ASP.NET Core

Azure.Monitor.OpenTelemetry.AspNetCore قم باستيراد مساحة الاسم، وأضف OpenTelemetry، وقم بتكوينه لاستخدام Azure Monitor في الفئة الخاصة بكprogram.cs:

// Import the Azure.Monitor.OpenTelemetry.AspNetCore namespace.
using Azure.Monitor.OpenTelemetry.AspNetCore;

var builder = WebApplication.CreateBuilder(args);

// Add OpenTelemetry and configure it to use Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor();

var app = builder.Build();

app.Run();

NET.

أضف مصدر Azure Monitor إلى كل إشارة OpenTelemetry في program.cs الفئة:

// Create a new tracer provider builder and add an Azure Monitor trace exporter to the tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/trace#tracerprovider-management
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter();

// Add an Azure Monitor metric exporter to the metrics provider builder.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics#meterprovider-management
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddAzureMonitorMetricExporter();

// Create a new logger factory.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/logs#logger-management
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        logging.AddAzureMonitorLogExporter();
    });
});

إشعار

لمزيد من المعلومات، راجع البرنامج التعليمي للبدء ل OpenTelemetry .NET

Java

يتم تمكين البنية التلقائية من خلال تغييرات التكوين. لا توجد تغييرات في التعليمات البرمجية مطلوبة.

أشر إلى جهاز Java الظاهري (JVM) إلى ملف jar عن طريق إضافة -javaagent:"path/to/applicationinsights-agent-.jar" إلى JVM args للتطبيق الخاص بك.

إشعار

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

تلميح

للحصول على إرشادات خاصة بالسيناريو، راجع بدء الاستخدام (ملحق).

تلميح

إذا قمت بتطوير تطبيق Spring Boot، يمكنك اختياريا استبدال وسيطة JVM بتكوين برمجي. لمزيد من المعلومات، راجع استخدام Azure Monitor Application Insights مع Spring Boot.

Java الأصلي

يتم تمكين البنية التلقائية من خلال تغييرات التكوين. لا توجد تغييرات في التعليمات البرمجية مطلوبة.

Node.js

// Import the `useAzureMonitor()` function from the `@azure/monitor-opentelemetry` package.
const { useAzureMonitor } = require("@azure/monitor-opentelemetry");

// Call the `useAzureMonitor()` function to configure OpenTelemetry to use Azure Monitor.
useAzureMonitor();

Python

# Import the `configure_azure_monitor()` function from the
# `azure.monitor.opentelemetry` package.
from azure.monitor.opentelemetry import configure_azure_monitor

# Import the tracing api from the `opentelemetry` package.
from opentelemetry import trace

# Configure OpenTelemetry to use Azure Monitor with the 
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor()

انسخ سلسلة الاتصال من مورد Application Insights

سلسلة الاتصال فريد ويحدد المكان الذي يرسل فيه Azure Monitor OpenTelemetry Distro بيانات تتبع الاستخدام التي يجمعها.

تلميح

إذا لم يكن لديك بالفعل مورد Application Insights، فبادر بإنشاء مورد باتباع هذا الدليل. نوصي بإنشاء مورد جديد بدلا من استخدام مورد موجود.

لنسخ سلسلة الاتصال:

1. انتقل إلى جزء Overview لمورد Application Insights.
2. ابحث عن سلسلة الاتصال.
3. مرر مؤشر الماوس فوق سلسلة الاتصال وحدد أيقونة نسخ إلى الحافظة.

لصق سلسلة الاتصال في بيئتك

للصق سلسلة الاتصال، حدد من الخيارات التالية:

هام

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

للإنتاج، استخدم متغير بيئة أو ملف تكوين (Java فقط).

• تعيين عبر متغير - البيئة الموصى به

  استبدل <Your connection string> في الأمر التالي سلسلة الاتصال.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• تعيين عبر ملف - التكوين Java فقط

  إنشاء ملف تكوين باسم applicationinsights.json، ووضعه في نفس الدليل كما هو الحال applicationinsights-agent-.jar مع المحتوى التالي:

  {
    "connectionString": "<Your connection string>"
  }
  

  استبدل <Your connection string> في JSON السابق سلسلة الاتصال الفريدة.

• تعيين عبر التعليمات البرمجية - ASP.NET Core Node.js وPython فقط

  راجع تكوين سلسلة الاتصال للحصول على مثال لإعداد سلسلة الاتصال عبر التعليمات البرمجية.

إشعار

إذا قمت بتعيين سلسلة الاتصال في أماكن متعددة، سيتم إعطاء الأولوية لمتغير البيئة بالترتيب التالي:

1. رمز
2. متغير البيئة
3. ملف التكوين

تأكيد أن البيانات تتدفق

قم بتشغيل التطبيق الخاص بك، ثم افتح Application Insights في مدخل Microsoft Azure. قد يستغرق ظهور البيانات بضع دقائق.

تم تمكين Application Insights الآن لتطبيقك. الخطوات التالية اختيارية وتسمح بمزيد من التخصيص.

هام

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

كجزء من استخدام تقرير عن حالة النظام لدى Application Insights، نقوم بجمع بيانات التشخيص وإرسالها إلى Microsoft. تساعدنا هذه البيانات على تشغيل وتحسين تطبيق رؤى. لمعرفة المزيد، راجع Statsbeat في Azure Application Insights.

التطبيقات النموذج

تتوفر تطبيقات نموذج القياس المفتوح ل Azure Monitor لجميع اللغات المدعومة:

• تطبيق عينة ASP.NET Core
• تطبيق عينة NET
• تطبيقات نموذج Java
• تطبيقات نموذج Java GraalVM الأصلية
• Node.js عينة التطبيق
• تطبيقات نموذج Python

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

ASP.NET Core

• للحصول على تفاصيل حول إضافة وتعديل Azure Monitor OpenTelemetry، راجع إضافة وتعديل Azure Monitor OpenTelemetry.
• لمزيد من تكوين توزيع بيانات تتبع استخدام OpenTelemetry، راجع تكوين القياس المفتوح ل Azure Monitor.
• لمراجعة التعليمات البرمجية المصدر، راجع مستودع Azure Monitor AspNetCore GitHub.
• لتثبيت حزمة NuGet، تحقق من وجود تحديثات، أو عرض ملاحظات الإصدار، راجع صفحة Azure Monitor AspNetCore NuGet Package .
• لتصبح أكثر دراية ب Azure Monitor وOpenTelemetry، راجع تطبيق مثال Azure Monitor.
• لمعرفة المزيد عن OpenTelemetry ومجتمعه، تفضل بزيارة مستودع OpenTelemetry .NET GitHub.
• لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.
• لمراجعة الأسئلة المتداولة أو خطوات استكشاف الأخطاء وإصلاحها أو خيارات الدعم أو لتقديم ملاحظات OpenTelemetry، راجع تعليمات القياس المفتوح والدعم والملاحظات ل Azure Monitor Application Insights.

NET.

• للحصول على تفاصيل حول إضافة وتعديل Azure Monitor OpenTelemetry، راجع إضافة وتعديل Azure Monitor OpenTelemetry.
• لمزيد من تكوين توزيع بيانات تتبع استخدام OpenTelemetry، راجع تكوين القياس المفتوح ل Azure Monitor.
• لمراجعة التعليمات البرمجية المصدر، راجع مستودع Azure Monitor Source GitHub.
• لتثبيت حزمة PyPI أو التحقق من وجود تحديثات أو عرض ملاحظات الإصدار راجع صفحة حزمة PyPI المصدر Azure مراقبة.
• لتصبح أكثر دراية ب Azure Monitor وOpenTelemetry، راجع تطبيق مثال Azure Monitor.
• لمعرفة المزيد عن OpenTelemetry ومجتمعه، تفضل بزيارة مستودع OpenTelemetry .NET GitHub.
• لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.
• لمراجعة الأسئلة المتداولة أو خطوات استكشاف الأخطاء وإصلاحها أو خيارات الدعم أو لتقديم ملاحظات OpenTelemetry، راجع تعليمات القياس المفتوح والدعم والملاحظات ل Azure Monitor Application Insights.

Java

• راجع إضافة وتعديل Azure Monitor OpenTelemetry للحصول على تفاصيل حول إضافة وتعديل Azure Monitor OpenTelemetry.
• راجع خيارات تكوين البنية التلقائية ل Java.
• راجع التعليمات البرمجية المصدر في مستودع Azure Monitor Java autoinstrumentation GitHub.
• تعرف على المزيد حول OpenTelemetry ومجتمعه في مستودع OpenTelemetry Java GitHub.
• تمكين تجارب الاستخدام من خلال رؤية تمكين مراقبة مستخدم الويب أو المستعرض.
• راجع ملاحظات الإصدار على GitHub.
• لمراجعة الأسئلة المتداولة أو خطوات استكشاف الأخطاء وإصلاحها أو خيارات الدعم أو لتقديم ملاحظات OpenTelemetry، راجع تعليمات القياس المفتوح والدعم والملاحظات ل Azure Monitor Application Insights.

Java الأصلي

• راجع إضافة وتعديل Azure Monitor OpenTelemetry للحصول على تفاصيل حول إضافة وتعديل Azure Monitor OpenTelemetry.
• راجع التعليمات البرمجية المصدر في Azure Monitor OpenTelemetry Distro في تطبيق Java للصورة الأصلية ل Spring Boot ومصدر Quarkus OpenTelemetry ل Azure.
• تعرف على المزيد حول OpenTelemetry ومجتمعه في مستودع OpenTelemetry Java GitHub.
• تعرف على المزيد من الميزات لتطبيقات الصور الأصلية ل Spring Boot في OpenTelemetry SpringBoot starter
• تعرف على المزيد من الميزات لتطبيقات Quarkus الأصلية في مصدر Quarkus OpenTelemetry ل Azure.
• راجع ملاحظات الإصدار على GitHub.
• لمراجعة الأسئلة المتداولة أو خطوات استكشاف الأخطاء وإصلاحها أو خيارات الدعم أو لتقديم ملاحظات OpenTelemetry، راجع تعليمات القياس المفتوح والدعم والملاحظات ل Azure Monitor Application Insights.

Node.js

• للحصول على تفاصيل حول إضافة وتعديل Azure Monitor OpenTelemetry، راجع إضافة وتعديل Azure Monitor OpenTelemetry.
• لمراجعة التعليمات البرمجية المصدر، راجع مستودع Azure Monitor OpenTelemetry GitHub.
• لتثبيت حزمة npm والتحقق من وجود تحديثات، راجع صفحة حزمة @azure/monitor-opentelemetry npm.
• أصبح أكثر دراية Azure Monitor Application Insights وOpenTelemetry، راجع تطبيق Azure مراقبة المثال.
• لمعرفة المزيد عن القياس عن بُعد المفتوح ومجتمعه، راجع مستودع Java GitHub للقياس عن بُعد المفتوح.
• لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.
• لمراجعة الأسئلة المتداولة أو خطوات استكشاف الأخطاء وإصلاحها أو خيارات الدعم أو لتقديم ملاحظات OpenTelemetry، راجع تعليمات القياس المفتوح والدعم والملاحظات ل Azure Monitor Application Insights.

Python

• راجع إضافة وتعديل Azure Monitor OpenTelemetry للحصول على تفاصيل حول إضافة وتعديل Azure Monitor OpenTelemetry.
• راجع التعليمات البرمجية المصدر والوثائق الإضافية في مستودع Azure Monitor Distro GitHub.
• راجع عينات إضافية وحالات استخدام في نماذج Azure Monitor Distro.
• راجع سجل التغيير على GitHub.
• قم بتثبيت حزمة PyPI أو التحقق من وجود تحديثات أو عرض ملاحظات الإصدار على صفحة حزمة Azure Monitor Distro PyPI Package .
• تعرف أكثر على Azure Monitor Application Insights وOpenTelemetry في تطبيق مثال Azure Monitor.
• تعرف على المزيد حول OpenTelemetry ومجتمعه في مستودع OpenTelemetry Python GitHub.
• راجع أدوات ومكونات OpenTelemetry المتوفرة في مستودع OpenTelemetry Contributor Python GitHub.
• تمكين تجارب الاستخدام عن طريق تمكين مراقبة مستخدم الويب أو المستعرض.
• لمراجعة الأسئلة المتداولة أو خطوات استكشاف الأخطاء وإصلاحها أو خيارات الدعم أو لتقديم ملاحظات OpenTelemetry، راجع تعليمات القياس المفتوح والدعم والملاحظات ل Azure Monitor Application Insights.