تمكين محلل ملفات تعريف .NET لتطبيقات الويب على جهاز Azure الظاهري

مقالة
10/24/2024

إشعار

نوصي باستخدام الوحدة النمطية Azure Az PowerShell للتفاعل مع Azure. للبدء، راجع تثبيت Azure PowerShell. لمعرفة كيفية الترحيل إلى الوحدة النمطية Az PowerShell، راجع ترحيل Azure PowerShell من AzureRM إلى Az.

في هذه المقالة، ستتعلم كيفية تشغيل محلل ملفات تعريف Application Insights ل .NET على جهاز Azure الظاهري (VM) أو مجموعة مقياس الجهاز الظاهري Azure عبر ثلاث طرق مختلفة:

Visual Studio وAzure Resource Manager
PowerShell
Azure Resource Explorer

حدد علامة تبويب الأسلوب المفضلة لديك من أجل:

في هذا الدليل، ستتعرف على كيفية القيام بما يلي:

تكوين ملحق تشخيصات Azure لتشغيل محلل ملفات تعريف .NET.
تثبيت Application Insights SDK على جهاز ظاهري.
توزيع التطبيق الخاص بك
عرض تتبعات محلل ملفات التعريف عبر مثيل Application Insights في مدخل Microsoft Azure.

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

تطبيق ASP.NET Core يعمل.
مورد Application Insights.
لمراجعة قوالب Azure Resource Manager (قوالب ARM) لملحق تشخيص Azure:
- الجهاز الظاهري
- مجموعة مقياس الجهاز الظاهري

إضافة Application Insights SDK إلى التطبيق الخاص بك

افتح مشروعك الأساسي ASP.NET في Visual Studio.
حدد المشروع> Add Application Insights Telemetry.
حدد Azure Application Insights>Next.
حدد الاشتراك حيث يعيش مورد Application Insights وحدد التالي.
حدد مكان حفظ سلسلة الاتصال وحدد التالي.
حدد إنهاء.

إشعار

للحصول على إرشادات كاملة، بما في ذلك كيفية تمكين Application Insights على تطبيق ASP.NET Core بدون Visual Studio، راجع Application Insights لتطبيقات ASP.NET Core.

تأكيد أحدث إصدار مستقر من Application Insights SDK

حدد Project>Manage NuGet Packages.
انقر فوق Microsoft.ApplicationInsights.AspNetCore.
في الجزء الجانبي، حدد أحدث إصدار من SDK من القائمة المنسدلة.
حدد تحديث.

تمكين محلل ملفات تعريف .NET

يمكنك تمكين محلل ملفات التعريف بأي من الطرق الثلاث:

ضمن تطبيق ASP.NET Core باستخدام قالب Azure Resource Manager وVisual Studio. اوصت.
باستخدام أمر PowerShell عبر Azure CLI.
باستخدام Azure Resource Explorer.

تثبيت ملحق Azure Diagnostics

اختر قالب ARM الذي تريد استخدامه:
- الجهاز الظاهري
- مجموعة مقياس الجهاز الظاهري
في القالب، حدد موقع المورد من النوع extension.
في Visual Studio، انتقل إلى arm.json الملف في تطبيق ASP.NET Core الذي تمت إضافته عند تثبيت Application Insights SDK.
أضف نوع extension المورد من القالب إلى arm.json الملف لإعداد جهاز ظاهري أو مقياس جهاز ظاهري تم تعيينه باستخدام تشخيصات Azure.

ضمن العلامة WadCfg ، أضف مفتاح تقرير عن حالة النظام Application Insights إلى MyApplicationInsightsProfilerSink.

"WadCfg": {
  "SinksConfig": {
    "Sink": [
      {
        "name": "MyApplicationInsightsProfilerSink",
        "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
      }
    ]
  }
}

توزيع التطبيق الخاص بك

أوامر PowerShell التالية هي نهج بديل للأجهزة الظاهرية الموجودة التي تلمس ملحق Azure Diagnostics فقط.

إشعار

إذا قمت بتوزيع VM مرة أخرى، سيتم فقدان المتلقي. تحتاج إلى تحديث التكوين الذي تستخدمه عند نشر الجهاز الظاهري للحفاظ على هذا الإعداد.

تثبيت Application Insights عبر تكوين تشخيص Azure

تصدير تكوين تشخيص Azure المنشور حاليا إلى ملف:
```
$ConfigFilePath = [IO.Path]::GetTempFileName()
```

أضف مصدر محلل ملفات تعريف Application Insights إلى التكوين الذي تم إرجاعه بواسطة الأمر التالي:

(Get-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM").PublicSettings | Out-File -Verbose $ConfigFilePath

محلل ملفات التعريف Application Insights WadCfg:

"WadCfg": {
  "SinksConfig": {
    "Sink": [
      {
        "name": "MyApplicationInsightsProfilerSink",
        "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
      }
    ]
  }
}

قم بتشغيل الأمر التالي لتمرير التكوين المحدث إلى الأمر Set-AzVMDiagnosticsExtension.
```
Set-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM" -DiagnosticsConfigurationPath $ConfigFilePath
```
إشعار

قد يتطلب Set-AzVMDiagnosticsExtension الوسيطة -StorageAccountName. إذا كان تكوين التشخيص الأصلي الخاص بك يحتوي على storageAccountName الخاصية في protectedSettings القسم (وهو غير قابل للتنزيل)، فتأكد من تمرير نفس القيمة الأصلية التي كانت لديك في استدعاء cmdlet هذا.

ميزة تتبع IIS Http

في حال كان التطبيق المقصود قيد التشغيل من خلالIIS، تمكينIIS Http Tracingميزة Windows.

إنشاء الوصول عن بعد إلى البيئة.
استخدم نافذة إضافة ميزات Windows ، أو قم بتشغيل الأمر التالي في PowerShell (كمسؤول):
```
Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All
```
إذا كان تأسيس الوصول عن بُعد مشكلة، يمكنك استخدامCLI Azureلتشغيل الأمر الآتي:
```
az vm run-command invoke -g MyResourceGroupName -n MyVirtualMachineName --command-id RunPowerShellScript --scripts "Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All"
```
توزيع التطبيق الخاص بك

تعيين متلقي محلل ملفات التعريف باستخدام Azure Resource Explorer

نظرا لأن مدخل Azure لا يوفر طريقة لتعيين محلل ملفات تعريف Application Insights لمتلقي .NET، يمكنك استخدام Azure Resource Explorer لتعيين المتلقي.

إشعار

تحقق من تثبيت ملحق Microsoft Azure Diagnostics عن طريق عرض الملحقات المثبتة لجهازك الظاهري.
قم بإيجاد ملحق تشخيص الجهاز الظاهري الخاص بالجهاز الظاهري الخاص بك.
1. انتقل إلى Azure Resource Explorer.
2. قم بتوسيع الاشتراكات وابحث عن الاشتراك الذي يحتوي على مجموعة الموارد مع الجهاز الظاهري الخاص بك.
3. انتقل لأسفل إلى ملحقات الجهاز الظاهري عن طريق تحديد مجموعة الموارد الخاصة بك. ثم حدد Microsoft.Compute>virtualMachines>[your virtual machine]>extensions.
أضف محلل ملفات تعريف Application Insights لمتلقي .NET إلى العقدة SinksConfig ضمن WadCfg. إذا لم يكن لديك SinksConfig مقطع بالفعل، فقد تحتاج إلى إضافة مقطع. لإضافة المتلقي:
- حدد Application Insights iKey المناسب في الإعدادات الخاصة بك.
- قم بتبديل وضع المستكشف إلى قراءة/كتابة في الزاوية العلوية اليسرى.
- حدد تحرير.
```
"WadCfg": {
  "SinksConfig": {
    "Sink": [
      {
        "name": "MyApplicationInsightsProfilerSink",
        "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
      }
    ]
  }
}        
```
بعد الانتهاء من تحرير التكوين، حدد PUT.
put إذا نجحت، فستظهر علامة اختيار خضراء في منتصف الشاشة.