الترحيل من مفاتيح تقرير عن حالة النظام Application Insights إلى سلاسل الاتصال
تتناول هذه المقالة الترحيل من مفاتيح الأجهزة إلى سلسلة الاتصال.
المتطلبات الأساسية
- إصدار SDK المدعوم
- مورد Application Insights موجود
الترحيل
انتقل إلى جزء Overview لمورد Application Insights.
ابحث عن سلسلة الاتصال ion المعروضة على اليمين.
مرر مؤشر الماوس فوق سلسلة الاتصال وحدد أيقونة نسخ إلى الحافظة.
قم بتكوين Application Insights SDK عن طريق اتباع كيفية تعيين سلاسل الاتصال.
هام
لا تستخدم كلا من سلسلة الاتصال ومفتاح تقرير عن حالة النظام. تحل المجموعة الأخيرة محل الأخرى، ويمكن أن تؤدي إلى عدم ظهور بيانات تتبع الاستخدام على المدخل. راجع البيانات المفقودة.
عملية الترحيل على نطاق واسع
استخدم متغيرات البيئة من أجل تمرير سلسلة اتصال إلى Application Insights SDK أو العامل.
لتعيين سلسلة الاتصال عبر متغير بيئة، ضع قيمة سلسلة الاتصال في متغير بيئة يسمى APPLICATIONINSIGHTS_CONNECTION_STRING.
يمكن أتمتة هذه العملية في عمليات توزيع Azure. الخاص بك. على سبيل المثال، يوضح قالب Azure Resource Manager التالي كيف يمكنك تضمين سلسلة الاتصال الصحيح تلقائيا مع توزيع Azure App Service. تأكد من تضمين أي إعدادات تطبيق أخرى يتطلبها تطبيقك:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"appServiceName": {
"type": "string",
"metadata": {
"description": "Name of the App Services resource"
}
},
"appServiceLocation": {
"type": "string",
"metadata": {
"description": "Location to deploy the App Services resource"
}
},
"appInsightsName": {
"type": "string",
"metadata": {
"description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
}
}
},
"resources": [
{
"apiVersion": "2016-03-01",
"name": "[parameters('appServiceName')]",
"type": "microsoft.web/sites",
"location": "[parameters('appServiceLocation')]",
"properties": {
"siteConfig": {
"appSettings": [
{
"name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
"value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
}
]
},
"name": "[parameters('appServiceName')]"
}
}
]
}
إمكانات جديدة
توفر سلاسل الاتصال إعداد تكوين واحد وتلغي الحاجة إلى إعدادات وكيل متعددة.
- Reliability: تجعل سلاسل الاتصال استيعاب بيانات تتبع الاستخدام أكثر موثوقية عن طريق إزالة التبعيات على نقاط نهاية الاستيعاب العمومية.
- الأمان: تسمح سلاسل الاتصال ion باستيعاب بيانات تتبع الاستخدام المصادق عليها باستخدام مصادقة Microsoft Entra ل Application Insights.
- نقاط النهاية المخصصة (البيئات السحابية السيادية أو المختلطة): تسمح إعدادات نقطة النهاية بإرسال البيانات إلى منطقة Azure Government معينة. (راجع الأمثلة.)
- الخصوصية (نقاط النهاية الإقليمية): تخفف سلاسل الاتصال من مخاوف الخصوصية عن طريق إرسال البيانات إلى نقاط النهاية الإقليمية، ما يضمن عدم مغادرة البيانات لمنطقة جغرافية.
إصدارات SDK المعتمدة
- NET و .NET Core v2.12.0+
- Java v2.5.1 و Java 3.0+
- JavaScript v2.3.0+
- NodeJS v1.5.0+
- Python v1.0.0+
استكشاف الأخطاء وإصلاحها
يوفر هذا القسم حلول استكشاف الأخطاء وإصلاحها.
تنبيه: "الانتقال إلى استخدام سلاسل الاتصال من أجل استيعاب البيانات"
اتبع خطوات الترحيل في هذه المقالة من أجل حل هذا التنبيه.
البيانات المفقودة
- تأكد من أنك تستخدم إصدار SDK المدعوم. إذا كنت تستخدم تكامل Application Insights في عرض آخر لمنتج Azure، تحقق من الوثائق الخاصة به حول كيفية تكوين سلسلة اتصال بشكل صحيح.
- تأكد من عدم قيامك بتعيين كل من مفتاح الجهاز وسلسلة الاتصال في نفس الوقت. يتعين إزالة إعدادات مفتاح تقرير عن حالة النظام من التكوين الخاص بك.
- تأكد من أن سلسلة الاتصال الخاصة بك مطابقة تمامًا لما تم توفيره في مدخل Microsoft Azure.
المتغيرات الخاصة بالبيئة لا تعمل
إذا قمت بترميز مفتاح تقرير عن حالة النظام في التعليمات البرمجية للتطبيق الخاص بك، فقد يكون لتلك البرمجة الأسبقية قبل متغيرات البيئة.
الأسئلة الشائعة
يقدم هذا القسم إجابات للأسئلة الشائعة.
في أي مكان آخر يمكنني العثور على سلسلة الاتصال الخاصة بي؟
يتم أيضا تضمين سلسلة الاتصال في خصائص مورد Resource Manager لمورد Application Insights الخاص بك، تحت اسم ConnectionStringالحقل .
كيف يؤثر هذا على البنى التلقائية؟
لا تتأثر سيناريوهات البنى التلقائية.
هل يمكنني استخدام مصادقة Microsoft Entra مع البنية التلقائية؟
لا يمكنك تمكين مصادقة Microsoft Entra لسيناريوهات الإنشاء التلقائي. نملك خطط لمعالجة هذا القيد في المستقبل.
ما الفرق بين الاستيعاب العالمي والإقليمي؟
يعمل الاستيعاب العمومي على إرسال جميع بيانات تتبع الاستخدام إلى نقطة نهاية واحدة، بغض النظر عن مكان تخزين هذه البيانات. يسمح لك الاستيعاب الإقليمي بتحديد نقاط نهاية محددة لكل منطقة لاستيعاب البيانات. تضمن هذه الإمكانية بقاء البيانات داخل منطقة معينة أثناء المعالجة والتخزين.
كيف تؤثر سلسلة الاتصال على الفوترة؟
لا تتأثر الفوترة.
أسئلة وأجوبة Microsoft
انشر الأسئلة إلى answers forum.