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

azure-monitor-opentelemetry-ts

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

Ajouter la télémétrie Azure Monitor aux applications Node.js

Les équipes applicatives ont besoin d'observabilité pour le débogage en production et la surveillance des performances. Cette compétence fournit un guide complet pour instrumenter les applications TypeScript et JavaScript avec Azure Monitor en utilisant les standards OpenTelemetry.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "azure-monitor-opentelemetry-ts". Ajouter Azure Monitor OpenTelemetry à mon application Express

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

Installez le package avec npm install @azure/monitor-opentelemetry, puis importez et appelez useAzureMonitor avec votre chaîne de connexion avant d'importer Express. Le SDK instrumentera automatiquement les requêtes HTTP, les appels de base de données et les opérations Azure SDK.

استخدام "azure-monitor-opentelemetry-ts". Créer un span personnalisé pour mon opération de base de données

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

Utilisez trace.getTracer pour obtenir un tracer, appelez startSpan avec le nom de l'opération, définissez des attributs comme le type de base de données et la requête, ajoutez des événements pour les étapes de traitement, enregistrez les exceptions en cas d'erreur, et appelez end dans un bloc 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)
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)
🌐 الوصول إلى الشبكة (1)
تم تدقيقه بواسطة: claude

درجة الجودة

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

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

Surveillance d'application en production

Configurer une télémétrie complète pour une API Node.js en production afin de suivre les latences de requêtes, les taux d'erreur et les dépendances.

Suivi distribué de microservices

Activer la visibilité de trace de bout en bout entre les microservices en utilisant la propagation de contexte standard OpenTelemetry.

Métriques métier personnalisées

Suivre des métriques spécifiques à l'application comme les actions utilisateur, l'utilisation des fonctionnalités et les KPI métier parallèlement à la télémétrie standard.

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

Configuration de base de l'auto-instrumentation
Aidez-moi à ajouter Azure Monitor OpenTelemetry à mon application Express.js avec la configuration par défaut.
Configuration de trace personnalisée
Montrez-moi comment configurer Azure Monitor OpenTelemetry avec un échantillonnage personnalisé, un stockage hors ligne et des options d'instrumentation spécifiques pour mon application de production.
Création manuelle de spans
Je dois suivre une opération spécifique avec des spans personnalisés, des attributs et des événements. Montrez-moi comment créer des traces manuelles avec une gestion d'erreur appropriée.
Métriques et processeurs personnalisés
Aidez-moi à configurer des métriques personnalisées avec un fournisseur de métriques, créer un processeur de spans de filtrage et configurer l'exportateur de logs pour mon application.

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

  • Appelez useAzureMonitor avant d'importer tout autre module pour assurer une auto-instrumentation appropriée
  • Stockez les chaînes de connexion dans des variables d'environnement, jamais dans le code source
  • Implémentez un arrêt gracieux avec shutdownAzureMonitor pour vider la télémétrie en attente

تجنب

  • N'oubliez pas d'appeler shutdownAzureMonitor à la fin de l'application - la télémétrie sera perdue
  • Évitez de définir le ratio d'échantillonnage à 0 en production - vous perdrez toutes les données de télémétrie
  • N'initialisez pas useAzureMonitor plusieurs fois - cela provoque des conflits de ressources

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

Quelle est la version minimale de Node.js requise ?
Node.js 18.19.0 ou version ultérieure est requis pour la prise en charge du chargeur ESM. Pour CommonJS, Node.js 14+ est pris en charge.
Dois-je installer des exportateurs séparément ?
Non, @azure/monitor-opentelemetry inclut les exportateurs. Installez @azure/monitor-opentelemetry-exporter séparément uniquement pour des configurations personnalisées de bas niveau.
Comment activer le chargeur ESM ?
Exécutez votre application avec node --import @azure/monitor-opentelemetry/loader ou ajoutez l'import à vos scripts package.json.
Puis-je filtrer les traces envoyées à Azure Monitor ?
Oui, utilisez des processeurs de spans personnalisés avec onEnd pour filtrer ou modifier les spans, ou configurez l'option samplingRatio.
Comment ajouter des dimensions personnalisées à toute la télémétrie ?
Utilisez la méthode onEnd d'un processeur de spans personnalisé pour ajouter des attributs aux spans, ou utilisez resourceFromAttributes lors de la configuration du SDK.
Que se passe-t-il si Azure Monitor est indisponible ?
Activez le stockage hors ligne avec l'option storageDirectory pour mettre en tampon la télémétrie localement et réessayer plus tard.

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

بنية الملفات

📄 SKILL.md