تمكين 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.5.4.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-3.5.4.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-3.5.4.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.
• لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.

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.
• لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.

Java

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

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.

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 للقياس عن بُعد المفتوح.
• لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.

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؟

إنه معيار مفتوح المصدر جديد لقابلية الملاحظة. تعرف على المزيد في OpenTelemetry.

لماذا تستثمر Microsoft Azure Monitor في OpenTelemetry؟

تستثمر Microsoft في OpenTelemetry للأسباب التالية:

• إنه محايد للمورد ويوفر واجهات برمجة تطبيقات/SDKs متسقة عبر اللغات.
• مع مرور الوقت، نعتقد أن OpenTelemetry سيمكن عملاء Azure Monitor من مراقبة التطبيقات المكتوبة بلغات تتجاوز لغاتنا المدعومة.
• فهو يوسع أنواع البيانات التي يمكنك جمعها من خلال مجموعة غنية من مكتبات الأجهزة.
• تميل مجموعات تطوير برامج OpenTelemetry (SDKs) إلى أن تكون أكثر أداء على نطاق واسع من أسلافها، وهي Application Insights SDKs.
• يتوافق OpenTelemetry مع استراتيجية Microsoft لتبني مصدر مفتوح.

ما هي حالة OpenTelemetry؟

راجع حالة OpenTelemetry.

ما هو Azure Monitor OpenTelemetry Distro؟

يمكنك التفكير في الأمر على أنه برنامج تضمين رفيع يجمع معا جميع مكونات OpenTelemetry للحصول على تجربة من الدرجة الأولى على Azure. يسمى هذا التضمين أيضا التوزيع في OpenTelemetry.

لماذا يجب استخدام Azure Monitor OpenTelemetry Distro؟

هناك العديد من المزايا لاستخدام Azure Monitor OpenTelemetry Distro على OpenTelemetry الأصلي من المجتمع:

• تقليل جهد التمكين
• مدعوم من قبل Microsoft
• يجلب ميزات خاصة ب Azure مثل:
  • أخذ العينات المتوافق مع Application Insights SDKs الكلاسيكي
  • مصادقة Microsoft Entra
  • التخزين غير المتصل وإعادة المحاولة التلقائية
  • Statsbeat
  • مقاييس Application Insights القياسية
  • الكشف عن بيانات تعريف المورد لملء اسم دور السحابة ومثيل دور السحابة تلقائيا في بيئات Azure المختلفة
  • القياسات المباشرة

بروح OpenTelemetry، صممنا توزيعة لتكون مفتوحة وقابلة للتوسعة. على سبيل المثال، يمكنك إضافة:

• مصدر بروتوكول القياس المفتوح (OTLP) وإرساله إلى وجهة ثانية في وقت واحد
• مكتبات الأجهزة الأخرى غير المضمنة في توزيعة الأجهزة

نظرا لأن Distro يوفر توزيع OpenTelemetry، يدعم Distro أي شيء يدعمه OpenTelemetry. على سبيل المثال، يمكنك إضافة المزيد من معالجات بيانات تتبع الاستخدام أو المصدرين أو مكتبات الأجهزة، إذا كان OpenTelemetry يدعمها.

إشعار

يقوم Distro بتعيين العينة إلى عينة مخصصة ذات معدل ثابت ل Application Insights. يمكنك تغيير هذا إلى عينة مختلفة، ولكن القيام بذلك قد يعطل بعض القدرات المضمنة في Distro. لمزيد من المعلومات حول أداة أخذ العينات المدعومة، راجع قسم تمكين أخذ العينات في تكوين القياس المفتوح ل Azure Monitor.

بالنسبة للغات التي لا تحتوي على مصدر OpenTelemetry مستقل معتمد، فإن Azure Monitor OpenTelemetry Distro هو الطريقة الوحيدة المدعومة حاليا لاستخدام OpenTelemetry مع Azure Monitor. بالنسبة للغات التي لديها مصدر OpenTelemetry مستقل معتمد، لديك خيار استخدام إما Azure Monitor OpenTelemetry Distro أو مصدر OpenTelemetry المستقل المناسب اعتمادا على سيناريو القياس عن بعد. لمزيد من المعلومات، راجع متى يجب استخدام مصدر Azure Monitor OpenTelemetry؟.

كيف يمكنني اختبار Azure Monitor OpenTelemetry Distro؟

تحقق من مستندات التمكين الخاصة بنا ل .NET وJava وJavaScript (Node.js) وPython.

هل يجب استخدام OpenTelemetry أو Application Insights SDK؟

نوصي باستخدام OpenTelemetry Distro ما لم تكن بحاجة إلى ميزة متوفرة فقط مع الدعم الرسمي في Application Insights SDK.

يؤدي اعتماد OpenTelemetry الآن إلى منع الاضطرار إلى الترحيل في وقت لاحق.

متى يجب استخدام مصدر Azure Monitor OpenTelemetry؟

بالنسبة إلى ASP.NET Core وJava Node.js وPython، نوصي باستخدام Azure Monitor OpenTelemetry Distro. إنه سطر واحد من التعليمات البرمجية للبدء.

بالنسبة لجميع سيناريوهات .NET الأخرى، بما في ذلك ASP.NET الكلاسيكية وتطبيقات وحدة التحكم وWindows Forms (WinForms) وما إلى ذلك، نوصي باستخدام مصدر .NET Azure Monitor OpenTelemetry: Azure.Monitor.OpenTelemetry.Exporter.

بالنسبة لسيناريوهات بيانات تتبع الاستخدام Python الأكثر تعقيدا التي تتطلب تكوينا متقدما، نوصي باستخدام مصدر بيانات تتبع الاستخدام المفتوح ل Python Azure Monitor.

ما هي حالة الإصدار الحالية للميزات داخل Azure Monitor OpenTelemetry Distro؟

يقسم المخطط التالي دعم ميزة OpenTelemetry لكل لغة.

ميزة	.NET	Node.js	Python	Java
التتبع الموزع	✅	✅	✅	✅
مقاييس مخصصة	✅	✅	✅	✅
المقاييس القياسية	✅	✅	✅	✅
أخذ العينات بمعدل ثابت	✅	✅	✅	✅
التخزين دون اتصال وإعادة المحاولة التلقائية	✅	✅	✅	✅
الإبلاغ عن الاستثناء	✅	✅	✅	✅
مجموعة السجلات	✅	⚠️	✅	✅
أحداث مخصصة	⚠️	⚠️	⚠️	✅
مصادقة Microsoft Entra	✅	✅	✅	✅
المقاييس المباشرة	✅	✅	✅	✅
تصفية المقاييس المباشرة	✅	❌	❌	❌
الكشف عن سياق الموارد ل VM/VMSS وخدمة التطبيقات	✅	❌	✅	✅
الكشف عن سياق الموارد لخدمة Azure Kubernetes (AKS) والوظائف	❌	❌	❌	✅
أحداث اختبار التوفر التي تم إنشاؤها باستخدام واجهة برمجة تطبيقات تتبع التوفر	❌	❌	❌	✅
تصفية الطلبات والتبعيات والسجلات والاستثناءات حسب معرف المستخدم المجهول والمصدر الاصطناعي	❌	❌	❌	✅
تصفية التبعيات والسجلات والاستثناءات حسب اسم العملية	❌	❌	❌	✅
أخذ العينات التكيفية	❌	❌	❌	✅
منشئ ملفات التعريف	❌	❌	❌	⚠️
Snapshot Debugger	❌	❌	❌	❌

المفتاح

• ✅ تتوفر هذه الميزة لجميع العملاء الذين لديهم دعم رسمي.
• ⚠️ تتوفر هذه الميزة كمعاينة عامة. راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.
• ❌ هذه الميزة غير متوفرة أو غير قابلة للتطبيق.

هل يمكن استخدام OpenTelemetry لمستعرضات الويب؟

نعم، لكننا لا نوصي به ولا يدعمه Azure. تم تحسين OpenTelemetry JavaScript بشكل كبير Node.js. بدلا من ذلك، نوصي باستخدام Application Insights JavaScript SDK.

متى يمكننا توقع توفر OpenTelemetry SDK للاستخدام في مستعرضات الويب؟

لا يحتوي OpenTelemetry web SDK على مخطط زمني محدد للتوفر. من المحتمل أن نكون على بعد عدة سنوات من متصفح SDK الذي يعد بديلا قابلا للتطبيق Insights JavaScript SDK.

هل يمكنني اختبار OpenTelemetry في مستعرض ويب اليوم؟

تعد بيئة الاختبار المعزولة للويب OpenTelemetry نسخة المستودع المصممة لجعل OpenTelemetry تعمل في مستعرض. لا يمكن بعد إرسال بيانات تتبع الاستخدام إلى Application Insights. لا تحدد SDK أحداث العميل العامة.

هل يتم دعم تشغيل Application Insights جنبا إلى جنب مع وكلاء منافسين مثل AppDynamics وDataDog و NewRelic؟

هذه الممارسة ليست شيئا نخطط لاختباره أو دعمه، على الرغم من أن Distros الخاصة بنا تسمح لك بالتصدير إلى نقطة نهاية OTLP جنبا إلى جنب مع Azure Monitor في وقت واحد.

هل يمكنني استخدام ميزات المعاينة في بيئات الإنتاج؟

لا نوصي بذلك. راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.

ما الفرق بين الأجهزة اليدوية والتلقائية؟

راجع نظرة عامة على OpenTelemetry.

هل يمكنني استخدام OpenTelemetry Collector؟

يستخدم بعض العملاء OpenTelemetry Collector كبديل للعامل، على الرغم من أن Microsoft لا تدعم رسميا نهجا يستند إلى عامل لمراقبة التطبيق حتى الآن. في هذه الأثناء، ساهم مجتمع المصدر المفتوح بمصدر OpenTelemetry Collector Azure Monitor الذي يستخدمه بعض العملاء لإرسال البيانات إلى Azure Monitor Application Insights. هذا غير معتمد من قبل Microsoft.

ما الفرق بين OpenCensus وOpenTelemetry؟

OpenCensus هو مقدمة OpenTelemetry. ساعدت Microsoft في الجمع بين OpenTracing وOpenCensus لإنشاء OpenTelemetry، وهو معيار واحد للمراقبة للعالم. تستند Python SDK الحالية الموصى بها للإنتاج ل Azure Monitor إلى OpenCensus. تلتزم Microsoft بإجراء Azure Monitor استنادا إلى OpenTelemetry.

في Grafana، لماذا أرى Status: 500. Can't visualize trace events using the trace visualizer؟

قد تحاول تصور سجلات النص الخام بدلا من تتبعات OpenTelemetry.

في Application Insights، يخزن جدول "Traces" سجلات النصوص الأولية لأغراض التشخيص. وهي تساعد في تحديد التتبعات المرتبطة بطلبات المستخدم والأحداث الأخرى وتقارير الاستثناءات وربطها. ومع ذلك، لا يساهم جدول "التتبعات" مباشرة في عرض المعاملة الشاملة (المخطط الانحداري) في أدوات التصور مثل Grafana.

مع الاعتماد المتزايد للممارسات السحابية الأصلية، هناك تطور في جمع المصطلحات وبيانات تتبع الاستخدام. أصبح OpenTelemetry معيارا لجمع بيانات تتبع الاستخدام ووضع الأجهزة لها. في هذا السياق، اتخذ مصطلح "التتبعات" معنى جديدا. بدلا من السجلات الأولية، تشير "التتبعات" في OpenTelemetry إلى شكل أغنى ومنظم لبيانات تتبع الاستخدام يتضمن امتدادات، والتي تمثل وحدات عمل فردية. هذه الامتدادات ضرورية لإنشاء طرق عرض مفصلة للمعاملات، ما يتيح مراقبة وتشخيص أفضل للتطبيقات الأصلية على السحابة.

استكشاف الأخطاء وإصلاحها

ASP.NET Core

الخطوة 1: تمكين التسجيل التشخيصي

يستخدم مصدر Azure Monitor EventSource لتسجيل الدخول الداخلي الخاص به. تتوفر سجلات المصدر لأي EventListener عن طريق الاشتراك في المصدر المسمى OpenTelemetry-AzureMonitor-Exporter. للحصول على خطوات استكشاف الأخطاء وإصلاحها، راجع استكشاف أخطاء OpenTelemetry وإصلاحها على GitHub.

الخطوة 2: اختبار الاتصال بين مضيف التطبيق وخدمة الاستيعاب

ترسل Application Insights SDKs والوكلاء بيانات تتبع الاستخدام للحصول على استيعابها كمكالمات REST في نقاط نهاية الاستيعاب لدينا. لاختبار الاتصال من خادم الويب أو الكمبيوتر المضيف للتطبيق إلى نقاط نهاية خدمة الاستيعاب، استخدم أوامر cURL أو طلبات REST الأولية من PowerShell. لمزيد من المعلومات، راجع استكشاف أخطاء بيانات تتبع استخدام التطبيق المفقودة وإصلاحها في Azure Monitor Application Insights.

المشكلات المعروفة

العناصر التالية هي مشكلات معروفة لمصدري القياس المفتوح ل Azure Monitor:

• اسم العملية مفقود من القياس عن بعد للتبعية. يتسبب اسم العملية المفقود في حدوث حالات فشل ويؤثر سلبا على تجربة علامة تبويب الأداء.

• نموذج الجهاز مفقود من بيانات تتبع الاستخدام للطلب والتبعية. يؤثر نموذج الجهاز المفقود سلبا على تحليل مجموعة الأجهزة.

NET.

الخطوة 1: تمكين التسجيل التشخيصي

يستخدم مصدر Azure Monitor EventSource لتسجيل الدخول الداخلي الخاص به. تتوفر سجلات المصدر لأي EventListener عن طريق الاشتراك في المصدر المسمى OpenTelemetry-AzureMonitor-Exporter. للحصول على خطوات استكشاف الأخطاء وإصلاحها، راجع استكشاف أخطاء OpenTelemetry وإصلاحها على GitHub.

الخطوة 2: اختبار الاتصال بين مضيف التطبيق وخدمة الاستيعاب

ترسل Application Insights SDKs والوكلاء بيانات تتبع الاستخدام للحصول على استيعابها كمكالمات REST في نقاط نهاية الاستيعاب لدينا. لاختبار الاتصال من خادم الويب أو الكمبيوتر المضيف للتطبيق إلى نقاط نهاية خدمة الاستيعاب، استخدم أوامر cURL أو طلبات REST الأولية من PowerShell. لمزيد من المعلومات، راجع استكشاف أخطاء بيانات تتبع استخدام التطبيق المفقودة وإصلاحها في Azure Monitor Application Insights.

المشكلات المعروفة

العناصر التالية هي مشكلات معروفة لمصدري القياس المفتوح ل Azure Monitor:

• اسم العملية مفقود من القياس عن بعد للتبعية. يتسبب اسم العملية المفقود في حدوث حالات فشل ويؤثر سلبا على تجربة علامة تبويب الأداء.

• نموذج الجهاز مفقود من بيانات تتبع الاستخدام للطلب والتبعية. يؤثر نموذج الجهاز المفقود سلبا على تحليل مجموعة الأجهزة.

Java

الخطوة 1: تمكين التسجيل التشخيصي

بشكل افتراضي، يتم تمكين التسجيل التشخيصي في Azure Monitor Application Insights. لمزيد من المعلومات، راجع دليل استكشاف الأخطاء وإصلاحها: Azure Monitor Application Insights ل Java.

الخطوة 2: اختبار الاتصال بين مضيف التطبيق وخدمة الاستيعاب

ترسل Application Insights SDKs والوكلاء بيانات تتبع الاستخدام للحصول على استيعابها كمكالمات REST في نقاط نهاية الاستيعاب لدينا. لاختبار الاتصال من خادم الويب أو الكمبيوتر المضيف للتطبيق إلى نقاط نهاية خدمة الاستيعاب، استخدم أوامر cURL أو طلبات REST الأولية من PowerShell. لمزيد من المعلومات، راجع استكشاف أخطاء بيانات تتبع استخدام التطبيق المفقودة وإصلاحها في Azure Monitor Application Insights.

المشكلات المعروفة

• إذا قمت بتنزيل مكتبة عميل Application Insights للتثبيت من مستعرض، في بعض الأحيان يكون ملف JAR الذي تم تنزيله تالفة وهو حوالي نصف حجم الملف المصدر. إذا واجهت هذه المشكلة، فبادر بتنزيل ملف JAR عن طريق تشغيل الأمر curl أو wget ، كما هو موضح في مثال استدعاءات الأوامر التالية:

  curl --location --output applicationinsights-agent-3.4.11.jar https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.11/applicationinsights-agent-3.4.11.jar
  

  wget --output-document=applicationinsights-agent-3.4.11.jar https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.11/applicationinsights-agent-3.4.11.jar
  

  إشعار

  ينطبق مثال استدعاءات الأمر على Application Insights ل Java الإصدار 3.4.11. للعثور على رقم الإصدار وعنوان URL للإصدار الحالي من Application Insights ل Java، راجع https://github.com/microsoft/ApplicationInsights-Java/releases.

Java الأصلي

تنطبق الخطوات التالية على تطبيقات Spring Boot الأصلية.

الخطوة 1: تحقق من إصدار OpenTelemetry

قد تلاحظ الرسالة التالية أثناء بدء تشغيل التطبيق:

WARN  c.a.m.a.s.OpenTelemetryVersionCheckRunner - The OpenTelemetry version is not compatible with the spring-cloud-azure-starter-monitor dependency.
The OpenTelemetry version should be <version>

في هذه الحالة، يجب عليك استيراد فواتير المواد OpenTelemetry باتباع وثائق OpenTelemetry في بداية Spring Boot.

الخطوة 2: تمكين التشخيص الذاتي

إذا لم يعمل شيء ما كما هو متوقع، يمكنك تمكين التشخيص الذاتي على DEBUG المستوى للحصول على بعض الرؤى. للقيام بذلك، قم بتعيين مستوى التشخيص الذاتي إلى ERRORأو DEBUGTRACE WARNINFOباستخدام APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL متغير البيئة.

لتمكين التشخيص الذاتي على DEBUG المستوى عند تشغيل حاوية docker، قم بتشغيل الأمر التالي:

docker run -e APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL=DEBUG <image-name>

إشعار

استبدل <image-name> باسم صورة docker وفقا لذلك.

إخلاء المسؤولية عن معلومات الجهات الخارجية

يتم تصنيع منتجات الجهات الخارجية التي تتناولها هذه المقالة من قبل شركات مستقلة عن Microsoft. لا تقدم Microsoft أي ضمان، ضمنيًا أو غير ذلك، حول أداء هذه المنتجات أو موثوقيتها.

Node.js

الخطوة 1: تمكين التسجيل التشخيصي

يستخدم مصدر Azure Monitor مسجل OpenTelemetry API للسجلات الداخلية. لتمكين المسجل، قم بتشغيل القصاصة البرمجية التالية:

const { diag, DiagConsoleLogger, DiagLogLevel } = require("@opentelemetry/api");
const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");

const provider = new NodeTracerProvider();
diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ALL);
provider.register();

الخطوة 2: اختبار الاتصال بين مضيف التطبيق وخدمة الاستيعاب

ترسل Application Insights SDKs والوكلاء بيانات تتبع الاستخدام للحصول على استيعابها كمكالمات REST في نقاط نهاية الاستيعاب لدينا. لاختبار الاتصال من خادم الويب أو الكمبيوتر المضيف للتطبيق إلى نقاط نهاية خدمة الاستيعاب، استخدم أوامر cURL أو طلبات REST الأولية من PowerShell. لمزيد من المعلومات، راجع استكشاف أخطاء بيانات تتبع استخدام التطبيق المفقودة وإصلاحها في Azure Monitor Application Insights.

المشكلات المعروفة

العناصر التالية هي مشكلات معروفة لمصدري القياس المفتوح ل Azure Monitor:

• اسم العملية مفقود من القياس عن بعد للتبعية. يتسبب اسم العملية المفقود في حدوث حالات فشل ويؤثر سلبا على تجربة علامة تبويب الأداء.

• نموذج الجهاز مفقود من بيانات تتبع الاستخدام للطلب والتبعية. يؤثر نموذج الجهاز المفقود سلبا على تحليل مجموعة الأجهزة.

• اسم خادم قاعدة البيانات مفقود من اسم التبعية. نظرا لعدم تضمين اسم خادم قاعدة البيانات، يقوم مصدرو OpenTelemetry بتجميع الجداول التي لها نفس الاسم بشكل غير صحيح على خوادم مختلفة.

Python

الخطوة 1: تمكين التسجيل التشخيصي

يستخدم مصدر مراقبة Microsoft Azure مكتبة تسجيل Python القياسية للتسجيل الداخلي الخاص به. يتم تعيين OpenTelemetry API وسجلات مصدر Azure Monitor مستوى WARNING خطورة أو ERROR للنشاط غير المنتظم. INFO يتم استخدام مستوى الخطورة للنشاط العادي أو الناجح.

بشكل افتراضي، تعين مكتبة تسجيل Python مستوى الخطورة إلى WARNING. لذلك، يجب تغيير مستوى الخطورة لمشاهدة السجلات ضمن إعداد الخطورة هذا. يوضح مثال التعليمات البرمجية التالي كيفية إخراج سجلات من جميع مستويات الخطورة إلى وحدة التحكم وملف:

...
import logging

logging.basicConfig(format = "%(asctime)s:%(levelname)s:%(message)s", level = logging.DEBUG)

logger = logging.getLogger(__name__)
file = logging.FileHandler("example.log")
stream = logging.StreamHandler()
logger.addHandler(file)
logger.addHandler(stream)
...

الخطوة 2: اختبار الاتصال بين مضيف التطبيق وخدمة الاستيعاب

ترسل Application Insights SDKs والوكلاء بيانات تتبع الاستخدام للحصول على استيعابها كمكالمات REST في نقاط نهاية الاستيعاب لدينا. لاختبار الاتصال من خادم الويب أو الكمبيوتر المضيف للتطبيق إلى نقاط نهاية خدمة الاستيعاب، استخدم أوامر cURL أو طلبات REST الأولية من PowerShell. لمزيد من المعلومات، راجع استكشاف أخطاء بيانات تتبع استخدام التطبيق المفقودة وإصلاحها في Azure Monitor Application Insights.

الخطوة 3: تجنب بيانات تتبع الاستخدام المكررة

غالبا ما يحدث تكرار القياس عن بعد إذا قمت بإنشاء مثيلات متعددة من المعالجات أو المصدرين. تأكد من تشغيل مصدر ومعالج واحد فقط في كل مرة لكل عمود بيانات تتبع الاستخدام (السجلات والمقاييس والتتبع الموزع).

تصف الأقسام التالية السيناريوهات التي يمكن أن تسبب بيانات تتبع الاستخدام المكررة.

سجلات التتبع المكررة في Azure Functions

إذا رأيت زوجا من الإدخالات لكل سجل تتبع داخل Application Insights، فربما قمت بتمكين الأنواع التالية من أدوات التسجيل:

• أدوات التسجيل الأصلية في Azure Functions
• azure-monitor-opentelemetry أدوات التسجيل داخل التوزيع

لمنع التكرار، يمكنك تعطيل تسجيل التوزيع، ولكن اترك أدوات التسجيل الأصلية في Azure Functions ممكنة. للقيام بذلك، قم بتعيين OTEL_LOGS_EXPORTER متغير البيئة إلى None.

بيانات تتبع الاستخدام المكررة في وظائف Azure "Always On"

إذا تم تعيين الإعداد Always On في Azure Functions إلى On، فإن Azure Functions تحتفظ ببعض العمليات قيد التشغيل في الخلفية بعد اكتمال كل تشغيل. على سبيل المثال، افترض أن لديك دالة مؤقت مدتها خمس دقائق تستدعي configure_azure_monitor في كل مرة. بعد 20 دقيقة، قد يكون لديك أربعة مصدرين متريين يعملون في نفس الوقت. قد يكون هذا الموقف مصدر القياس عن بعد للمقاييس المكررة.

في هذه الحالة، قم إما بتعيين الإعداد Always On إلى Off، أو حاول إيقاف تشغيل الموفرين يدويا بين كل configure_azure_monitor مكالمة. لإيقاف تشغيل كل موفر، قم بتشغيل استدعاءات إيقاف التشغيل لكل مقياس وتتبع وموفر مسجل حالي، كما هو موضح في التعليمات البرمجية التالية:

get_meter_provider().shutdown()
get_tracer_provider().shutdown()
get_logger_provider().shutdown()

مصنفات Azure ودفاتر ملاحظات Jupyter

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

الخطوة 4: تأكد من جمع بيانات طلب Flask

إذا قمت بتنفيذ تطبيق Flask، فقد تجد أنه لا يمكنك جمع بيانات جدول الطلبات من Application Insights أثناء استخدام مكتبة عميل Azure Monitor OpenTelemetry Distro ل Python. قد تحدث هذه المشكلة إذا لم تقم بتركيب إعلاناتك import بشكل صحيح. قد تقوم باستيراد flask.Flask إطار عمل تطبيق الويب قبل استدعاء الدالة configure_azure_monitor لوضع علامة على مكتبة Flask. على سبيل المثال، لا تقوم التعليمات البرمجية التالية بأداة تطبيق Flask بنجاح:

from azure.monitor.opentelemetry import configure_azure_monitor
from flask import Flask

configure_azure_monitor()

app = Flask(__name__)

بدلا من ذلك، نوصي باستيراد flask الوحدة النمطية ككل، ثم استدعاء configure_azure_monitor لتكوين OpenTelemetry لاستخدام Azure Monitor قبل الوصول إلى flask.Flask:

from azure.monitor.opentelemetry import configure_azure_monitor
import flask

configure_azure_monitor()

app = flask.Flask(__name__)

بدلا من ذلك، يمكنك الاتصال configure_azure_monitor قبل استيراد flask.Flask:

from azure.monitor.opentelemetry import configure_azure_monitor

configure_azure_monitor()

from flask import Flask

app = Flask(__name__)

يدعم

حدد علامة تبويب للغة التي تختارها لاكتشاف خيارات الدعم.

ASP.NET Core

• بالنسبة إلى مشكلات دعم Azure، افتح تذكرة دعم Azure.
• بالنسبة إلى مشكلات القياس عن بُعد المفتوح، اتصل بمجتمع القياس عن بُعد المفتوح مباشرة.
• للحصول على قائمة بالمشكلات المفتوحة المتعلقة بمصدر Azure Monitor، راجع صفحة مشكلات GitHub.

NET.

• بالنسبة إلى مشكلات دعم Azure، افتح تذكرة دعم Azure.
• بالنسبة إلى مشكلات القياس عن بُعد المفتوح، اتصل بمجتمع القياس عن بُعد المفتوح مباشرة.
• للحصول على قائمة بالمشكلات المفتوحة المتعلقة بمصدر Azure Monitor، راجع صفحة مشكلات GitHub.

Java

• بالنسبة إلى مشكلات دعم Azure، افتح تذكرة دعم Azure.
• للحصول على تعليمات حول استكشاف الأخطاء وإصلاحها، راجع خطوات استكشاف الأخطاء وإصلاحها.
• بالنسبة إلى مشكلات القياس عن بُعد المفتوح، اتصل بمجتمع القياس عن بُعد المفتوح مباشرة.
• للحصول على قائمة بالمشكلات المفتوحة المتعلقة ب Azure Monitor Java Autoinstrumentation، راجع صفحة مشكلات GitHub.

Java الأصلي

• بالنسبة إلى مشكلات دعم Azure، افتح تذكرة دعم Azure.
• بالنسبة إلى مشكلات القياس عن بُعد المفتوح، اتصل بمجتمع القياس عن بُعد المفتوح مباشرة.
• للحصول على قائمة بالمشكلات المفتوحة مع تطبيقات Spring Boot الأصلية، راجع صفحة مشكلات GitHub.
• للحصول على قائمة بالمشكلات المفتوحة مع تطبيقات Quarkus الأصلية، راجع صفحة مشكلات GitHub.

Node.js

• بالنسبة إلى مشكلات دعم Azure، افتح تذكرة دعم Azure.
• بالنسبة إلى مشكلات القياس عن بُعد المفتوح، اتصل بمجتمع القياس عن بُعد المفتوح مباشرة.
• للحصول على قائمة بالمشكلات المفتوحة المتعلقة بمصدر Azure Monitor، راجع صفحة مشكلات GitHub.

Python

• بالنسبة إلى مشكلات دعم Azure، افتح تذكرة دعم Azure.
• بالنسبة إلى مشكلات القياس عن بُعد المفتوح، اتصل بمجتمع القياس عن بُعد المفتوح مباشرة.
• للحصول على قائمة بالمشكلات المفتوحة المتعلقة ب Azure Monitor Distro، راجع صفحة مشكلات GitHub.

ردود فعل القياس عن بُعد المفتوح

لتقديم التعليقات:

• املأ استطلاع آراء العملاءفي مجتمع القياس عن بُعد المفتوح.
• أخبر Microsoft قليلاً عن نفسك من خلال الانضمام إلى مجتمع المستخدم المبكر للتطبيقات لـ OpenTelemetry.
• التفاعل مع مستخدمي Azure Monitor الآخرين في Microsoft Tech Community.
• قدم طلب ميزة في منتدى ملاحظات Azure.