إنشاء مورد Application Insights

تنبيه

تنطبق هذه المقالة على موارد Application Insights الكلاسيكية، والتي لم تعد مستحسنة.

المعلومات الواردة في هذه المقالة قديمة ولن يتم تحديثها.

الانتقال إلى Application Insights المستند إلى مساحة العمل للاستفادة من الإمكانات الجديدة.

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

هام

في 29 فبراير 2024، سينتهي دعم Application Insights الكلاسيكي. الانتقال إلى Application Insights المستند إلى مساحة العمل للاستفادة من الإمكانات الجديدة. لا تدعم المناطق الأحدث التي تم تقديمها بعد فبراير 2021 إنشاء موارد Application Insights الكلاسيكية.

إشعار

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

تسجيل الدخول إلى Azure

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

إنشاء مورد Application Insights

سجل الدخول إلى مدخل Microsoft Azure وأنشئ مورد Application Insights.

الإعدادات	قيمة	‏‏الوصف
الاسم	Unique value	الاسم المعرف للتطبيق الذي تراقبه.
مجموعة الموارد	myResourceGroup	اسم مجموعة الموارد الجديدة أو الموجودة لاستضافة بيانات Application Insights.
المنطقة	East US	حدد موقعا قريبا منك أو بالقرب من مكان استضافة تطبيقك.
وضع المورد	Classic أو Workspace-based	تسمح لك الموارد المستندة إلى مساحة العمل بإرسال Application Insights للقياس عن بعد الخاص بك إلى مساحة عمل "تحليلات السجل" الشائعة. لمزيد من المعلومات، راجع موارد Application Insights المستندة إلى مساحة العمل.

إشعار

يمكنك استخدام نفس اسم المورد عبر مجموعات موارد مختلفة، ولكن يمكن أن يكون من المفيد استخدام اسم فريد عالميا. إذا كنت تخطط لإجراء استعلامات عبر الموارد، فإن استخدام اسم فريد عمومي يبسط بناء الجملة المطلوب.

أدخل القيم المناسبة في الحقول المطلوبة. حدد "Review + create".

بعد إنشاء التطبيق، يعرض جزء جديد بيانات الأداء والاستخدام حول التطبيق الذي تتم مراقبته.

انسخ مفتاح الأجهزة

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

قم بتثبيت عدة تطوير البرامج SDK على التطبيق الخاص بك

قم بتثبيت عدة تطوير البرامج Application Insights SDK في التطبيق الخاص بك. تعتمد هذه الخطوة بشكل كبير على نوع التطبيق الخاص بك.

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

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

إنشاء مورد تلقائي

استخدم PowerShell أو Azure CLI لإنشاء مورد تلقائيا.

PowerShell

إنشاء مورد Application Insights جديد.

New-AzApplicationInsights [-ResourceGroupName] <String> [-Name] <String> [-Location] <String> [-Kind <String>]
 [-Tag <Hashtable>] [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]

مثال

New-AzApplicationInsights -Kind java -ResourceGroupName testgroup -Name test1027 -location eastus

النتائج

Id                 : /subscriptions/{subid}/resourceGroups/testgroup/providers/microsoft.insights/components/test1027
ResourceGroupName  : testgroup
Name               : test1027
Kind               : web
Location           : eastus
Type               : microsoft.insights/components
AppId              : 8323fb13-32aa-46af-b467-8355cf4f8f98
ApplicationType    : web
Tags               : {}
CreationDate       : 10/27/2017 4:56:40 PM
FlowType           :
HockeyAppId        :
HockeyAppToken     :
InstrumentationKey : 00000000-aaaa-bbbb-cccc-dddddddddddd
ProvisioningState  : Succeeded
RequestSource      : AzurePowerShell
SamplingPercentage :
TenantId           : {subid}

للحصول على وثائق PowerShell الكاملة لهذا cmdlet، ولمعرفة كيفية استرداد مفتاح الأجهزة راجع وثائق Azure PowerShell.

(معاينة) Azure CLI

للوصول إلى أوامر واجهة سطر الأوامرApplication Insights من الإصدار الأولي، يجب عليك تشغيل ما يلي أولاً:

 az extension add -n application-insights

إذا لم تقم بتشغيل az extension add الأمر، فسترى رسالة خطأ تنص على: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

قم بتشغيل الأمر التالي لإنشاء مورد Application Insights الخاص بك:

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--kind]
                                         [--tags]

مثال

az monitor app-insights component create --app demoApp --location westus2 --kind web --resource-group demoRg --application-type web

النتائج

az monitor app-insights component create --app demoApp --location eastus --kind web --resource-group demoApp --application-type web
{
  "appId": "87ba512c-e8c9-48d7-b6eb-118d4aee2697",
  "applicationId": "demoApp",
  "applicationType": "web",
  "creationDate": "2019-08-16T18:15:59.740014+00:00",
  "etag": "\"0300edb9-0000-0100-0000-5d56f2e00000\"",
  "flowType": "Bluefield",
  "hockeyAppId": null,
  "hockeyAppToken": null,
  "id": "/subscriptions/{subid}/resourceGroups/demoApp/providers/microsoft.insights/components/demoApp",
  "instrumentationKey": "00000000-aaaa-bbbb-cccc-dddddddddddd",
  "kind": "web",
  "location": "eastus",
  "name": "demoApp",
  "provisioningState": "Succeeded",
  "requestSource": "rest",
  "resourceGroup": "demoApp",
  "samplingPercentage": null,
  "tags": {},
  "tenantId": {tenantID},
  "type": "microsoft.insights/components"
}

للحصول على وثائق Azure CLI الكاملة لهذا الأمر، ولمعرفة كيفية استرداد مفتاح الأجهزة، راجع وثائق Azure CLI.

تجاوز نقاط النهاية الافتراضية

تحذير

لا تقم بتعديل نقاط النهاية. الانتقال إلى سلاسل الاتصال لتبسيط التكوين والقضاء على الحاجة إلى تعديل نقطة النهاية.

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

تتطلب منك هذه التغييرات ضبط نموذج التعليمات البرمجية واستبدال قيم العنصر النائب ل QuickPulse_Endpoint_Addressو TelemetryChannel_Endpoint_Addressو بعناوين Profile_Query_Endpoint_address نقطة النهاية الفعلية لمنطقتك المحددة. تحتوي نهاية هذه المقالة على إرتباطات لعناوين نقاط النهاية للمناطق التي يتطلب فيها هذا التكوين.

إشعار

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

---

تغييرات التعليمات البرمجية SDK

NET.

إشعار

تتم الكتابة فوق ملف applicationinsights.config تلقائيا في أي وقت يتم فيه إجراء ترقية SDK. بعد إجراء ترقية SDK، تأكد من إعادة إدخال قيم نقطة النهاية الخاصة بالمنطقة.

<ApplicationInsights>
  ...
  <TelemetryModules>
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector">
      <QuickPulseServiceEndpoint>Custom_QuickPulse_Endpoint_Address</QuickPulseServiceEndpoint>
    </Add>
  </TelemetryModules>
   ...
  <TelemetrySinks>
    <Add Name = "default">
      <TelemetryChannel>
         <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
      </TelemetryChannel>
    </Add>
  </TelemetrySinks>
  ...
  <ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights">
    <ProfileQueryEndpoint>Profile_Query_Endpoint_address</ProfileQueryEndpoint>
  </ApplicationIdProvider>
  ...
</ApplicationInsights>

.NET Core

تعديل ملف appsettings.json في مشروعك لضبط نقطة النهاية الرئيسية:

"ApplicationInsights": {
    "InstrumentationKey": "instrumentationkey",
    "TelemetryChannel": {
      "EndpointAddress": "TelemetryChannel_Endpoint_Address"
    }
  }

يمكن تعيين قيم Live Metrics ونقطة نهاية استعلام ملف التعريف فقط عبر التعليمات البرمجية. لتجاوز القيم الافتراضية لكافة قيم نقطة النهاية عبر التعليمات البرمجية، قم بإجراء التغييرات التالية في ConfigureServices أسلوب Startup.cs الملف:

using Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse; //Place at top of Startup.cs file

   services.ConfigureTelemetryModule<QuickPulseTelemetryModule>((module, o) => module.QuickPulseServiceEndpoint="QuickPulse_Endpoint_Address");

   services.AddSingleton<IApplicationIdProvider, ApplicationInsightsApplicationIdProvider>(_ => new ApplicationInsightsApplicationIdProvider() { ProfileQueryEndpoint = "Profile_Query_Endpoint_address" });

   services.AddSingleton<ITelemetryChannel>(_ => new ServerTelemetryChannel() { EndpointAddress = "TelemetryChannel_Endpoint_Address" });

    //Place in the ConfigureServices method. Place this before services.AddApplicationInsightsTelemetry("instrumentation key"); if it's present

دالات Azure

بالنسبة إلى Azure Functions، نوصي باستخدام سلسلة الاتصال المعينة في إعدادات تطبيق الدالة. للوصول إلى إعدادات التطبيق للدالة الخاصة بك من داخل جزء الوظائف، حدد الإعدادات>إعدادات تطبيق التكوين.>

الاسم: APPLICATIONINSIGHTS_CONNECTION_STRING
القيمة: Connection String Value

Java

تعديل ملف applicationinsights.xml لتغيير عنوان نقطة النهاية الافتراضي:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
  <InstrumentationKey>ffffeeee-dddd-cccc-bbbb-aaaa99998888</InstrumentationKey>
  <TelemetryModules>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebRequestTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebSessionTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebUserTrackingTelemetryModule"/>
  </TelemetryModules>
  <TelemetryInitializers>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationIdTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationNameTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebSessionTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserAgentTelemetryInitializer"/>
  </TelemetryInitializers>
  <!--Add the following Channel value to modify the Endpoint address-->
  <Channel type="com.microsoft.applicationinsights.channel.concrete.inprocess.InProcessTelemetryChannel">
  <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
  </Channel>
</ApplicationInsights>

Spring Boot

قم بتعديل application.properties الملف وإضافة:

azure.application-insights.channel.in-process.endpoint-address= TelemetryChannel_Endpoint_Address

Node.js

var appInsights = require("applicationinsights");
appInsights.setup('INSTRUMENTATION_KEY');
appInsights.defaultClient.config.endpointUrl = "TelemetryChannel_Endpoint_Address"; // ingestion
appInsights.defaultClient.config.profileQueryEndpoint = "Profile_Query_Endpoint_address"; // appid/profile lookup
appInsights.defaultClient.config.quickPulseHost = "QuickPulse_Endpoint_Address"; //live metrics
appInsights.Configuration.start();

يمكن تكوين نقاط النهاية أيضا من خلال متغيرات البيئة:

**Instrumentation Key*: "APPINSIGHTS_INSTRUMENTATIONKEY"
*Profile endpoint*: "Profile_Query_Endpoint_address"
*Live Metrics endpoint*: "QuickPulse_Endpoint_Address"

JavaScript

القصاصة البرمجية الحالية المدرجة هنا الإصدار 5. يتم ترميز الإصدار في القصاصة البرمجية ك sv:"#". الإصدار الحالي متاح أيضًا على GitHub.

<script type="text/javascript">
!function(T,l,y){var S=T.location,k="script",D="instrumentationKey",C="ingestionendpoint",I="disableExceptionTracking",E="ai.device.",b="toLowerCase",w="crossOrigin",N="POST",e="appInsightsSDK",t=y.name||"appInsights";(y.name||T[e])&&(T[e]=t);var n=T[t]||function(d){var g=!1,f=!1,m={initialize:!0,queue:[],sv:"5",version:2,config:d};function v(e,t){var n={},a="Browser";return n[E+"id"]=a[b](),n[E+"type"]=a,n["ai.operation.name"]=S&&S.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(m.sv||m.version),{time:function(){var e=new Date;function t(e){var t=""+e;return 1===t.length&&(t="0"+t),t}return e.getUTCFullYear()+"-"+t(1+e.getUTCMonth())+"-"+t(e.getUTCDate())+"T"+t(e.getUTCHours())+":"+t(e.getUTCMinutes())+":"+t(e.getUTCSeconds())+"."+((e.getUTCMilliseconds()/1e3).toFixed(3)+"").slice(2,5)+"Z"}(),iKey:e,name:"Microsoft.ApplicationInsights."+e.replace(/-/g,"")+"."+t,sampleRate:100,tags:n,data:{baseData:{ver:2}}}}var h=d.url||y.src;if(h){function a(e){var t,n,a,i,r,o,s,c,u,p,l;g=!0,m.queue=[],f||(f=!0,t=h,s=function(){var e={},t=d.connectionString;if(t)for(var n=t.split(";"),a=0;a<n.length;a++){var i=n[a].split("=");2===i.length&&(e[i[0][b]()]=i[1])}if(!e[C]){var r=e.endpointsuffix,o=r?e.location:null;e[C]="https://"+(o?o+".":"")+"dc."+(r||"services.visualstudio.com")}return e}(),c=s[D]||d[D]||"",u=s[C],p=u?u+"/v2/track":d.endpointUrl,(l=[]).push((n="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",a=t,i=p,(o=(r=v(c,"Exception")).data).baseType="ExceptionData",o.baseData.exceptions=[{typeName:"SDKLoadFailed",message:n.replace(/\./g,"-"),hasFullStack:!1,stack:n+"\nSnippet failed to load ["+a+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(S&&S.pathname||"_unknown_")+"\nEndpoint: "+i,parsedStack:[]}],r)),l.push(function(e,t,n,a){var i=v(c,"Message"),r=i.data;r.baseType="MessageData";var o=r.baseData;return o.message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+n+")").replace(/\"/g,"")+'"',o.properties={endpoint:a},i}(0,0,t,p)),function(e,t){if(JSON){var n=T.fetch;if(n&&!y.useXhr)n(t,{method:N,body:JSON.stringify(e),mode:"cors"});else if(XMLHttpRequest){var a=new XMLHttpRequest;a.open(N,t),a.setRequestHeader("Content-type","application/json"),a.send(JSON.stringify(e))}}}(l,p))}function i(e,t){f||setTimeout(function(){!t&&m.core||a()},500)}var e=function(){var n=l.createElement(k);n.src=h;var e=y[w];return!e&&""!==e||"undefined"==n[w]||(n[w]=e),n.onload=i,n.onerror=a,n.onreadystatechange=function(e,t){"loaded"!==n.readyState&&"complete"!==n.readyState||i(0,t)},n}();y.ld<0?l.getElementsByTagName("head")[0].appendChild(e):setTimeout(function(){l.getElementsByTagName(k)[0].parentNode.appendChild(e)},y.ld||0)}try{m.cookie=l.cookie}catch(p){}function t(e){for(;e.length;)!function(t){m[t]=function(){var e=arguments;g||m.queue.push(function(){m[t].apply(m,e)})}}(e.pop())}var n="track",r="TrackPage",o="TrackEvent";t([n+"Event",n+"PageView",n+"Exception",n+"Trace",n+"DependencyData",n+"Metric",n+"PageViewPerformance","start"+r,"stop"+r,"start"+o,"stop"+o,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),m.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4};var s=(d.extensionConfig||{}).ApplicationInsightsAnalytics||{};if(!0!==d[I]&&!0!==s[I]){var c="onerror";t(["_"+c]);var u=T[c];T[c]=function(e,t,n,a,i){var r=u&&u(e,t,n,a,i);return!0!==r&&m["_"+c]({message:e,url:t,lineNumber:n,columnNumber:a,error:i}),r},d.autoExceptionInstrumented=!0}return m}(y.cfg);function a(){y.onInit&&y.onInit(n)}(T[t]=n).queue&&0===n.queue.length?(n.queue.push(a),n.trackPageView({})):a()}(window,document,{
src: "https://js.monitor.azure.com/scripts/b/ai.2.min.js", // The SDK URL Source
// name: "appInsights", // Global SDK Instance name defaults to "appInsights" when not supplied.
// ld: 0, // Defines the load delay (in ms) before attempting to load the sdk. -1 = block page load and add to head (default) = 0ms load after timeout.
// useXhr: 1, // Use XHR instead of fetch to report failures (if available).
crossOrigin: "anonymous", // When supplied, this will add the provided value as the cross origin attribute on the script tag.
// onInit: null, // Once the Application Insights instance has loaded and initialized, this callback function will be called with 1 argument -- the sdk instance. (DO NOT ADD anything to the sdk.queue -- as they won't get called.)
cfg: { // Application Insights Configuration
    instrumentationKey:"INSTRUMENTATION_KEY",
    endpointUrl: "TelemetryChannel_Endpoint_Address"
}});
</script>

إشعار

لسهولة القراءة ولتقليل أخطاء JavaScript المحتملة، يتم سرد جميع خيارات التكوين الممكنة في سطر جديد في رمز المقتطف السابق. إذا كنت لا تريد تغيير قيمة سطر معلق، فيمكن إزالته.

Python

للحصول على إرشادات حول تعديل نقطة نهاية الاستيعاب ل opencensus-python SDK، راجع مستودع opencensus-python.

المناطق التي تتطلب تعديل نقطة النهاية

حاليًا المناطق الوحيدة التي تتطلب تعديلات نقطة النهاية هي Azure Government وAzure China.

المنطقة	اسم نقطة النهاية	القيمة‬
Azure الصين:	قناة القياس عن بعد	https://dc.applicationinsights.azure.cn/v2/track
Azure الصين:	QuickPulse (مقاييس حية)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure الصين:	استعلام ملف التعريف	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	قناة القياس عن بعد	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (مقاييس حية)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	استعلام ملف التعريف	https://dc.applicationinsights.us/api/profiles/{0}/appId

إذا كنت تستخدم حاليا Application Insights REST API، والتي يتم الوصول إليها عادة عبر api.applicationinsights.io، فستحتاج إلى استخدام نقطة نهاية محلية لمنطقتك.

المنطقة	اسم نقطة النهاية	القيمة‬
Azure الصين:	واجهة برمجة تطبيقات REST	api.applicationinsights.azure.cn
Azure Government	واجهة برمجة تطبيقات REST	api.applicationinsights.us

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

• استخدم البحث التشخيصي.
• استكشاف المقاييس.
• كتابة استعلامات Log Analytics.
• لمعرفة المزيد حول التعديلات المخصصة ل Azure Government، راجع الإرشادات التفصيلية لمراقبة Azure وإدارتها.
• لمعرفة المزيد حول Azure China، راجع دليل مبادئ Azure China.