دليل قراءة متعدد اللغات للمهارة
applicationinsights-web-tsالغرض والاستخدام والمصدر
أداةbrowser/webالتطبيقات المزودة بحزمة تطوير البرامج (SDK) الخاصة بـ Application Insights JavaScript (@microsoft/applicationinsights-webيُستخدم لمراقبة تجربة المستخدم الحقيقية (RUM) - عدد مرات مشاهدة الصفحة، والنقرات،AJAX/fetchيتناول هذا الدليل التبعيات والاستثناءات والأحداث المخصصة وآثار وكيل GenAI من جانب المتصفح المرتبطة بآثار OpenTelemetry من جانب الخادم. ويشمل ذلك إعداد برنامج تحميل SDK وإعداد npm، وامتدادات الإطار (React وReact Native وAngular)، وتحليلات النقرات، ومُهيئات القياس عن بُعد، والاتفاقيات الدلالية لـ OTel GenAI.agent/tool/modelالصفحات المنبعثة من المتصفح.
تم استرجاع المصدر:
- مستودع المصدر
- microsoft/skills
- SKILL.md
.github/plugins/azure-sdk-typescript/skills/applicationinsights-web-ts/SKILL.md- نجوم المستودع
- 3,157
- آخر تحديث للمستودع
- 2026-10-31
- تصنيف القدرات
- خدمات الحوسبة السحابية
- وقت التجميع الأخير
الترخيص: MIT
مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.
تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.
ما تفعله هذه المهارة
أداةbrowser/webالتطبيقات المزودة بحزمة تطوير البرامج (SDK) الخاصة بـ Application Insights JavaScript (@microsoft/applicationinsights-webيُستخدم لمراقبة تجربة المستخدم الحقيقية (RUM) - عدد مرات مشاهدة الصفحة، والنقرات،AJAX/fetchيتناول هذا الدليل التبعيات والاستثناءات والأحداث المخصصة وآثار وكيل GenAI من جانب المتصفح المرتبطة بآثار OpenTelemetry من جانب الخادم. ويشمل ذلك إعداد برنامج تحميل SDK وإعداد npm، وامتدادات الإطار (React وReact Native وAngular)، وتحليلات النقرات، ومُهيئات القياس عن بُعد، والاتفاقيات الدلالية لـ OTel GenAI.agent/tool/modelالصفحات المنبعثة من المتصفح.
طريقة الاستخدام وفق المستند الأصلي
البدء السريع (npm)
يتصلloadAppInsights()مرة واحدة بالضبط، في أقرب وقت ممكن (قبل تفاعلات المستخدم التي تريد تتبعها). ثمtrackPageView()بالنسبة للحمل الأولي — عندماenableAutoRouteTrackingعند تشغيل هذه الخاصية، ستكون تغييرات المسار اللاحقة تلقائية.
دليل البدء السريع (برنامج تحميل حزمة تطوير البرامج)
يُنصح به عندما تريد حزمة تطوير برمجية (SDK) تُحدَّث تلقائيًا وبدون مسار بناء. الصق هذا كأول سطر in : Loader-only API (queued until SDK loads): تتبع الحدث, صفحة التتبع, استثناء التتبع, تتبع المسار, بيانات التبعية المتعقبة, تراك ميتريك, تتبع أداء عرض الصفحة, صفحة بدء التتبع, صفحة إيقاف التتبع, بدء حدث المسار, حدث إيقاف المسار, إضافة مُهيئ القياس عن بُعد, setAuthenticatedUserContext, clearAuthenticatedUserContext, flush.
حزمة تطوير البرامج (SDK) لـ JavaScript الخاصة بتطبيقات رؤى التطبيقات (الويب) لـ TypeScript
مراقبة المستخدم الحقيقي (RUM) لتطبيقات المتصفح مع@microsoft/applicationinsights-webيقوم تلقائيًا بجمع مشاهدات الصفحة،AJAX/fetchالتبعيات، والاستثناءات غير المعالجة، والنقرات (مع إضافة Click Analytics). يدعم الأحداث المخصصة، والمقاييس، وتتبعات وكيل GenAI التي تتبع اصطلاحات OpenTelemetry GenAI الدلالية وترتبط بنطاقات الواجهة الخلفية عبر W3سياق التتبع C. > يختلف عنazure-monitor-opentelemetry-ts، وهو لـNode.jsتطبيقات الخادم. هذه المهارة مخصصة لـbrowser/webالكود (و React Native).
المتطلبات والإعداد
تثبيت
يتم شحن نماذج الكتابة مع الحزمة - لا توجد نماذج منفصلة@types/...يلزم التثبيت.
npm i --save @microsoft/applicationinsights-web
# Optional plugins (install only what you use):
npm i --save @microsoft/applicationinsights-clickanalytics-js
npm i --save @microsoft/applicationinsights-react-js @microsoft/applicationinsights-react-native @microsoft/applicationinsights-angularplugin-jsالحدود وفحوصات الجودة
الأخطاء الشائعة
لا تقم بتهيئة الوحدة مرتين. إعادة استيراد الوحدة ضمن حزم مختلفة ينتج عنها عرض صفحات مكررة. استخدم تصدير وحدة مشتركة واحدة. قم بالتهيئة قبل إدخال المستخدم الأول لتجنب فقدان البيانات في المراحل المبكرة.clicks/exceptions.
مقتطف من المصدر · L412 ↗ابدأ بتجربة آمنة
- تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
- زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
- جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
- تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.
اقرأ المزيد في المصدر
- حزمة تطوير البرامج (SDK) لـ JavaScript الخاصة بتطبيقات رؤى التطبيقات (الويب) لـ TypeScript
- قبل التنفيذ
- تثبيت
- سلسلة الاتصال
- البدء السريع (npm)
- دليل البدء السريع (برنامج تحميل حزمة تطوير البرامج)
- مُهيئات القياس عن بُعد (الإثراء والتصفية)
- انقر على تحليلات
- تتبع مسار المنتجع الصحي
- التتبع الموزع (يرتبط بالخادم الخلفي)
- آثار وكلاء الذكاء الاصطناعي العام (الاتفاقيات الدلالية لـ Otel)
- مفاتيح السمات المطلوبة (استخدم أسماء OTel حرفيًا)
- النمط: استدعاء الوكيل + متداخلtool/modelيمتد
- React (TypeScript)
- الأداء - مؤشرات الأداء الرئيسية للويب
- ملفات تعريف الارتباط والخصوصية
- أخذ العينات
- غير متصل بالإنترنت / إرسال عند التفريغ
- الأخطاء الشائعة
- حجم الحزمة
- أفضل الممارسات
- مراجع
المهارات ذات الصلة
الترجمة والنطاق
يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.
تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.
- المصدر بإصدار ثابت
- اقرأ الأصل ↗
- تم استرجاع المصدر
- معرّف نسخة Git
00d66a64919edca5bca2c673373444e36a4b5461- المصدر SHA-256
05ec3512a9d20bbc1e63aebc1e721ecfc26be2c0332e3e9affb6e6975e3f657d