Application Insights لأجهزة Azure الظاهرية ومجموعات مقياس الجهاز الظاهري

مقالة
09/13/2024

أصبح الآن تمكين المراقبة للتطبيقات ASP.NET والتطبيقات التي تستضيفها ASP.NET Core IIS التي تعمل على أجهزة Azure الظاهرية أو مجموعات مقياس الجهاز الظاهري Azure أسهل من أي وقت مضى. احصل على جميع مزايا استخدام Application Insights دون تعديل التعليمات البرمجية الخاصة بك.

ترشدك هذه المقالة من خلال تمكين مراقبة Application Insights باستخدام Application Insights Agent. كما يوفر إرشادات أولية لأتمتة عملية عمليات النشر واسعة النطاق.

تمكين "Application Insights"

من السهل تمكين الإتلاف التلقائي. التكوين المتقدم غير مطلوب.

للحصول على قائمة كاملة بسيناريوهات البنية التلقائية المدعومة، راجع البيئات واللغات وموفري الموارد المعتمدين.

إشعار

تتوفر البنية التلقائية للتطبيقات المستضافة ASP.NET ASP.NET الأساسية IIS وJava. استخدم SDK لأداة Node.js وتطبيقات Python المستضافة على أجهزة Azure الظاهرية ومجموعات مقياس الجهاز الظاهري.

يقوم Application Insights Agent تلقائيا بإلغاء تحديد نفس إشارات التبعية خارج الصندوق مثل SDK. لمعرفة المزيد، راجع التبعية التلقائية.

قبل تثبيت ملحق Application Insights Agent، ستحتاج إلى سلسلة الاتصال. إنشاء مورد Application Insights جديد أو نسخ سلسلة الاتصال من مورد Application Insights موجود.

تمكين المراقبة للأجهزة الظاهرية

يمكنك استخدام مدخل Microsoft Azure أو PowerShell لتمكين المراقبة للأجهزة الظاهرية.

مدخل Azure

في مدخل Microsoft Azure، انتقل إلى مورد Application Insights. انسخ سلسلة الاتصال إلى الحافظة.
انتقل إلى جهازك الظاهري. ضمن قسم Settings في القائمة على الجانب الأيسر، حدد Extensions + applications>Add.
حدد Application Insights Agent>Next.
الصق سلسلة الاتصال التي نسختها في الخطوة 1 وحدد مراجعة + إنشاء.

PowerShell

إشعار

هل أنت جديد في PowerShell؟ اطلع على دليل بدء الاستخدام.

تثبيت أو تحديث Application Insights Agent كملحق لأجهزة Azure الظاهرية:

# define variables to match your environment before running
$ResourceGroup = "<myVmResourceGroup>"
$VMName = "<myVmName>"
$Location = "<myVmLocation>"
$ConnectionString = "<myAppInsightsResourceConnectionString>"

$publicCfgJsonString = @"
{
    "redfieldConfiguration": {
        "instrumentationKeyMap": {
        "filters": [
            {
            "appFilter": ".*",
            "machineFilter": ".*",
            "virtualPathFilter": ".*",
            "instrumentationSettings" : {
                "connectionString": "$ConnectionString"
            }
            }
        ]
        }
    }
    }
"@

$privateCfgJsonString = '{}'
	
Set-AzVMExtension -ResourceGroupName $ResourceGroup -VMName $VMName -Location $Location -Name "ApplicationMonitoringWindows" -Publisher "Microsoft.Azure.Diagnostics" -Type "ApplicationMonitoringWindows" -Version "2.8" -SettingString $publicCfgJsonString -ProtectedSettingString $privateCfgJsonString

إشعار

بالنسبة إلى عمليات النشر الأكثر تعقيدا على نطاق واسع، يمكنك استخدام حلقة PowerShell لتثبيت أو تحديث ملحق Application Insights Agent عبر أجهزة ظاهرية متعددة.

الاستعلام عن حالة ملحق Application Insights Agent لأجهزة Azure الظاهرية:

Get-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name ApplicationMonitoringWindows -Status

احصل على قائمة بالملحقات المثبتة لأجهزة Azure الظاهرية:

Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myVmResourceGroup>/providers/Microsoft.Compute/virtualMachines/<myVmName>/extensions"

إلغاء تثبيت ملحق Application Insights Agent من أجهزة Azure الظاهرية:

Remove-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name "ApplicationMonitoring"

إشعار

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

تمكين المراقبة لمجموعات مقياس الجهاز الظاهري

يمكنك استخدام مدخل Microsoft Azure أو PowerShell لتمكين المراقبة لمجموعات مقياس الجهاز الظاهري.

مدخل Azure

اتبع الخطوات السابقة للأجهزة الظاهرية، ولكن انتقل إلى مجموعات مقياس الجهاز الظاهري بدلا من الجهاز الظاهري الخاص بك.

PowerShell

تثبيت أو تحديث Application Insights Agent كملحق لمجموعات مقياس الجهاز الظاهري:

# Set resource group, vmss name, and connection string to reflect your environment
$ResourceGroup = "<myVmResourceGroup>"
$VMSSName = "<myVmName>"
$ConnectionString = "<myAppInsightsResourceConnectionString>"
$publicCfgHashtable =
@{
  "redfieldConfiguration"= @{
    "instrumentationKeyMap"= @{
      "filters"= @(
        @{
          "appFilter"= ".*";
          "machineFilter"= ".*";
          "virtualPathFilter"= ".*";
          "instrumentationSettings" = @{
            "connectionString"= "$ConnectionString"
          }
        }
      )
    }
  }
};
$privateCfgHashtable = @{};
$vmss = Get-AzVmss -ResourceGroupName $ResourceGroup -VMScaleSetName $VMSSName
Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name "ApplicationMonitoringWindows" -Publisher "Microsoft.Azure.Diagnostics" -Type "ApplicationMonitoringWindows" -TypeHandlerVersion "2.8" -Setting $publicCfgHashtable -ProtectedSetting $privateCfgHashtable
Update-AzVmss -ResourceGroupName $vmss.ResourceGroupName -Name $vmss
# Note: Depending on your update policy, you might need to run Update-AzVmssInstance for each instance

احصل على قائمة بالملحقات المثبتة لمجموعات مقياس الجهاز الظاهري:

Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/<myVmssName>/extensions"

إلغاء تثبيت ملحق مراقبة التطبيق من مجموعات مقياس الجهاز الظاهري:

# set resource group and vmss name to reflect your environment
$vmss = Get-AzVmss -ResourceGroupName "<myResourceGroup>" -VMScaleSetName "<myVmssName>"
Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name "ApplicationMonitoringWindows"
Update-AzVmss -ResourceGroupName $vmss.ResourceGroupName -Name $vmss.Name -VirtualMachineScaleSet $vmss
# Note: Depending on your update policy, you might need to run Update-AzVmssInstance for each instance

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

ابحث عن تلميحات استكشاف الأخطاء وإصلاحها لملحق Application Insights Monitoring Agent لتطبيقات .NET التي تعمل على أجهزة Azure الظاهرية ومجموعات مقياس الجهاز الظاهري.

إذا كنت تواجه مشكلة في نشر الملحق، فراجع إخراج التنفيذ الذي تم تسجيله إلى الملفات الموجودة في الدلائل التالية:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.ApplicationMonitoringWindows\<version>\

إذا تم نشر الملحق بنجاح ولكنك غير قادر على رؤية بيانات تتبع الاستخدام، فقد يكون أحد المشكلات التالية التي تمت تغطيتها في استكشاف أخطاء العامل وإصلاحها:

مكتبات DLL المتعارضة في دليل حاوية التطبيق
تعارض مع تكوين IIS المشترك

اختبار الاتصال بين مضيف التطبيق وخدمة الاستيعاب

ترسل Application Insights SDKs والوكلاء بيانات تتبع الاستخدام للحصول على استيعابها كمكالمات REST إلى نقاط نهاية الاستيعاب الخاصة بنا. يمكنك اختبار الاتصال من خادم الويب أو الجهاز المضيف للتطبيق إلى نقاط نهاية خدمة الاستيعاب باستخدام عملاء REST الخام من أوامر PowerShell أو curl. راجع استكشاف أخطاء بيانات تتبع استخدام التطبيق المفقودة وإصلاحها في Azure Monitor Application Insights.

ملاحظات الإصدار

2.8.44

تم تحديث Application Insights .NET/.NET Core SDK إلى 2.20.1 - حقل أحمر.
مجموعة استعلام SQL ممكنة.
دعم ممكن لمصادقة Microsoft Entra.

2.8.42

تحديث Application Insights .NET/.NET Core SDK إلى 2.18.1 - حقل أحمر.

2.8.41

تمت إضافة ميزة ASP.NET Core autoinstrumentation.

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

تعرف على كيفية نشر تطبيق إلى مجموعة مقياس جهاز Azure الظاهري.
نظرة عامة على التوفر

مشاركة عبر

Application Insights لأجهزة Azure الظاهرية ومجموعات مقياس الجهاز الظاهري

تمكين "Application Insights"

تمكين المراقبة للأجهزة الظاهرية

مدخل Azure

PowerShell

تمكين المراقبة لمجموعات مقياس الجهاز الظاهري

مدخل Azure

PowerShell

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

اختبار الاتصال بين مضيف التطبيق وخدمة الاستيعاب

ملاحظات الإصدار

2.8.44

2.8.42

2.8.41

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

الملاحظات

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