إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تحدد سلاسل الاتصال مورد Application Insights الذي يجب أن يرسل إليه التطبيق الذي تم تجهيزه بيانات تتبع الاستخدام. تتكون سلسلة الاتصال من إعدادات متعددة، يتم تمثيل كل منها كزوج قيم المفاتيح ومفصولة بفواصل منقوطة. يبسط أسلوب التكوين الموحد هذا عملية الإعداد عن طريق التخلص من الحاجة إلى إعدادات وكيل متعددة.
هام
تحتوي سلسلة الاتصال على مفتاح أدوات (ikey) ومعرف تطبيق.
ikey هو معرف فريد تستخدمه خدمة الاستيعاب لربط القياس عن بعد بمورد Application Insights محدد. المعرفات الفريدة ل Ikey ليست رموز أمان مميزة أو مفاتيح أمان، ولا تعتبر أسرارا. يتم تحسين سلاسل الاتصال عن طريق إضافة قيمة ApplicationId. هذا التحديث هو ميزة جديدة تدعم الأجهزة التلقائية للسيناريوهات التي تستخدم Open Telemetry SDK. إذا كنت ترغب في حماية مورد Application Insights الخاص بك من إساءة الاستخدام، توفر نقطة نهاية الاستيعاب خيارات استيعاب بيانات تتبع الاستخدام المصادق عليها استنادا إلى معرف Microsoft Entra.
إشعار
في 31 مارس 2025، سينتهي دعم إدخال مفاتيح الأجهزة. سيستمر استيعاب مفتاح الأجهزة في العمل ولكننا لن نقوم بتوفير تحديثات أو أي دعم للميزة. الانتقال إلى سلاسل الاتصال للاستفادة من الإمكانات الجديدة.
قدرات سلسلة الاتصال
- الموثوقية: تجعل سلاسل الاتصال استيعاب بيانات تتبع الاستخدام أكثر موثوقية عن طريق إزالة التبعيات على نقاط نهاية الاستيعاب العمومية.
- الأمان: تسمح سلاسل الاتصال باستيعاب بيانات تتبع الاستخدام المصادق عليه باستخدام مصادقة Microsoft Entra ل Application Insights.
- نقاط النهاية المخصصة (البيئات السحابية السيادية أو المختلطة): تسمح إعدادات نقطة النهاية بإرسال البيانات إلى منطقة Azure Government معينة. (راجع الأمثلة.)
- الخصوصية (نقاط النهاية الإقليمية): تسهل سلاسل الاتصال مخاوف الخصوصية من خلال إرسال البيانات إلى نقاط النهاية الإقليمية، مع ضمان عدم مغادرة البيانات لمنطقة جغرافية.
البحث عن سلسلة الاتصال
تظهر سلسلة الاتصال في قسم Overview في مورد Application Insights.
مخطط
يتم شرح عناصر المخطط في الأقسام التالية.
الحد الأقصى للطول
يبلغ الحد الأقصى لطول الاتصال المعتمد 4096 حرفا.
أزواج مفتاح-قيمة
تتكون سلسلة الاتصال من قائمة من الإعدادات الممثلة كأزواج قيم المفاتيح مفصولة بفواصل منقوطة: key1=value1;key2=value2;key3=value3
تلميح
تتم تغطية أزواج قيم المفاتيح القابلة للتكوين في هذا المستند. بعض أزواج قيم المفاتيح غير قابلة للتكوين ويتم تعيينها تلقائيا، مثل ApplicationId. يمكن تجاهل هذه الأزواج بأمان إذا تمت ملاحظتها في بيئتك.
بناء الجملة
InstrumentationKey(على سبيل المثال، 00000000-0000-0000-0000-000000000000).InstrumentationKeyهو حقل مطلوب .Authorization(على سبيل المثال، ikey). هذا الإعداد اختياري لأننا اليوم ندعم تخويل ikey فقط.EndpointSuffix(على سبيل المثال، applicationinsights.azure.cn). يؤدي تعيين لاحقة نقطة النهاية إلى إعلام SDK بسحابة Azure التي يجب الاتصال بها. تقوم SDK بتجميع بقية نقطة النهاية للخدمات الفردية.نقاط النهاية الصريحة. يمكن تجاوز أي خدمة بشكل صريح في سلسلة الاتصال:
-
IngestionEndpoint(على سبيل المثال،https://dc.applicationinsights.azure.com) -
LiveEndpoint(على سبيل المثال،https://live.applicationinsights.azure.com) -
ProfilerEndpoint(على سبيل المثال،https://profiler.monitor.azure.com) -
SnapshotEndpoint(على سبيل المثال،https://snapshot.monitor.azure.com)
-
مخطط نقطة النهاية
<prefix>.<suffix>
- بادئه: تعريف الخدمة.
- لاحقه: تعريف اسم المجال الشائع.
لاحقات صالحة
- applicationinsights.azure.cn
- applicationinsights.us
لمزيد من المعلومات، راجع المناطق التي تتطلب تعديل نقطة النهاية.
بادئات صالحة
-
استيعاب بيانات تتبع الاستخدام:
dc -
القياسات المباشرة:
live -
محلل ملفات التعريف ل .NET:
profiler -
لقطة:
snapshot
أمثلة سلسلة الاتصال
فيما يلي بعض الأمثلة على سلاسل الاتصال.
سلسلة اتصال مع لاحقة نقطة نهاية
InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;
في هذا المثال، تحدد سلسلة الاتصال لاحقة نقطة النهاية وSDK تنشئ نقاط نهاية الخدمة:
- مخطط التخويل الافتراضي إلى "ikey"
- مفتاح الأجهزة: 00000000-0000-0000-0000-000000000000
- تستند معرفات الموارد الموحدة للخدمة الإقليمية (URIs) إلى لاحقة نقطة النهاية المتوفرة:
- ابتلاع:
https://dc.ai.contoso.com - القياسات المباشرة:
https://live.ai.contoso.com - محلل ملفات التعريف ل .NET:
https://profiler.ai.contoso.com - المصحح:
https://snapshot.ai.contoso.com
- ابتلاع:
سلسلة اتصال ذات تجاوزات صريحة لنقطة النهاية
InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;
في هذا المثال، تحدد سلسلة الاتصال تجاوزات صريحة لكل خدمة. يستخدم SDK نقاط النهاية الدقيقة المتوفرة دون تعديل:
- مخطط التخويل الافتراضي إلى "ikey"
- مفتاح الأجهزة: 00000000-0000-0000-0000-000000000000
- تستند معرفات URI للخدمة الإقليمية إلى قيم التجاوز الصريحة:
- ابتلاع:
https://custom.com:111/ - القياسات المباشرة:
https://custom.com:222/ - محلل ملفات التعريف ل .NET:
https://custom.com:333/ - المصحح:
https://custom.com:444/
- ابتلاع:
سلسلة اتصال بمنطقة صريحة
InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/
في هذا المثال، تحدد سلسلة الاتصال منطقة جنوب وسط الولايات المتحدة:
- مخطط التخويل الافتراضي إلى "ikey"
- مفتاح الأجهزة: 00000000-0000-0000-0000-000000000000
- تستند معرفات URI للخدمة الإقليمية إلى قيم التجاوز الصريحة:
- ابتلاع:
https://southcentralus.in.applicationinsights.azure.com/
- ابتلاع:
لسرد المناطق المتوفرة، قم بتشغيل الأمر التالي في Azure CLI:
az account list-locations -o table
تعيين سلسلة اتصال
تدعم جميع عروض OpenTelemetry وإصدارات SDK التالية سلاسل الاتصال:
- .NET v2.12.0
- جافا سكريبت v2.3.0
- NodeJS v1.5.0
- جافا v3.1.1
يمكنك تعيين سلسلة اتصال في التعليمات البرمجية، باستخدام متغير بيئة، أو ملف تكوين.
متغير البيئة
سلسلة الاتصال: APPLICATIONINSIGHTS_CONNECTION_STRING
نماذج التعليمات البرمجية
| اللغة | واجهة برمجة التطبيقات الكلاسيكية | التتبع المفتوح |
|---|---|---|
| ASP.NET Core | Application Insights SDK | توزيع AzMon OTel |
| .NET Framework | Application Insights SDK | مصدر AzMon |
| جاوة | غير متاح | عامل Java |
| JavaScript | البرنامج النصي لمحمل SDK JavaScript (الويب) | غير متاح |
| Node.js | Application Insights SDK | توزيع AzMon OTel |
| بايثون | تم إيقاف OpenCensus Python SDK. | توزيع AzMon OTel |
الخطوات التالية
لمراجعة الأسئلة المتداولة (FAQ):
ابدأ في وقت التشغيل باستخدام:
- Azure Virtual Machine (VM) والتطبيقات المستضافة بواسطة IIS لمجموعات مقياس الجهاز الظاهري Azure
- خادم Internet Information Server (IIS)
- ميزة تطبيقات الويب في Azure App Service
ابدأ في وقت التطوير باستخدام: