سلاسل الاتصال

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

نظرة عامة

تحدد سلاسل الاتصال مكان إرسال بيانات القياس عن بعد.

توفر أزواج القيم الرئيسية طريقة سهلة للمستخدمين لتحديد مجموعة لاحقة بادئة لكل خدمة / منتج لتطبيق Application Insights (AI).

ملاحظة

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

هام

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

نظرة عامة على السيناريو

السيناريوهات الأكثر تأثرا بهذا التغيير:

• استثناءات جدار الحماية أو عمليات إعادة توجيه الوكيل

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

• البيئات السحابية السيادية أو الهجينة

  يمكن للمستخدمين إرسال البيانات إلى Azure Government محددة. تتيح لك سلاسل الاتصال تحديد إعدادات نقطة النهاية لخوادم الإنترنت أو إعدادات السحابة المختلطة.

الشروع في العمل

العثور على سلسلة الاتصال الخاصة بي؟

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

المخطط

الحد الأقصى للطول: 1024

يبلغ الحد الأقصى للطول المدعوم للاتصال 4096 حرفًا.

أزواج قيم المفتاح

تتكون سلسلة الاتصال من قائمة الإعدادات الممثلة كأزواج مفتاح-قيمة مفصولة بفاصلة منقوطة: key1=value1;key2=value2;key3=value3

بناء الجملة

• InstrumentationKey (على سبيل المثال: 00000000-0000-0000-0000-000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 سلسلة الاتصال هي حقل مطلوب .
• Authorization (على سبيل المثال: ikey) (هذا الإعداد اختياري لأننا اليوم ندعم فقط تفويض ikey.)
• EndpointSuffix (على سبيل المثال: applicationinsights.azure.cn) سيؤدي تعيين لاحقة نقطة النهاية إلى توجيه SDK الذي تتصل به سحابة Azure. ستقوم SDK بتجميع بقية نقطة النهاية للخدمات الفردية.
• نقاط نهاية صريحة. يمكن تجاوز أي خدمة بشكل واضح في سلسلة الاتصال.
  • IngestionEndpoint (على سبيل المثال: https://dc.applicationinsights.azure.com)
  • LiveEndpoint (على سبيل المثال: https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (على سبيل المثال: https://profiler.monitor.azure.com)
  • SnapshotEndpoint (على سبيل المثال: https://snapshot.monitor.azure.com)

مخطط لنقطة النهاية

<prefix>.<suffix>

• البادئة: تحدد خدمة.
• اللاحقة: تحدد اسم المجال الشائع.

لواحق صالحة

فيما يلي قائمة باللواحق الصالحة

• applicationinsights.azure.cn
• applicationinsights.us

راجع أيضًا: المناطق التي تتطلب تعديل نقطة النهاية

بادئات صالحة

• العرض عن بُعد : dc
• المقاييس المباشرة : live
• منشئ ملف التعريف : profiler
• لقطة : snapshot

أمثلة سلسلة الاتصال

سلسلة الاتصال مع لاحقة نقطة النهاية

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

في هذا المثال، تحدد سلسلة الاتصال لاحقة نقطة النهاية وستقوم SDK بإنشاء نقاط نهاية الخدمة.

• مخطط التفويض الافتراضي إلى "ikey"
• مفتاح الأجهزة: 00000000-0000-0000-0000-000000000000
• تستند معرفات URI للخدمة الإقليمية إلى لاحقة نقطة النهاية المتوفرة:
  • الابتلاع: https://dc.ai.contoso.com
  • المقاييس المباشرة: https://live.ai.contoso.com
  • منشئ ملف التعريف: https://profiler.ai.contoso.com
  • المصحح: https://snapshot.ai.contoso.com

سلسلة الاتصال مع تجاوزات نقطة النهاية الصريحة

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;

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

• مخطط التفويض الافتراضي إلى "ikey"
• مفتاح الأجهزة: 00000000-0000-0000-0000-000000000000
• تعتمد معرّفات URI للخدمة الإقليمية على قيم التجاوز الصريحة:
  • الابتلاع: https://custom.com:111/
  • المقاييس المباشرة: https://custom.com:222/
  • منشئ ملف التعريف: https://custom.com:333/
  • المصحح: https://custom.com:444/

سلسلة اتصال مع منطقة صريحة

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

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

• مخطط التفويض الافتراضي إلى "ikey"
• مفتاح الأجهزة: 00000000-0000-0000-0000-000000000000
• تعتمد معرّفات URI للخدمة الإقليمية على قيم التجاوز الصريحة:
  • الابتلاع: https://southcentralus.in.applicationinsights.azure.com/

قم بتشغيل الأمر التالي في Azure Command-Line Interface (CLI) لسرد المناطق المتوفرة.

az account list-locations -o table

كيفية تعيين سلسلة اتصال

سلاسل الاتصال مدعومة في إصدارات SDK التالية:

• .NET v2.12.0
• Java v2.5.1 و Java 3.0
• جافا سكريبت v2.3.0
• العقدة JS v1.5.0
• بايثون v1.0.0

يمكن تعيين سلسلة الاتصال إما في الكود البرمجي أو متغير البيئة أو ملف التكوين.

متغير البيئة

• سلسلة الاتصال: APPLICATIONINSIGHTS_CONNECTION_STRING

نماذج التعليمات البرمجية

.NET/.NetCore

قم بتعيين الخاصية TelemetryConfiguration.ConnectionString أو ApplicationInsightsServiceOptions.ConnectionString

تعيين NET بشكل صريح:

var configuration = new TelemetryConfiguration
{
    ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
};

ملف تكوين .NET:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000</ConnectionString>
</ApplicationInsights>

.NET Core تعيين صريح:

public void ConfigureServices(IServiceCollection services)
{
    var options = new ApplicationInsightsServiceOptions { ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;" };
    services.AddApplicationInsightsTelemetry(options: options);
}

.NET Core config.json:

{
  "ApplicationInsights": {
    "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
    }
  }

Java

يمكنك إعداد سلسلة الاتصال في ملف التكوين applicationinsights.json:

{
  "connectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000"
}

لمزيد من المعلومات، تكوين سلسلة الاتصال.

بالنسبة إلى Application Insights Java 2.x، يمكنك تعيين سلسلة الاتصال في ملف التكوين ApplicationInsights.xml:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000</ConnectionString>
</ApplicationInsights>

JavaScript

هام: 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
  connectionString:"InstrumentationKey=00000000-0000-0000-0000-000000000000;"
}});
</script>

ملاحظة

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

الإعداد اليدوي:

import { ApplicationInsights } from '@microsoft/applicationinsights-web'

const appInsights = new ApplicationInsights({ config: {
  connectionString: 'InstrumentationKey=00000000-0000-0000-0000-000000000000;'
  /* ...Other Configuration Options... */
} });
appInsights.loadAppInsights();
appInsights.trackPageView();

Node.js

const appInsights = require("applicationinsights");
appInsights.setup("InstrumentationKey=00000000-0000-0000-0000-000000000000;");
appInsights.start();

Python

نوصي المستخدمين بتعيين متغير البيئة.

لتعيين سلسلة الاتصال بشكل واضح:

from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer

tracer = Tracer(exporter=AzureExporter(connection_string='InstrumentationKey=00000000-0000-0000-0000-000000000000'), sampler=ProbabilitySampler(1.0))

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

ابدأ وقت التشغيل باستخدام:

• تعيين مقياس الجهاز الافتراضي لـ Azure VM وAzuer عن طريق التطبيقات المستضافة بواسطة IIS
• خادم IIS
• Azure Web Apps

ابدأ وقت التطوير مع:

• ASP.NET
• ASP.NET Core
• Java
• Node.js
• Python