الترحيل من مفاتيح تقرير عن حالة النظام Application Insights إلى سلاسل الاتصال
تتناول هذه المقالة الترحيل من مفاتيح الأجهزة إلى سلسلة الاتصال.
- إصدار SDK المدعوم
- مورد Application Insights موجود
انتقل إلى جزء Overview لمورد Application Insights.
ابحث عن سلسلة الاتصال المعروضة على اليمين.
مرر مؤشر الماوس فوق سلسلة الاتصال وحدد أيقونة نسخ إلى الحافظة.
قم بتكوين 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: تجعل سلاسل الاتصال استيعاب بيانات تتبع الاستخدام أكثر موثوقية عن طريق إزالة التبعيات على نقاط نهاية الاستيعاب العمومية.
- الأمان: تسمح سلاسل الاتصال باستيعاب بيانات تتبع الاستخدام المصادق عليه باستخدام مصادقة Microsoft Entra ل Application Insights.
- نقاط النهاية المخصصة (البيئات السحابية السيادية أو المختلطة): تسمح إعدادات نقطة النهاية بإرسال البيانات إلى منطقة Azure Government معينة. (راجع الأمثلة.)
- الخصوصية (نقاط النهاية الإقليمية): تسهل سلاسل الاتصال مخاوف الخصوصية من خلال إرسال البيانات إلى نقاط النهاية الإقليمية، مع ضمان عدم مغادرة البيانات لمنطقة جغرافية.
- 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 لسيناريوهات الإنشاء التلقائي. نملك خطط لمعالجة هذا القيد في المستقبل.
يعمل الاستيعاب العمومي على إرسال جميع بيانات تتبع الاستخدام إلى نقطة نهاية واحدة، بغض النظر عن مكان تخزين هذه البيانات. يسمح لك الاستيعاب الإقليمي بتحديد نقاط نهاية محددة لكل منطقة لاستيعاب البيانات. تضمن هذه الإمكانية بقاء البيانات داخل منطقة معينة أثناء المعالجة والتخزين.
لا تتأثر الفوترة.
انشر الأسئلة إلى answers forum.