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

تصف هذه المقالة كيفية تمكين وتكوين جمع البيانات القائم على OpenTelemetry ضمن Azure Monitor Application Insights. The Azure Monitor OpenTelemetry Distro:

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

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

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

حالة إصدار OpenTelemetry

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

إشعار

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

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

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

إشعار

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

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

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

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

تلميح

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

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

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

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

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

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

ثبت أحدث @azure/monitor-opentelemetry باقة:

npm install @azure/monitor-opentelemetry

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

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

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

pip install azure-monitor-opentelemetry

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

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

أضف المصدر 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();
    });
});

إشعار

لمزيد من المعلومات، راجع الدليل التعليمي getting-start ل OpenTelemetry .NET

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

وجه Java الآلة الافتراضية (JVM) إلى ملف jar بإضافة -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" إلى ملفات JVM الخاصة بتطبيقك.

إشعار

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

تلميح

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

تلميح

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

// 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();

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

# Configure OpenTelemetry to use Azure Monitor with the 
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor(
    logger_name="<your_logger_namespace>",  # Set the namespace for the logger in which you would like to collect telemetry for if you are collecting logging telemetry. This is imperative so you do not collect logging telemetry from the SDK itself.
)
logger = logging.getLogger("<your_logger_namespace>")  # Logging telemetry will be collected from logging calls made with this logger and all of it's children loggers.

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

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

تلميح

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

لنسخ connection string:

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

الصق connection string في بيئتك

للصق connection string، اختر من الخيارات التالية:

هام

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

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

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

استبدل <Your connection string> في الأمر التالي ب connection string الخاص بك.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Set عبر ملف التكوين - Java فقط

إنشاء ملف تكوين باسم applicationinsights.json، ووضعه في نفس الدليل كما هو الحال applicationinsights-agent-3.7.5.jar مع المحتوى التالي:
```
{
  "connectionString": "<Your connection string>"
}
```
استبدل <Your connection string> في JSON السابق ب your connection string فريدة.
set عبر الكود - ASP.NET Core، Node.js، و Python فقط

انظر connection string configuration كمثال على ضبط connection string عبر الكود.

إشعار

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

رمز
متغير البيئة
ملف التكوين

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

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

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

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

إشعار

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

هام

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

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

تلميح

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

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

للحصول على معلومات حول استكشاف الأخطاء وإصلاحها، راجع استكشاف مشكلات OpenTelemetry وإصلاحها في .NET واستكشاف أخطاء تتبع استخدام التطبيق المفقودة وإصلاحها في Azure Monitor Application Insights.

ملاحظات OpenTelemetry

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

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

الدعم

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

بالنسبة Azure support الأعداد، افتح تذكرة Azure support.
بالنسبة إلى مشكلات القياس عن بُعد المفتوح، اتصل بمجتمع القياس عن بُعد المفتوح مباشرة.
للحصول على قائمة بالمشكلات المفتوحة المتعلقة بمصدر 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.
لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.

لمراجعة الشيفرة المصدرية، راجع مستودع Azure Monitor OpenTelemetry for JavaScript.
لمراجعة نموذج تطبيق، راجع Azure Monitor OpenTelemetry ل Node.js.
لتثبيت حزمة npm والتحقق من وجود تحديثات، راجع صفحة حزمة@azure/monitor-opentelemetry npm.
لمعرفة المزيد عن OpenTelemetry ومجتمعها، راجع OpenTelemetry JavaScript GitHub repository.
لتمكين تجارب الاستخدام، قم بتمكين مراقبة مستخدم الويب أو المستعرض.

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2026-03-13

مشاركة عبر

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

حالة إصدار OpenTelemetry

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

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

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

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

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

الصق connection string في بيئتك

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

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

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

ملاحظات OpenTelemetry

الدعم

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

الملاحظات

الموارد الإضافية