إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تصف هذه المقالة كيفية تمكين وتكوين جمع البيانات القائم على OpenTelemetry ضمن Azure Monitor Application Insights باستخدام توزيعة OpenTelemetry Azure Monitor. OpenTelemetry هو معيار الرصد مفتوح المصدر CNCF؛ توزيع Azure Monitor OpenTelemetry Distro هو توزيع Microsoft لهذا المعيار، محسن ل Azure Monitor. التوزيعة:
- يوفر توزيع OpenTelemetry، والذي يتضمن دعما لميزات خاصة ب Azure Monitor.
- يتيح جمع البيانات التلقائي من خلال تضمين مكتبات أجهزة أوبن تيليمتري لجمع الآثار، والمقاييس، والسجلات، والاستثناءات.
- يسمح بجمع بيانات تتبع الاستخدام المخصصة .
- يدعم Live Metrics لمراقبة وجمع البيانات عن بعد من تطبيقات الويب الحية والإنتاجية.
لمزيد من المعلومات حول مزايا استخدام توزيعة 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 الاشتراك: إنشاء اشتراك Azure مجانا
- مورد Application Insights: إنشاء مورد Application Insights
- ASP.NET Core Application باستخدام نسخة مدعومة رسميا من .NET
تلميح
إذا كنت تنتقل من مجموعات تطوير التطبيقات القديمة لروآة التطبيقات، راجع وثائق الترحيل الخاصة بنا.
تثبيت مكتبة العميل
ثبت أحدث إصدار من 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، فبادر بإنشاء مورد باتباع هذا الدليل. نوصي بإنشاء مورد جديد بدلا من استخدام مورد موجود.
لنسخ سلسلة الاتصال:
- انتقل إلى جزء Overview لمورد Application Insights.
- ابحث عن سلسلة الاتصال الخاص بك.
- مرر المؤشر فوق سلسلة الاتصال واختر أيقونة Copy to Clipboard.
الصق سلسلة الاتصال في بيئتك
للصق سلسلة الاتصال، استخدم إحدى الطرق التالية:
| الطريقة | اللغات المدعومة | موصى به ل |
|---|---|---|
| متغير البيئة | الكل | الإنتاج |
ملف التكوين (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 كمثال على ضبط سلسلة الاتصال عبر الكود.
إشعار
إذا ضبطت سلسلة الاتصال في عدة أماكن، يتم حلها بترتيب الأسبقية التالي (من الأعلى إلى الأدنى):
- رمز
- متغير البيئة
- ملف التكوين
تأكيد أن البيانات تتدفق
بعد أن تقوم بتكوين Azure Monitor OpenTelemetry Distry وضبط سلسلة الاتصال، قم بتشغيل تطبيقك وافتح مورد Application Insights الخاص بك في بوابة Azure للتحقق من ظهور التتبع والمقاييس والسجلات. قد يستغرق ظهور البيانات بضع دقائق.
تم تمكين 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.
الخطوات التالية
- لمراجعة الشيفرة المصدرية، راجع مستودع Azure Monitor ASP.NET Core GitHub .
- لمراجعة نموذج تطبيق، راجع Azure Monitor OpenTelemetry لموقع ASP.NET Core.
- لتثبيت حزمة NuGet، والتحقق من التحديثات، أو عرض ملاحظات الإصدار، راجع صفحة Azure Monitor AspNetCore NuGet Package.
- للتعرف أكثر على OpenTelemetry ومجتمعها، راجع OpenTelemetry .NET GitHub repository.
- لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.