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

تصف هذه المقالة كيفية تمكين وتكوين جمع البيانات القائم على OpenTelemetry ضمن Azure Monitor Application Insights باستخدام توزيعة OpenTelemetry Azure Monitor. OpenTelemetry هو معيار الرصد مفتوح المصدر CNCF؛ توزيع Azure Monitor OpenTelemetry Distro هو توزيع Microsoft لهذا المعيار، محسن ل Azure Monitor. التوزيعة:

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

لمعرفة المزيد عن جمع البيانات باستخدام OpenTelemetry، اطلع على نظرة عامة على Application Insights أو الأسئلة الشائعة OpenTelemetry.

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

تلميح

للحصول على نظرة عامة مفاهيمية على خيارات OpenTelemetry في Azure Monitor — مثل الإدخال الأصلي عبر OTLP، وتوزيع OpenTelemetry Microsoft، وتجارب الملاحظة من البداية إلى النهاية — انظر OpenTelemetry مع Azure Monitor.

حالة إصدار OpenTelemetry

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

إشعار

لتطبيقات الوظائف Azure، راجع Use OpenTelemetry مع دالات Azure.

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

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

يلخص الجدول التالي الحزم وأوامر التثبيت لكل لغة مدعومة:

اللغة الحزمة أمر تثبيت
ASP.NET Core Azure.Monitor.OpenTelemetry.AspNetCore dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore
.NET Azure.Monitor.OpenTelemetry.Exporter dotnet add package Azure.Monitor.OpenTelemetry.Exporter
Java applicationinsights-agent-3.7.8.jar تحميل من GitHub
Node.js @azure/monitor-opentelemetry npm install @azure/monitor-opentelemetry
Python azure-monitor-opentelemetry pip install azure-monitor-opentelemetry

إشعار

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

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

تلميح

إذا كنت تنتقل من مجموعات تطوير التطبيقات القديمة لروآة التطبيقات، راجع وثائق الترحيل الخاصة بنا.

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

ثبت أحدث إصدار من Azure.Monitor.OpenTelemetry.AspNetCoreNuGet باقة:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

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

استورد مساحة الأسماء 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();

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

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

تلميح

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

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

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

لقطة شاشة تعرض نظرة عامة على Application Insights و سلسلة الاتصال.

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

للصق سلسلة الاتصال، استخدم إحدى الطرق التالية:

الطريقة اللغات المدعومة موصى به ل
متغير البيئة الكل الإنتاج
ملف التكوين (applicationinsights.json) Java فقط الإنتاج (Java)
رمز ASP.NET Core، Node.js، Python التطوير المحلي/الاختبار فقط

هام

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

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

  • تعيين رؤى التطبيقات سلسلة الاتصال كمتغير بيئي (موصى به للإنتاج)

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

    APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
    
  • Set the Application Insights سلسلة الاتصال في ملف تكوين - Java فقط

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

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

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

  • اضبط رؤى التطبيقات سلسلة الاتصال في الكود - ASP.NET Core، Node.js، و Python فقط

    انظر سلسلة الاتصال configuration كمثال على ضبط سلسلة الاتصال عبر الكود.

إشعار

إذا ضبطت سلسلة الاتصال في عدة أماكن، يتم حلها بترتيب الأسبقية التالي (من الأعلى إلى الأدنى):

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

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

بعد أن تقوم بتكوين Azure Monitor OpenTelemetry Distry وضبط سلسلة الاتصال، قم بتشغيل تطبيقك وافتح مورد Application Insights الخاص بك في بوابة Azure للتحقق من ظهور التتبع والمقاييس والسجلات. قد يستغرق ظهور البيانات بضع دقائق.

لقطة شاشة لعلامة التبويب Application Insights Overview مع تمييز طلبات الخادم ووقت استجابة الخادم.

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

إشعار

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

هام

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

استكشاف المشكلات، الملاحظات، والدعم

تلميح

الأقسام التالية متوفرة في جميع مقالات توزيع OpenTelemetry.

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

للحصول على معلومات استكشاف المشكلة، راجع Troubleshoot Trouble Issues OpenTelemetry في .NET و Troubleshoot في بيانات التطبيقات المفقودة في Application Insights Azure Monitor.

ملاحظات OpenTelemetry

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

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

الدعم

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

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

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