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

توضح هذه المقالة كيفية استخدام سلاسل الاتصال.

نظرة عامة

إشعار

تعتمد الوثائق التالية على واجهة برمجة تطبيقات Application Insights الكلاسيكية. الخطة طويلة الأجل ل Application Insights هي جمع البيانات باستخدام OpenTelemetry. لمزيد من المعلومات، راجع تمكين Azure Monitor OpenTelemetry لتطبيقات .NET Node.js وPython وJava.

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

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

إشعار

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

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

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

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

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

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

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

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

راجع الأقسام التالية للبدء.

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

يتم إظهار سلسلة الاتصال الخاصة بك على قسم نظرة عامة لمورد Application Insights.

مخطط

تحتوي المقاطع التالية على شرح لعناصر المخطط.

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

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

أزواج مفتاح-قيمة

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

بناء الجملة

• InstrumentationKey (على سبيل المثال، 00000000-0000-0000-0000-000000000000). InstrumentationKeyهو حقل مطلوب.
• 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

هل سلسلة الاتصال سرية؟

تحتوي سلسلة الاتصال على ikey وهو معرف فريد تستخدمه خدمة الاستيعاب لإقران بيانات تتبع الاستخدام بمورد Application Insights معين. هذه المعرفات الفريدة ل ikey ليست رموز أمان مميزة أو مفاتيح أمان. إذا كنت ترغب في حماية مورد الذكاء الاصطناعي الخاص بك من إساءة الاستخدام، توفر نقطة نهاية الاستيعاب خيارات استيعاب بيانات تتبع الاستخدام المصادق عليها استنادا إلى معرف Microsoft Entra.

إشعار

يتطلب Application Insights JavaScript SDK تمرير سلسلة الاتصال أثناء البدء والتكوين. يمكن عرض هذا في نص عادي في مستعرضات العميل. لا توجد طريقة سهلة لاستخدام المصادقة المستندة إلى معرف Microsoft Entra لبيانات تتبع استخدام المستعرض. نوصيك بالتفكير في إنشاء مورد Application Insights منفصل للقياس عن بعد بالمتصفح إذا كانوا بحاجة إلى تأمين تتبع الخدمة عن بُعد.

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

فيما يلي بعض الأمثلة على سلاسل الاتصال.

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

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 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 5.0+

1. تعيين سلسلة الاتصال في appsettings.json الملف:

   {
     "ApplicationInsights": {
       "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
       }
   }
   

2. استرداد سلسلة الاتصال عند Program.cs تسجيل ApplicationInsightsTelemetry الخدمة:

   var options = new ApplicationInsightsServiceOptions { ConnectionString = app.Configuration["ApplicationInsights:ConnectionString"] };
   builder.Services.AddApplicationInsightsTelemetry(options: options);
   

.NET Framework

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

تعيين سلسلة الاتصال بشكل صريح في التعليمات البرمجية:

var configuration = new TelemetryConfiguration
{
    ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
};

تعيين سلسلة الاتصال باستخدام ملف تكوين:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/</ConnectionString>
</ApplicationInsights>

Java

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

{
  "connectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
}

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

جافا سكريبت

لا يدعم JavaScript استخدام متغيرات البيئة. لديك خياران:

• لاستخدام برنامج JavaScript (Web) SDK Loader Script، راجع برنامج JavaScript (Web) SDK Loader Script.
• الإعداد اليدوي:

  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;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/");
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;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/'), sampler=ProbabilitySampler(1.0))

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

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

هل تتطلب مناطق Azure الجديدة استخدام سلاسل الاتصال؟

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

هل يجب أن أستخدم سلاسل الاتصال أو مفاتيح الأجهزة؟

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

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

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

• تطبيقات Azure VM وAzure Virtual Machine Scale Sets المستضافة بواسطة IIS
• خادم IIS
• ميزة تطبيقات الويب في Azure App Service

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

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