المهارات azure-monitor-opentelemetry-ts
📦

azure-monitor-opentelemetry-ts

آمن 🔑 متغيرات البيئة🌐 الوصول إلى الشبكة

إضافة قياس عن بُعد Azure Monitor إلى تطبيقات Node.js

تحتاج فرق التطبيقات إلى إمكانية المراقبة لتصحيح الأخطاء في الإنتاج ومراقبة الأداء. يوفر هذا الدليل الكامل لتطبيقات TypeScript و JavaScript مع Azure Monitor باستخدام معايير OpenTelemetry.

يدعم: Claude Codex Code(CC)
🥉 74 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "azure-monitor-opentelemetry-ts". Add Azure Monitor OpenTelemetry to my Express app

النتيجة المتوقعة:

قم بتثبيت الحزمة باستخدام npm install @azure/monitor-opentelemetry، ثم استدع useAzureMonitor بسلسلة الاتصال الخاصة بك قبل استيراد Express. سيقوم SDK تلقائيًا بأدوات طلبات HTTP واستدعاءات عمليات Azure.

استخدام "azure-monitor-opentelemetry-ts". Create a custom span for my database operation

النتيجة المتوقعة:

استخدم trace.getTracer للحصول على أداة التتبع، واستدع startSpan مع اسم العملية، وعيّن سمات مثل نوع قاعدة البيانات والاستعلام، وأضف أحداثًا لمراحل المعالجة، وسجل الاستثناءات عند الأخطاء، واستدع end في كتلة finally.

التدقيق الأمني

آمن
v1 • 2/25/2026

All static analysis findings are false positives. The scanner analyzed SKILL.md documentation as executable code. The skill provides legitimate Azure Monitor OpenTelemetry instrumentation guidance with standard environment variable configuration and documented network endpoints for telemetry export.

1
الملفات التي تم فحصها
325
الأسطر التي تم تحليلها
3
النتائج
1
إجمالي عمليات التدقيق
مشكلات منخفضة المخاطر (1)
SKILL.md:1-325
Documentation Scanned as Code
Static analyzer flagged SKILL.md documentation examples as security issues. All findings are false positives - the file contains TypeScript code examples and bash commands for documentation purposes only.

عوامل الخطر

🔑 متغيرات البيئة (5)
SKILL.md:41 SKILL.md:73 SKILL.md:159 SKILL.md:177 SKILL.md:195
🌐 الوصول إلى الشبكة (1)
SKILL.md:210
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

مراقبة تطبيقات الإنتاج

إعداد قياس عن بُعد شامل لواجهة برمجة تطبيقات Node.js في الإنتاج لتتبع زمن الاستجابة ومعدلات الأخطاء والتبعيات.

تتبع الخدمات المصغرة الموزعة

تمكين رؤية التتبع الشامل عبر الخدمات المصغرة باستخدام انتشار السياق القياسي من OpenTelemetry.

مقاييس الأعمال المخصصة

تتبع مقاييس محددة للتطبيق مثل إجراءات المستخدم واستخدام الميزات ومؤشرات الأداء الرئيسية جنبًا إلى جنب مع قياس عن بُعد القياسي.

جرّب هذه الموجهات

إعداد الأدوات التلقائية الأساسي 
ساعدني في إضافة Azure Monitor OpenTelemetry إلى تطبيق Express.js الخاص بي بالتكوين الافتراضي.
تكوين التتبع المخصص 
أظهر لي كيفية تكوين Azure Monitor OpenTelemetry مع أخذ العينات المخصص والتخزين غير المتصل وخيارات الأدوات المحددة لتطبيقي في الإنتاج.
إنشاء النطاق اليدوي 
أحتاج إلى تتبع عملية محددة بنطاقات وسمات وأحداث مخصصة. أرني كيفية إنشاء عمليات تتبع يدوية مع معالجة الأخطاء المناسبة.
المقاييس والمعالجات المخصصة 
ساعدني في إعداد مقاييس مخصصة مع مزود المقاييس، وإنشاء معالج نطاق للتصميم، وتكوين مُصدري السجلات لتطبيقي.

أفضل الممارسات

  • استدع useAzureMonitor قبل استيراد أي وحدات أخرى لضمان الأدوات التلقائية الصحيحة
  • قم بتخزين سلاسل الاتصال في متغيرات البيئة، أبدًا في الكود المصدري
  • قم بتنفيذ الإيقاف الصحيح باستخدام shutdownAzureMonitor لقياس عن بُعد معلق

تجنب

  • لا تتخطى استدعاء shutdownAzureMonitor عند خروج التطبيق - سيتم فقدان قياس عن بُعد
  • تجنب تعيين نسبة أخذ العينات إلى 0 في الإنتاج - ستخسر جميع بيانات قياس عن بُعد
  • لا تقم بتهيئة useAzureMonitor عدة مرات - يسبب تعارضات في الموارد

الأسئلة المتكررة

ما هو الحد الأدنى لإصدار Node.js المطلوب؟
مطلوب Node.js 19 أو أحدث لدعم ESM loader. بالنسبة لـ CommonJS، يتم دعم Node.js 14+.
هل أحتاج إلى تثبيت مُصدرين منفصلين؟
لا، يتضمن @azure/monitor-opentelemetry المُصدرين. قم بتثبيت @azure/monitor-opentelemetry-exporter بشكل منفصل فقط للإعدادات منخفضة المستوى المخصصة.
كيف أتفعّل ESM loader؟
قم بتشغيل التطبيق الخاص بك باستخدام node --import @azure/monitor-opentelemetry/loader أو أضف الاستيراد إلى ملفات package.json النصية.
هل يمكنني تصفية أي عمليات تتبع تُرسل إلى Azure Monitor؟
نعم، استخدم معالجات النطاقات المخصصة مع onEnd للتصفية أو تعديل النطاقات، أو خيارات تكوين samplingRatio.
كيف أضيف أبعاد مخصصة لجميع قياس عن بُعد؟
استخدم طريقة onEnd لمعالج النطاقات المخصص لإضافة سمات إلى النطاقات، أو resourceFromAttributes عند تكوين SDK.
ماذا يحدث إذا كان Azure Monitor غير متوفر؟
تفعّل التخزين غير المتصل مع خيار storageDirectory لتخزين قياس عن بُعد مؤقتًامحليًا وإعادة المحاولة لاحقًا.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-monitor-opentelemetry-ts

مرجع

main

بنية الملفات

📄 SKILL.md