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

azure-monitor-opentelemetry-ts

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

Adicionar Telemetria Azure Monitor a Aplicações Node.js

Equipes de aplicação precisam de observabilidade para debugging em produção e monitoramento de performance. Esta skill fornece orientação completa para instrumentar aplicações TypeScript e JavaScript com Azure Monitor usando padrões OpenTelemetry.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "azure-monitor-opentelemetry-ts". Adicionar Azure Monitor OpenTelemetry ao meu app Express

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

Instale o pacote com npm install @azure/monitor-opentelemetry, então importe e chame useAzureMonitor com sua connection string antes de importar Express. O SDK irá automaticamente instrumentar requisições HTTP, chamadas de banco de dados e operações do Azure SDK.

استخدام "azure-monitor-opentelemetry-ts". Criar um span personalizado para minha operação de banco de dados

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

Use trace.getTracer para obter um tracer, chame startSpan com o nome da operação, defina atributos como tipo de banco e query, adicione eventos para estágios de processamento, registre exceções em caso de erros e chame end em um bloco 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
الامتثال للمواصفات

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

Monitoramento de Aplicações em Produção

Configure telemetria abrangente para uma API Node.js em produção para rastrear latências de requisição, taxas de erro e dependências.

Distributed Tracing em Microsserviços

Habilite visibilidade de trace end-to-end através de microsserviços usando propagação de contexto padrão OpenTelemetry.

Métricas Personalizadas de Negócio

Acompanhe métricas específicas da aplicação como ações de usuário, uso de recursos e KPIs de negócio junto com telemetria padrão.

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

Configuração Básica de Auto-Instrumentação
Me ajude a adicionar Azure Monitor OpenTelemetry à minha aplicação Express.js com configuração padrão.
Configuração de Trace Personalizado
Mostre-me como configurar Azure Monitor OpenTelemetry com amostragem personalizada, armazenamento offline e opções específicas de instrumentação para minha aplicação em produção.
Criação Manual de Span
Preciso rastrear uma operação específica com spans personalizados, atributos e eventos. Mostre-me como criar traces manuais com tratamento de erros adequado.
Métricas Personalizadas e Processadores
Me ajude a configurar métricas personalizadas com um meter provider, criar um processador de span de filtragem e configurar o log exporter para minha aplicação.

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

  • Chame useAzureMonitor antes de importar qualquer outro módulo para garantir auto-instrumentação adequada
  • Armazene connection strings em variáveis de ambiente, nunca no código fonte
  • Implemente shutdown gracioso com shutdownAzureMonitor para flush de telemetria pendente

تجنب

  • Não deixe de chamar shutdownAzureMonitor no encerramento da aplicação - telemetria será perdida
  • Evite definir taxa de amostragem como 0 em produção - você perderá todos os dados de telemetria
  • Não inicialize useAzureMonitor múltiplas vezes - isso causa conflitos de recursos

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

Qual é a versão mínima do Node.js necessária?
Node.js 18.19.0 ou posterior é necessário para suporte a ESM loader. Para CommonJS, Node.js 14+ é suportado.
Preciso instalar exporters separados?
Não, @azure/monitor-opentelemetry inclui os exporters. Instale @azure/monitor-opentelemetry-exporter separadamente apenas para configurações customizadas de baixo nível.
Como habilito o ESM loader?
Execute sua aplicação com node --import @azure/monitor-opentelemetry/loader ou adicione o import aos scripts do seu package.json.
Posso filtrar quais traces são enviados ao Azure Monitor?
Sim, use processadores de span personalizados com onEnd para filtrar ou modificar spans, ou configure a opção samplingRatio.
Como adiciono dimensões personalizadas a toda telemetria?
Use o método onEnd de um processador de span personalizado para adicionar atributos aos spans, ou use resourceFromAttributes ao configurar o SDK.
O que acontece se o Azure Monitor estiver indisponível?
Habilite armazenamento offline com a opção storageDirectory para bufferizar telemetria localmente e tentar novamente depois.

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

بنية الملفات

📄 SKILL.md