مشاركة عبر

سلاسل الاتصال في Application Insights

  • مقالة

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

هام

تحتوي سلسلة الاتصال على ikey وهو معرف فريد تستخدمه خدمة الاستيعاب لإقران بيانات تتبع الاستخدام بمورد Application Insights معين. المعرفات الفريدة ل Ikey ليست رموز أمان مميزة أو مفاتيح أمان، ولا تعتبر أسرارا.

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

إشعار

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

قدرات سلسلة الاتصال

  • Reliability: تجعل سلاسل الاتصال استيعاب بيانات تتبع الاستخدام أكثر موثوقية عن طريق إزالة التبعيات على نقاط نهاية الاستيعاب العمومية.
  • الأمان: تسمح سلاسل الاتصال باستيعاب بيانات تتبع الاستخدام المصادق عليه باستخدام مصادقة Microsoft Entra ل Application Insights.
  • نقاط النهاية المخصصة (البيئات السحابية السيادية أو المختلطة): تسمح إعدادات نقطة النهاية بإرسال البيانات إلى منطقة Azure Government معينة. (راجع الأمثلة.)
  • الخصوصية (نقاط النهاية الإقليمية): تسهل سلاسل الاتصال مخاوف الخصوصية من خلال إرسال البيانات إلى نقاط النهاية الإقليمية، مع ضمان عدم مغادرة البيانات لمنطقة جغرافية.

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

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

لقطة شاشة تعرض نظرة عامة حول Application Insights وسلسلة الاتصال.

مخطط

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

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

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

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

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

تلميح

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

بناء الجملة

  • 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

لمزيد من المعلومات، راجع المناطق التي تتطلب تعديل نقطة النهاية.

بادئات صالحة

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

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

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

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

في هذا المثال، يحدد سلسلة الاتصال لاحقة نقطة النهاية وSDK تنشئ نقاط نهاية الخدمة:

  • مخطط التفويض الافتراضي إلى "ikey"
  • مفتاح الأجهزة: 00000000-0000-0000-0000-000000000000
  • تستند معرفات الموارد الموحدة للخدمة الإقليمية (URIs) إلى لاحقة نقطة النهاية المتوفرة:
    • الابتلاع: 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

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

تدعم جميع عروض OpenTelemetry وإصدارات SDK التالية سلسلة الاتصال:

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

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

متغير البيئة

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

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

اللغة واجهة برمجة التطبيقات الكلاسيكية التتبع المفتوح
ASP.NET Core Application Insights SDK AzMon OTel Distro
.NET Framework Application Insights SDK مصدر AzMon
Java غير متاح عامل Java
JavaScript JavaScript (Web) SDK Loader Script غير متاح
Node.js Application Insights SDK AzMon OTel Distro
Python OpenCensus Python SDK AzMon OTel Distro

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

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

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

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

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

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

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

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

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