انشر Azure Monitor Application Insights Agent للخوادم المحلية

مقالة
11/05/2024

عامل Application Insights (الذي كان يسمى سابقًا Status Monitor V2) هو وحدة نمطية PowerShell نشرت إلى معرض PowerShell. فهو يحل محل Status Monitor. يتم إرسال القياس عن بُعد إلى مدخل Microsoft Azure، حيث يمكنك مراقبة تطبيقك.

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

إشعار

تدعم الوحدة النمطية حاليًا التقرير عن حالة النظام الذي لا يحتوي على تعليمات برمجية لتطبيقات الويب ASP.NET و ASP.NET Core المستضافة مع IIS. استخدم SDK لأداة تطبيقات Java وNode.js.

معرض PowerShell

يوجد Application Insights Agent في معرض PowerShell.

الإرشادات

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

تحتوي علامة التبويب هذه على أوامر التشغيل السريع التي من المتوقع أن تعمل لمعظم البيئات. تعتمد الإرشادات على معرض PowerShell لتوزيع التحديثات. تدعم هذه الأوامر-Proxy معلمة PowerShell.

للحصول على شرح لهذه الأوامر وإرشادات التخصيص ومعلومات حول استكشاف الأخطاء وإصلاحها، راجع الإرشادات التفصيلية.

في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.

قم بالتنزيل والتثبيت عبر معرض PowerShell

استخدم معرض PowerShell للتنزيل والتثبيت.

متطلبات التثبيت

لتمكين المراقبة، يجب أن يكون لديك سلسلة الاتصال. يتم عرض سلسلة الاتصال في جزء Overview لمورد Application Insights. لمزيد من المعلومات، راجع سلاسل الاتصال.

إشعار

اعتبارًا من أبريل 2020، سيتوقف معرض PowerShell Gallery عن TLS 1.1 و 1.0.

لمزيد من المتطلبات الأساسية التي قد تحتاجها، راجع دعم TLS لمعرض PowerShell.

تشغيل PowerShell كمسؤول.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Install-Module -Name PowerShellGet -Force

إغلاق PowerShell.

قم بتثبيت Application Insights Agent

تشغيل PowerShell كمسؤول.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense

إشعار

AllowPrerelease يسمح التبديل في Install-Module cmdlet بتثبيت إصدار بيتا.

لمزيد من المعلومات، راجع Install-Module.

تمكين المراقبة

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

تنزيل وتثبيت يدويًا (خيار غير متصل بالشبكة)

يمكنك أيضا تنزيله وتثبيته يدويا.

قم بتنزيل الوحدة

قم بتنزيل أحدث إصدار من الوحدة يدويًا من PowerShell Gallery.

قم بفك ضغط وكيل Application Insights وتثبيته

$pathToNupkg = "C:\Users\t\Desktop\Az.ApplicationMonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\Az.ApplicationMonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule

تمكين المراقبة

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

توضح علامة التبويب هذه كيفية إلحاق معرض PowerShell وتنزيل الوحدة النمطية ApplicationMonitor. المضمنة هي المعلمات الأكثر شيوعا التي تحتاجها للبدء. لقد قدمنا أيضًا إرشادات التنزيل اليدوي في حالة عدم توفر اتصال بالإنترنت.

الحصول على سلسلة الاتصال

للبدء، تحتاج إلى سلسلة الاتصال. لمزيد من المعلومات، راجع سلاسل الاتصال.

إشعار

في 31 مارس 2025، سينتهي دعم إدخال مفاتيح الأجهزة. سيستمر استيعاب مفتاح الأجهزة في العمل ولكننا لن نقوم بتوفير تحديثات أو أي دعم للميزة. الانتقال إلى سلاسل الاتصال للاستفادة من الإمكانات الجديدة.

تشغيل PowerShell كمسؤول مع نهج تنفيذ مرتفع

تشغيل كمسؤول

يحتاج PowerShell أذونات على مستوى المسؤول لإجراء تغييرات على الكمبيوتر.

سياسة التنفيذ

الوصف: افتراضيًا، يتم تعطيل تشغيل البرامج النصية PowerShell. نوصي بالسماح بالبرامج النصية RemoteSigned للنطاق الحالي فقط.
مرجع: حول نهج التنفيذ و Set-ExecutionPolicy.
الأمر: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process.
المعلمة الاختيارية:
- -Force. تجاوز مطالبة التأكيد.

أخطاء المثال

Install-Module : The 'Install-Module' command was found in the module 'PowerShellGet', but the module could not be
loaded. For more information, run 'Import-Module PowerShellGet'.

Import-Module : File C:\Program Files\WindowsPowerShell\Modules\PackageManagement\1.3.1\PackageManagement.psm1 cannot
be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https://go.microsoft.com/fwlink/?LinkID=135170.

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

تدقيق مثيل PowerShell الخاص بك عن طريق تشغيل الأمر $PSVersionTable. ينتج عن هذا الأمر الإخراج التالي:

Name                           Value
----                           -----
PSVersion                      5.1.17763.316
PSEdition                      Desktop
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.17763.316
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

تمت كتابة هذه الإرشادات واختبارها على كمبيوتر يعمل بنظام التشغيل Windows 10 والإصدارات التالية.

المتطلبات الأساسية لمعرض PowerShell

تعد هذه الخطوات الخادم لتنزيل الوحدات النمطية من معرض PowerShell.

إشعار

يتم اعتماد معرض PowerShell على Windows 10 وWindows Server 2016 وPowerShell 6+. للحصول على معلومات حول الإصدارات السابقة، راجع تثبيت PowerShellGet.

تشغيل PowerShell كمسؤول مع نهج تنفيذ مرتفع.

تثبيت موفر حزمة NuGet.

الوصف: تحتاج هذا الموفر للتفاعل مع المستودعات المستندة إلى NuGet مثل معرض PowerShell.
المرجع: Install-PackageProvider.
الأمر: Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201.
المعلمات الاختيارية:
- -Proxy. تعين خادم وكيل للطلب.
- -Force. تجاوز مطالبة التأكيد.

تتلقى هذه المطالبة إذا لم يتم إعداد NuGet:

NuGet provider is required to continue
PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based repositories.
The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies' or
'C:\Users\t\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the NuGet provider by running
'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force'. Do you want PowerShellGet to install and import
the NuGet provider now?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"):

تكوين معرض PowerShell كمستودع موثوق به.
- الوصف: بشكل افتراضي، معرض PowerShell هو مستودع غير موثوق به.
- المرجع: Set-PSRepository.
- الأمر: Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted.
- المعلمة الاختيارية:
  - -Proxy. تعين خادم وكيل للطلب.
تتلقى هذه المطالبة إذا لم يكن معرض PowerShell موثوقا به:
```
Untrusted repository
You are installing the modules from an untrusted repository.
If you trust this repository, change its InstallationPolicy value
by running the Set-PSRepository cmdlet. Are you sure you want to
install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):
```
يمكنك تأكيد هذا التغيير وتدقيع الكل PSRepositories عن طريق تشغيل Get-PSRepository الأمر .
قم بتثبيت أحدث إصدار من PowerShellGet.
- الوصف: تحتوي هذه الوحدة النمطية على الأدوات المستخدمة للحصول على وحدات أخرى من معرض PowerShell. الإصدار 1.0.0.1 يأتي مع Windows 10 وخادم Windows. مطلوب إصدار 1.6.0 أو أعلى. لتحديد الإصدار المثبت، قم بتشغيل الأمر Get-Command -Module PowerShellGet.
- المرجع: Installing PowerShellGet.
- الأمر: Install-Module -Name PowerShellGet.
- المعلمات الاختيارية:
  - -Proxy. تعين خادم وكيل للطلب.
  - -Force. يتجاوز التحذير "المثبت مسبقًا" ويثبت أحدث إصدار.
تتلقى هذا الخطأ إذا كنت لا تستخدم أحدث إصدار من PowerShellGet:
```
Install-Module : A parameter cannot be found that matches parameter name 'AllowPrerelease'.
At line:1 char:20
Install-Module abc -AllowPrerelease
               ~~~~~~~~~~~~~~~~
CategoryInfo          : InvalidArgument: (:) [Install-Module], ParameterBindingException
FullyQualifiedErrorId : NamedParameterNotFound,Install-Module
```
إعادة تشغيل PowerShell. لا يمكنك تحميل الإصدار الجديد في جلسة العمل الحالية. تعمل جلسات PowerShell الجديدة على تحميل أحدث إصدار من PowerShellGet.

قم بالتنزيل والتثبيت عبر معرض PowerShell

تقوم هذه الخطوات بتنزيل الوحدة النمطية Az.ApplicationMonitor من معرض PowerShell.

تأكد من استيفاء كافة المتطلبات الأساسية لمعرض PowerShell.
تشغيل PowerShell كمسؤول مع نهج تنفيذ مرتفع.
تثبيت الوحدة النمطية Az.ApplicationMonitor.
- المرجع: Install-Module.
- الأمر: Install-Module -Name Az.ApplicationMonitor.
- المعلمات الاختيارية:
  - -Proxy. تعين خادم وكيل للطلب.
  - -AllowPrerelease. يسمح بتثبيت إصدارات أولية وبيتا.
  - -AcceptLicense. يجاوز المطالبة "قبول الترخيص"
  - -Force. تجاوز تحذير "مستودع غير موثوق به".

يُنزل ويُثبت الوحدة يدويًا (خيار غير متصل بالشبكة)

إذا كان لأي سبب من الأسباب لا يمكنك الاتصال بالوحدة النمطية PowerShell، يمكنك تحميل وتثبيت الوحدة Az.ApplicationMonitor يدويًا.

حمّل أحدث ملف nupkg يدويًا

انتقل إلى https://www.powershellgallery.com/packages/Az.ApplicationMonitor.
حدد أحدث إصدار من الملف في جدول محفوظات الإصدار.
ضمن خيارات التثبيت، حدد التحميل اليدوي.

الخيار 1: تثبيت في دليل وحدات PowerShell

قم بتثبيت وحدة PowerShell النمطية التي تم تنزيلها يدويا في دليل PowerShell بحيث يمكن اكتشافها بواسطة جلسات PowerShell. للحصول على مزيدٍ من المعلومات، راجع Installing a PowerShell Module.

فك ضغط nupkg كملف مضغوط باستخدام Expand-Archive (v1.0.1.0)

الوصف: الإصدار الأساسي من Microsoft.PowerShell.Archive (v1.0.1.0) لا يمكن فك ضغط ملفات nupkg. إعادة تسمية ملف بملحق .zip.
المرجع: Expand-Archive.

الأمر: .

$pathToNupkg = "C:\az.applicationmonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\az.applicationmonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule

فك ضغط nupkg باستخدام Expand-Archive (v1.1.0.0)

الوصف: استخدام إصدار حالي من Expand-Archive لفك ضغط ملفات nupkg دون تغيير ملحق اسم الملف.
المرجع: Expand-Archive وMicrosoft.PowerShell.Archive.

الأمر: .

$pathToNupkg = "C:\az.applicationmonitor.0.2.1-alpha.nupkg"
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\az.applicationmonitor"
Expand-Archive -LiteralPath $pathToNupkg -DestinationPath $pathInstalledModule

الخيار 2: فك ضغط ملف nupkg واستيراده يدويًا

إذا كنت تقوم بتثبيت الوحدة النمطية في أي دليل آخر، قم باستيراد الوحدة النمطية يدويا باستخدام Import-Module.

هام

سيتم تثبيت DLLs عبر المسارات النسبية. تخزين محتويات الحزمة في الدليل وقت التشغيل المقصود وتأكيد أن أذونات الوصول تسمح للقراءة ولكن ليس الكتابة.

تغيير الملحق إلى ".zip" واستخراج محتويات الحزمة في دليل التثبيت المقصود.
ابحث عن مسار الملف Az.ApplicationMonitor.psd1.
تشغيل PowerShell كمسؤول مع نهج تنفيذ مرتفع.
تحميل الوحدة النمطية باستخدام الأمر Import-Module Az.ApplicationMonitor.psd1.

توجيه نسبة استخدام الشبكة عن طريق وكيل

عند مراقبة جهاز كمبيوتر على الإنترانت الخاصة بك، تحتاج إلى توجيه حركة مرور HTTP من خلال وكيل.

أوامر PowerShell المراد تحميل وتثبيت Az.ApplicationMonitor من معرض دعم PowerShell من معلمة -Proxy. راجع الإرشادات السابقة عند كتابة البرامج النصية للتثبيت.

يحتاج Application Insights SDK إلى إرسال بيانات تتبع الاستخدام لتطبيقك إلى Microsoft. نوصي بتكوين إعدادات الوكيل لتطبيقك في ملف web.config. لمزيد من المعلومات، راجع كيف أعمل تحقيق تمرير الوكيل؟.

تمكين المراقبة

استخدم الأمر Enable-ApplicationInsightsMonitoring لتمكين المراقبة.

راجع مرجع API للحصول على وصف مفصل لكيفية استخدام أمر cmdlet هذا.

تصف علامة التبويب هذه أوامر cmdlets التالية، وهي أعضاء في الوحدة النمطية Az.ApplicationMonitor PowerShell:

إشعار

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

إشعار

هام

يتطلب cmdlet جلسة PowerShell مع أذونات المسؤول ونُهج تنفيذ مرتفعة. لمزيد من المعلومات، انظرتشغيل PowerShell كمسؤول مع نهج تنفيذ مرتفعة.

يتطلب cmdlet أن تقوم بمراجعة وقبول التراخيص وبيان الخصوصية.
يضيف محرك التقرير عن حالة النظام حملًا إضافيًا ويتم إيقاف تشغيله بشكل افتراضي.

تمكين-InstrumentationEngine

تمكين محرك التقرير عن حالة النظام عن طريق إعداد بعض مفاتيح التسجيل. إعادة تشغل IIS لتصبح التغييرات سارية المفعول.

يمكن لمحرك التقرير عن حالة النظام تكملة البيانات التي تم جمعها من قِبل .NET SDKs. ويجمع الأحداث والرسائل التي تصف تنفيذ إدارة المعالجة. تشمل هذه الأحداث والرسائل التعليمة البرمجية لنتائج التبعية وأفعال HTTPونص الأمر SQL.

تمكين محرك التقرير عن حالة النظام في حالة:

لقد قمت بتمكين المراقبة باستخدام تمكين cmdlet ولكنك لم تمكن محرك تقرير عن حالة النظام.
لقد قمت يدويا باستخدام تطبيقك باستخدام .NET SDKs وتريد جمع بيانات تتبع الاستخدام الإضافية.

الأمثلة

Enable-InstrumentationEngine

المعلمات

-الموافقة على الترخيص

اختياري. استخدم رمز التبديل هذا لقبول الترخيص وبيان الخصوصية في عمليات التثبيت بدون أجهزة ملحقة.

رسالة مطولة

المعلمة العامة. استخدم رمز التبديل هذا لإخراج السجلات المفصلة.

المخرجات

إخراج المثال من تمكين محرك تقرير عن حالة النظام بنجاح

Configuring IIS Environment for instrumentation engine...
Configuring registry for instrumentation engine...

تمكين-ApplicationInsightsMonitoring

تمكين مراقبة إرفاق بدون تعليمة برمجية لتطبيقات IIS على الكمبيوتر المستهدف.

يعدل cmdlet هذا تطبيق IISHost.config ويعين بعض مفاتيح التسجيل. يقوم بإنشاء ملف applicationinsights.ikey.config، والذي يحدد مفتاح الأجهزة المستخدم من قبل كل تطبيق. يقوم IIS بتحميل RedfieldModule عند بدء التشغيل، والذي يقوم بإدخال Application Insights SDK في التطبيقات عند بدء تشغيل التطبيقات. إعادة تشغيل IIS للتغييرات الخاصة بك لتصبح نافذة المفعول.

بعد تمكين المراقبة، نوصي باستخدامLive Metricsللفحص بسرعة مما إذا كان تطبيقك يرسل لنا بيانات تتبع الاستخدام.

الأمثلة

مثال مع سلسلة الاتصال واحد

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

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

مثال باستخدام مفتاح تقرير عن حالة النظام المفرد

في هذا المثال، يتم تعيين مفتاح تقرير عن حالة النظام مفرد لكافة التطبيقات على الكمبيوتر الحالي.

Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

مثال مع خريطة مفتاح تقرير عن حالة النظام

في هذا المثال:

MachineFilterيُطابق الكمبيوتر الحالي باستخدام'.*' حرف البدل.
AppFilter='WebAppExclude'احصل علىnullمفتاح تقرير عن حالة النظام. التطبيق المحدد غير مجهز.
AppFilter='WebAppOne' يعين التطبيق المحدد لمفتاح تقرير عن حالة النظام فريد من نوعها.
AppFilter='WebAppTwo' يعين التطبيق المحدد لمفتاح تقرير عن حالة النظام فريد من نوعها.
AppFilter'.*' يستخدم حرف البدل لمطابقة أي تطبيقات ويب لا يتطابق معها بالفعل ويعين مفتاح تقرير عن حالة النظام افتراضيا.
أُضيفت المسافات لتسهيل القراءة.

Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap `
    ` @(@{MachineFilter='.*';AppFilter='WebAppExclude'},
      ` @{MachineFilter='.*';AppFilter='WebAppOne';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx1'}},
      ` @{MachineFilter='.*';AppFilter='WebAppTwo';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2'}},
      ` @{MachineFilter='.*';AppFilter='.*';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault'}})

إشعار

يمكن أن تكون تسمية AppFilter في هذا السياق مربكة، AppFilter تعيين عامل تصفية regex لاسم التطبيق (HostingEnvironment.SiteName في حالة .NET على IIS). VirtualPathFilter تعيين عامل تصفية regex للمسار الظاهري (HostingEnvironment.ApplicationVirtualPath في حالة .NET على IIS). لوضع علامات للتطبيق المفرد يجب استخدام VirtualPathFilter كما يلي:Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap @(@{VirtualPathFilter="^/MyAppName$"; InstrumentationSettings=@{InstrumentationKey='<your ikey>'}})

المعلمات

-ConnectionString

مطلوب. استخدم هذه المعلمة لتوفير سلسلة الاتصال واحد للاستخدام من قبل جميع التطبيقات على الكمبيوتر الهدف.

مفتاح تقرير عن حالة النظام

مطلوب. استخدم هذه المعلمة لدعم مفتاح تقرير عن حالة النظام مفرد للاستخدام من قِبل جميع التطبيقات على الكمبيوتر الهدف.

-مخطط مفتاح تقرير عن حالة النظام

مطلوب. استخدم هذه المعلمة لدعم مفاتيح تقرير عن حالة النظام متعدد وتعيين مفاتيح تقرير عن حالة النظام المستخدم من قِبل كل تطبيق. يمكنك إنشاء برنامج نصي مُثبّت مفرد لأجهزة كمبيوتر متعددة من خلال الإعداد MachineFilter.

هام

تتطابق التطبيقات مع القواعد بالترتيب الذي يتم به توفير القواعد. لذلك يجب عليك تحديد القواعد الأكثر تحديدًا أولا وآخر القواعد الأكثر عمومية.

مخطط

@(@{MachineFilter='.*';AppFilter='.*';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'}})

MachineFilterهو regex C # المطلوبة من اسم الكمبيوتر أو الجهاز الظاهري.
- '.*' يطابق الكل
- يطابق "ComputerName" أجهزة الكمبيوتر فقط مع الاسم المحدد بالضبط.
AppFilterهو regex C# المطلوب من اسم الموقع IIS. يمكنك الحصول على قائمة المواقع على الخادم الخاص بك من خلال تشغيل الأمرالحصول على iissite.
- '.*' يطابق الكل
- يتطابق "اسم الموقع" مع موقع IIS فقط مع الاسم المحدد بالضبط.
مفتاح تقرير عن حالة النظاممطلوب لتمكين مراقبة التطبيقات التي تطابق عاملي التصفية السابقين.
- اترك هذه القيمة خالية إذا كنت تريد تعريف القواعد لاستبعاد المراقبة.

EnableInstrumentationEngine

اختياري. استخدم رمز التبديل هذا لتمكين محرك تقرير عن حالة النظام من تجميع الأحداث والرسائل حول ما يحدث أثناء تنفيذ العملية مدارة. تشمل هذه الأحداث والرسائل التعليمة البرمجية لنتائج التبعية وأفعال HTTPونص الأمر SQL.

يضيف محرك تقرير عن حالة النظام حِملا وإيقاف تشغيله بشكل افتراضي.

-الموافقة على الترخيص

اختياري. استخدم رمز التبديل هذا لقبول الترخيص وبيان الخصوصية في عمليات التثبيت بدون أجهزة ملحقة.

IgnoreSharedConfig

عندما يكون لديك نظام مجموعة من خوادم الويب، قد تستخدمتكوين مشترك. لا يمكن إدخال HttpModule في هذا التكوين المشترك. يفشل هذا البرنامج النصي مع الرسالة التي تفيد بأن خطوات التثبيت الإضافية مطلوبة. استخدم رمز التبديل هذا لتجاهل هذا الفحص ومتابعة تثبيت المتطلبات الأساسية. لمزيد من المعلومات، انظرتكوين التعارض مع iis-shared-configuration المعروف

رسالة مطولة

المعلمة العامة. استخدم رمز التبديل هذا لعرض السجلات المفصلة.

-WhatIf

المعلمة العامة. استخدم رمز التبديل هذا لاختبار معلمات الإدخال والتحقق من مصداقيتها دون تمكين المراقبة فعليا.

المخرجات

مثال مُخرج من تمكين ناجح

Initiating Disable Process
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-52z'
in :1,237
No element in the source document matches '/configuration/location[@path='']/system.webServer/modules/add[@name='ManagedHttpModuleHelper']'
Not executing RemoveAll (transform line 1, 546)
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'disable'
GAC Module will not be removed, since this operation might cause IIS instabilities
Configuring IIS Environment for codeless attach...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring IIS Environment for instrumentation engine...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring registry for instrumentation engine...
Successfully disabled Application Insights Agent
Installing GAC module 'C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\0.2.0\content\Runtime\Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.dll'
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
Found GAC module Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.ManagedHttpModuleHelper, Microsoft.AppInsights.IIS.ManagedHttpModuleHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-52z_1'
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'enable'
Configuring IIS Environment for codeless attach...
Configuring IIS Environment for instrumentation engine...
Configuring registry for instrumentation engine...
Updating app pool permissions...
Successfully enabled Application Insights Agent

تعطيل-InstrumentationEngine

تعطيل محرك تقرير عن حالة النظام عن طريق إزالة بعض مفاتيح التسجيل. إعادة تشغل IIS لتصبح التغييرات سارية المفعول.

الأمثلة

Disable-InstrumentationEngine

المعلمات

رسالة مطولة

المعلمة العامة. استخدم رمز التبديل هذا لإخراج السجلات المفصلة.

المخرجات

إخراج المثال من تعطيل محرك تقرير عن حالة النظام بنجاح

Configuring IIS Environment for instrumentation engine...
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]'
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]'
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]'
Configuring registry for instrumentation engine...

Disable-ApplicationInsightsMonitoring

تعطيل المراقبة على الكمبيوتر المستهدف. يقوم cmdlet هذا بإزالة عمليات التحرير إلى تطبيق IISHost.config وإزالة مفاتيح التسجيل.

الأمثلة

Disable-ApplicationInsightsMonitoring

المعلمات

رسالة مطولة

المعلمة العامة. استخدم رمز التبديل هذا لعرض السجلات المفصلة.

المخرجات

إخراج المثال من إلغاء تفعيل المراقبة بنجاح

Initiating Disable Process
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-00z'
in :1,237
No element in the source document matches '/configuration/location[@path='']/system.webServer/modules/add[@name='ManagedHttpModuleHelper']'
Not executing RemoveAll (transform line 1, 546)
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'disable'
GAC Module will not be removed, since this operation might cause IIS instabilities
Configuring IIS Environment for codeless attach...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring IIS Environment for instrumentation engine...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring registry for instrumentation engine...
Successfully disabled Application Insights Agent

Get-ApplicationInsightsMonitoringConfig

الحصول على ملف التكوين وطباعة القيم إلى وحدة التحكم.

الأمثلة

Get-ApplicationInsightsMonitoringConfig

المعلمات

لا يتطلب معلمات.

المخرجات

استخراج المثال من قراءة ملف التكوين

RedfieldConfiguration:
Filters:
0)InstrumentationKey:  AppFilter: WebAppExclude MachineFilter: .*
1)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2 AppFilter: WebAppTwo MachineFilter: .*
2)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault AppFilter: .* MachineFilter: .*

Get-ApplicationInsightsMonitoringStatus

يوفر cmdlet هذا معلومات استكشاف الأخطاء وإصلاحها حول Application Insights Agent. استخدم cmdlet للتحقيق في حالة المراقبة، وإصدار الوحدة النمطية PowerShell، ولفحص عملية التشغيل. يبلغ cmdlet هذا عن معلومات الإصدار ومعلومات حول الملفات الرئيسية المطلوبة للمراقبة.

الأمثلة

مثال: حالة التطبيق

تشغيل الأمرGet-ApplicationInsightsMonitoringStatusلتقديم حالة مراقبة مواقع ويب.

Get-ApplicationInsightsMonitoringStatus

IIS Websites:

SiteName               : Default Web Site
ApplicationPoolName    : DefaultAppPool
SiteId                 : 1
SiteState              : Stopped

SiteName               : DemoWebApp111
ApplicationPoolName    : DemoWebApp111
SiteId                 : 2
SiteState              : Started
ProcessId              : not found

SiteName               : DemoWebApp222
ApplicationPoolName    : DemoWebApp222
SiteId                 : 3
SiteState              : Started
ProcessId              : 2024
Instrumented           : true
InstrumentationKey     : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx123

SiteName               : DemoWebApp333
ApplicationPoolName    : DemoWebApp333
SiteId                 : 4
SiteState              : Started
ProcessId              : 5184
AppAlreadyInstrumented : true

في هذا المثال:

معرف الجهاز هو معرف مجهول يستخدم لتعريف الخادم بشكل فريد. إذا قمت بإنشاء طلب دعم، فنحن بحاجة إلى هذا المعرف للعثور على سجلات للخادم الخاص بك.
تم إيقاف موقع ويب الافتراضي في IIS
تم بدءتشغيل DemoWebApp111في IIS، ولكن لم يتلق أي طلبات. يُظهر هذا التقرير أنه لا توجد عملية قيد التشغيل (ProcessId: لم يتم العثور عليها).
DemoWebApp222قيد التشغيل ويتم مراقبته (الأداة: true). استنادًا إلى تكوين المستخدم، تمت مطابقة مفتاح تقرير عن حالة النظام xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx123 لهذا الموقع.
تم وضع علامةDemoWebApp333يدويا باستخدام التطبيق Application Insights SDK. كشف Application Insights Agent عن SDK ولا يراقب هذا الموقع.
يشير وجود AppAlreadyInstrumented : true إلى أن عامل Application Insights حدد dll متعارضا تم تحميله في تطبيق الويب، وافترض أن تطبيق الويب يتم تجهيزه يدويا، وأن العامل قد تراجع ولا يستخدم هذه العملية.
Instrumented : true يشير إلى أن عامل Application Insights قام بنجاح باستخدام تطبيق الويب قيد التشغيل في عملية w3wp.exe المحددة.

مثال: المعلومات الخاصة بالوحدة النمطية PowerShell

تشغيل الأمرGet-ApplicationInsightsMonitoringStatus -PowerShellModuleلعرض معلومات حول الوحدة النمطية الحالية:

Get-ApplicationInsightsMonitoringStatus -PowerShellModule

PowerShell Module version:
0.4.0-alpha

Application Insights SDK version:
2.9.0.3872

Executing PowerShell Module Assembly:
Microsoft.ApplicationInsights.Redfield.Configurator.PowerShell, Version=2.8.14.11432, Culture=neutral, PublicKeyToken=31bf3856ad364e35

PowerShell Module Directory:
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\0.2.2\content\PowerShell

Runtime Paths:
ParentDirectory (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content

ConfigurationPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\applicationInsights.ikey.config

ManagedHttpModuleHelperPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.dll

RedfieldIISModulePath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll

InstrumentationEngine86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\MicrosoftInstrumentationEngine_x86.dll

InstrumentationEngine64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\MicrosoftInstrumentationEngine_x64.dll

InstrumentationEngineExtensionHost86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\Microsoft.ApplicationInsights.ExtensionsHost_x86.dll

InstrumentationEngineExtensionHost64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.ExtensionsHost_x64.dll

InstrumentationEngineExtensionConfig86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\Microsoft.InstrumentationEngine.Extensions.config

InstrumentationEngineExtensionConfig64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.InstrumentationEngine.Extensions.config

ApplicationInsightsSdkPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.dll

مثال: حالة وقت تشغيل اللغة العامة

يمكنك فحص العملية على الكمبيوتر الذي تم تجهيزه لمعرفة ما إذا كان تم تحميل DLLs جميعها. إذا كانت المراقبة تعمل، فيجب تحميل ما لا يقل عن 12 DLLs.

شغَّل الأمر Get-ApplicationInsightsMonitoringStatus -InspectProcess:

Get-ApplicationInsightsMonitoringStatus -InspectProcess

iisreset.exe /status
Status for IIS Admin Service ( IISADMIN ) : Running
Status for Windows Process Activation Service ( WAS ) : Running
Status for Net.Msmq Listener Adapter ( NetMsmqActivator ) : Running
Status for Net.Pipe Listener Adapter ( NetPipeActivator ) : Running
Status for Net.Tcp Listener Adapter ( NetTcpActivator ) : Running
Status for World Wide Web Publishing Service ( W3SVC ) : Running

handle64.exe -accepteula -p w3wp
BF0: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.ServerTelemetryChannel.dll
C58: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.AzureAppServices.dll
C68: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.DependencyCollector.dll
C78: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.WindowsServer.dll
C98: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.Web.dll
CBC: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.PerfCounterCollector.dll
DB0: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.Agent.Intercept.dll
B98: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll
BB4: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.Contracts.dll
BCC: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.Redfield.Lightup.dll
BE0: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.dll

listdlls64.exe -accepteula w3wp
0x0000000019ac0000  0x127000  C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\MicrosoftInstrumentationEngine_x64.dll
0x00000000198b0000  0x4f000   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.ExtensionsHost_x64.dll
0x000000000c460000  0xb2000   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.Extensions.Base_x64.dll
0x000000000ad60000  0x108000  C:\Windows\TEMP\2.4.0.0.Microsoft.ApplicationInsights.Extensions.Intercept_x64.dll

المعلمات

(لا يحتوي على أي معلمات)

بشكل افتراضي، يبلغ cmdlet هذا عن حالة مراقبة تطبيقات الويب. استخدم هذا الخيار لمراجعة ما إذا كان التطبيق قد تم بنجاح. يمكنك أيضا استعراض التعليمات البرمجية لمفتاح التقرير عن حالة النظام المطابق للموقع.

PowerShellModule

اختياري. استخدم رمز التبديل هذا للإبلاغ عن أرقام الإصدار ومسارات DLLs المطلوبة للمراقبة. استخدم هذا الخيار إذا كنت بحاجة إلى تعريف أي إصدار من DLL بما في ذلك إصدار Application Insights SDK.

-عملية الفحص

اختياري. استخدم رمز التبديل هذا للإبلاغ في حال كان IIS قيد التشغيل. يقوم بتنزيل أدوات خارجية لتحديد ما إذا كان يتم تحميل DLLs الضرورية في وقت تشغيل IIS.

إذا فشلت هذه العملية لأي سبب من الأسباب، فيمكنك تشغيل هذه الأوامر يدويًا:

iisreset.exe/ الحالة
handle64.exe -p w3wp | findstr / I "الأجهزة الإنجليزية للذكاء الاصطناعي. التطبيقات البصرية"
listdlls64.exew3wp | findstr /I "الأجهزة الإنجليزية للذكاء الاصطناعي ApplicationInsights"

-Force

اختياري. ييتم استخدامه فقط مع InspectProcess. استخدم مفتاح التبديل هذا لتخطي مطالبة المستخدم التي تظهر قبل تنزيل المزيد من الأدوات.

Set-ApplicationInsightsMonitoringConfig

تعيين ملف التكوين دون القيام بإعادة التثبيت المتكامل. إعادة تشغيل IIS للتغييرات الخاصة بك لتصبح نافذة المفعول.

هام

يتطلب cmdlet جلسة PowerShell مع أذونات المسؤول.

الأمثلة

مثال باستخدام مفتاح تقرير عن حالة النظام المفرد

في هذا المثال، يتم تعيين مفتاح تقرير عن حالة النظام مفرد لكافة التطبيقات على الكمبيوتر الحالي.

Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

مثال مع خريطة مفتاح تقرير عن حالة النظام

في هذا المثال:

MachineFilterيُطابق الكمبيوتر الحالي باستخدام'.*' حرف البدل.
AppFilter='WebAppExclude'احصل علىnullمفتاح تقرير عن حالة النظام. التطبيق المحدد غير مجهز.
AppFilter='WebAppOne' يعين التطبيق المحدد لمفتاح تقرير عن حالة النظام فريد من نوعها.
AppFilter='WebAppTwo' يعين التطبيق المحدد لمفتاح تقرير عن حالة النظام فريد من نوعها.
AppFilter'.*' يستخدم حرف البدل لمطابقة تطبيقات الويب التي لا يتطابق معها بالفعل ويعين مفتاح تقرير عن حالة النظام الافتراضي.
أُضيفت المسافات لتسهيل القراءة.

Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap `
    ` @(@{MachineFilter='.*';AppFilter='WebAppExclude'},
      ` @{MachineFilter='.*';AppFilter='WebAppOne';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx1'}},
      ` @{MachineFilter='.*';AppFilter='WebAppTwo';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2'}},
      ` @{MachineFilter='.*';AppFilter='.*';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault'}})

المعلمات

مفتاح تقرير عن حالة النظام

-مخطط مفتاح تقرير عن حالة النظام

هام

مخطط

@(@{MachineFilter='.*';AppFilter='.*';InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'})

MachineFilterهو regex C # المطلوبة من اسم الكمبيوتر أو الجهاز الظاهري.
- '.*' يطابق الكل
- يتطابق "ComputerName" مع أجهزة الكمبيوتر ذات الاسم المحدد فقط.
AppFilter هو مطلوب C # regex للكمبيوتر أو اسم الجهاز الظاهري.
- '.*' يطابق الكل
- يطابق "ApplicationName" تطبيقات IIS فقط مع الاسم المحدد.
مفتاح تقرير عن حالة النظاميتطلب لتمكين مراقبة التطبيقات التي تطابق عاملي التصفية السابقين.
- اترك هذه القيمة خالية إذا كنت تريد تعريف القواعد لاستبعاد المراقبة.

رسالة مطولة

المعلمة العامة. استخدم رمز التبديل هذا لعرض السجلات المفصلة.

المخرجات

لا توجد مخرجات بشكل افتراضي.

مثال الإخراج المطول من إعداد ملف التكوين عبر-InstrumentationKey

VERBOSE: Operation: InstallWithIkey
VERBOSE: InstrumentationKeyMap parsed:
Filters:
0)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx AppFilter: .* MachineFilter: .*
VERBOSE: set config file
VERBOSE: Config File Path:
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\applicationInsights.ikey.config

مثال الإخراج المطول حسب إعداد ملف التكوين عبر -InstrumentationKeyMap

VERBOSE: Operation: InstallWithIkeyMap
VERBOSE: InstrumentationKeyMap parsed:
Filters:
0)InstrumentationKey:  AppFilter: WebAppExclude MachineFilter: .*
1)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2 AppFilter: WebAppTwo MachineFilter: .*
2)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault AppFilter: .* MachineFilter: .*
VERBOSE: set config file
VERBOSE: Config File Path:
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\applicationInsights.ikey.config

Start-ApplicationInsightsMonitoringTrace

جمعأحداث ETWمن وقت التشغيل المرفق بدون تعليمات برمجية. cmdlet هو بديل لمشغلPerfView.

يتم تجميع الأحداث وطباعتها إلى وحدة التحكم في الوقت الفعلي وحفظها في ملف ETL. يمكنك فتح ملف ETL الإخراج مع PerfView لمزيد من التحقيق.

يتم تشغيل cmdlet هذا حتى يصل إلى مدة المهلة (افتراضي 5 دقائق) أو يتم إيقافه يدويا (Ctrl + C).

الأمثلة

كيفية تجميع الأحداث

عادة ما نطلب منك جمع الأحداث للتحقيق في سبب عدم استخدام التطبيق.

يصدر وقت تشغيل إرفاق بدون تعليمات برمجية أحداث ETW عند بدء تشغيل IIS وعند بدء تشغيل التطبيق الخاص بك.

لجمع هذه الأحداث:

في وحدة تحكم cmd مع امتيازات المسؤول، قم بتنفيذ iisreset /stop لإيقاف IIS وجميع تطبيقات الويب.
تنفيذ cmdlet هذا
في وحدة تحكم cmd مع امتيازات المسؤول، نفذ iisreset /start لبدء IIS.
حاول الاستعراض للوصول إلى التطبيق.
بعد انتهاء تحميل التطبيق، يمكنك إيقافه يدويًا (Ctrl + C) أو الانتظار حتى انتهاء المهلة.

ما هي الأحداث التي يمكن جمعها

لديك ثلاثة خيارات عندما تجمع الأحداث:

استخدم رمز التبديل-CollectSdkEventsلتجميع الأحداث المنبعثة من Application Insights SDK.
استخدم التبديل -CollectRedfieldEvents لتجميع الأحداث المنبعثة من Application Insights Agent وRedfield Runtime. يمكن الاستفادة من هذه السجلات عند تشخيص IIS وبدء تشغيل التطبيق.
استخدم مفتاحي التبديل كلاهما لجمع كلا النوعين من الأحداث.
بشكل افتراضي، إذا لم يتم تحديد مفتاح، يتم تجميع كلا النوعين من الأحداث.

المعلمات

MaxDurationInMinutes

اختياري. استخدم هذه المعلمة لتعيين المدة التي يجب أن يجمع فيها هذا البرنامج النصي الأحداث. الوقت الافتراضي هو 5 دقائق.

LogDirectory

اختياري. استخدم رمز التبديل هذا لتعيين دليل الإخراج الخاص بملف ETL. بشكل افتراضي، يتم إنشاء هذا الملف في دليل PowerShell Modules. يتم عرض المسار الكامل أثناء تنفيذ البرنامج النصي.

-الأحداث المجمعة

اختياري. استخدم رمز التبديل لجمع أحداث تطبيق SDK Application Insights.

CollectRedfieldEvents

اختياري. استخدم مفتاح التبديل هذا لتجميع الأحداث من Application Insights Agent ووقت تشغيل Redfield.

رسالة مطولة

المعلمة العامة. استخدم رمز التبديل هذا لإخراج السجلات المفصلة.

المخرجات

مثال لسجلات بدء تشغيل التطبيق

Start-ApplicationInsightsMonitoringTrace -CollectRedfieldEvents
Starting...
Log File: C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\logs\20190627_144217_ApplicationInsights_ETW_Trace.etl
Tracing enabled, waiting for events.
Tracing will timeout in 5 minutes. Press CTRL+C to cancel.

2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftAppInsights_ManagedHttpModulePath='C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll', MicrosoftAppInsights_ManagedHttpModuleType='Microsoft.ApplicationInsights.RedfieldIISModule.RedfieldIISModule'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftDiagnosticServices_ManagedHttpModulePath2='', MicrosoftDiagnosticServices_ManagedHttpModuleType2=''
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Environment variable 'MicrosoftDiagnosticServices_ManagedHttpModulePath2' or 'MicrosoftDiagnosticServices_ManagedHttpModuleType2' is null, skipping managed dll loading
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace MulticastHttpModule.constructor, success, 70 ms
2:42:31 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace Current assembly 'Microsoft.ApplicationInsights.RedfieldIISModule, Version=2.8.18.27202, Culture=neutral, PublicKeyToken=f23a46de0be5d6f3' location 'C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace Matched filter '.*'~'STATUSMONITORTE', '.*'~'DemoWithSql'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace Lightup assembly calculated path: 'C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.Redfield.Lightup.dll'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-FrameworkLightup Trace Loaded applicationInsights.config from assembly's resource Microsoft.ApplicationInsights.Redfield.Lightup, Version=2.8.18.27202, Culture=neutral, PublicKeyToken=f23a46de0be5d6f3/Microsoft.ApplicationInsights.Redfield.Lightup.ApplicationInsights-recommended.config
2:42:34 PM EVENT: Microsoft-ApplicationInsights-FrameworkLightup Trace Successfully attached ApplicationInsights SDK
2:42:34 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace RedfieldIISModule.LoadLightupAssemblyAndGetLightupHttpModuleClass, success, 2687 ms
2:42:34 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace RedfieldIISModule.CreateAndInitializeApplicationInsightsHttpModules(lightupHttpModuleClass), success
2:42:34 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace ManagedHttpModuleHelper, multicastHttpModule.Init() success, 3288 ms
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftAppInsights_ManagedHttpModulePath='C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll', MicrosoftAppInsights_ManagedHttpModuleType='Microsoft.ApplicationInsights.RedfieldIISModule.RedfieldIISModule'
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftDiagnosticServices_ManagedHttpModulePath2='', MicrosoftDiagnosticServices_ManagedHttpModuleType2=''
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Environment variable 'MicrosoftDiagnosticServices_ManagedHttpModulePath2' or 'MicrosoftDiagnosticServices_ManagedHttpModuleType2' is null, skipping managed dll loading
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace MulticastHttpModule.constructor, success, 0 ms
2:42:35 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace RedfieldIISModule.CreateAndInitializeApplicationInsightsHttpModules(lightupHttpModuleClass), success
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace ManagedHttpModuleHelper, multicastHttpModule.Init() success, 0 ms
Timeout Reached. Stopping...

يتم سرد تحديثات ملاحظات الإصدار هنا.

2.0.0

تحديث Application Insights .NET/.NET Core SDK إلى 2.21.0-redfield

2.0.0 - بيتا3

تحديث Application Insights .NET/.NET Core SDK إلى 2.20.1-redfield
مجموعة استعلام SQL الممكنة

2.0.0-بيتا2

تحديث Application Insights .NET/.NET Core SDK إلى 2.18.1-redfield

2.0.0-بيتا1

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

الأسئلة الشائعة

يقدم هذا القسم إجابات للأسئلة الشائعة.

هل يدعم Application Insights Agent عمليات التثبيت بالوكيل؟

نعم. هناك طرق متعددة لتنزيل Application Insights Agent:

إذا كان حاسوبك متصلاً بالإنترنت، يمكنك الصعود إلى معرض PowerShell باستخدام المعلمات-Proxy.
يمكنك أيضًا تنزيل الوحدة يدويًا وتثبيتها على جهاز الكمبيوتر الخاص بك أو استخدامها مباشرة.

تم وصف كل خيار من هذه الخيارات في الإرشادات التفصيلية .

هل يدعم Application Insights Agent التطبيقات الأساسية ASP.NET؟

نعم. في Application Insights Agent 2.0.0 والإحدث، يتم دعم ASP.NET التطبيقات الأساسية المستضافة في IIS.

كيف يمكنني التحقق من نجاح التمكين؟

يمكنك استخدام الأمر cmdlet Get-ApplicationInsightsMonitoringStatus للتحقق من نجاح التمكين.
- استخدم Live Metrics لتحديد ما إذا كان تطبيقك يرسل بيانات تتبع الاستخدام بسرعة.
- يمكنك أيضًا استخدام تحليلات السجل لسرد جميع أدوار السحابة التي ترسل حاليًا التتبع عن بُعد:
```
union * | summarize count() by cloud_RoleName, cloud_RoleInstance
```

كيف أعمل تحقيق مرور الوكيل؟

لتحقيق مرور الوكيل، قم بتكوين وكيل على مستوى الجهاز أو وكيل على مستوى التطبيق. راجع DefaultProxy.

مثال على Web.config:

<system.net>
    <defaultProxy>
    <proxy proxyaddress="http://xx.xx.xx.xx:yyyy" bypassonlocal="true"/>
    </defaultProxy>
</system.net>

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

راجع «dedicated troubleshooting article».

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

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

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

عرض القياس عن بُعد الخاص بك:

استكشف المقاييسلمراقبة الأداء والاستخدام.
بحث عن الأحداث والسجلاتلتشخيص المشاكل.
استخدم Log Analytics للاستعلامات الأكثر تقدما.
إنشاء لوحات المعلومات.

إضافة المزيد من بيانات تتبع الاستخدام:

نظرة عامة على التوفر
أضف بيانات تتبع الاستخدام لعميل الويب لمشاهدة الاستثناءات من التعليمات البرمجية لصفحة الويب ولتمكين استدعاءات التتبع.
أضف Application Insights SDK إلى التعليمات البرمجية الخاصة بك بحيث يمكنك إدراج التتبع وتسجيل المكالمات.

قم بالمزيد باستخدام عامل Application Insights:

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

مشاركة عبر

انشر Azure Monitor Application Insights Agent للخوادم المحلية

معرض PowerShell

الإرشادات

قم بالتنزيل والتثبيت عبر معرض PowerShell

متطلبات التثبيت

قم بتثبيت Application Insights Agent

تمكين المراقبة

تنزيل وتثبيت يدويًا (خيار غير متصل بالشبكة)

قم بتنزيل الوحدة

قم بفك ضغط وكيل Application Insights وتثبيته

تمكين المراقبة

الأسئلة الشائعة

هل يدعم Application Insights Agent عمليات التثبيت بالوكيل؟

هل يدعم Application Insights Agent التطبيقات الأساسية ASP.NET؟

كيف يمكنني التحقق من نجاح التمكين؟

كيف أعمل تحقيق مرور الوكيل؟

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

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

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

الملاحظات

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