Compétences distributed-debugging-debug-trace
🔍

distributed-debugging-debug-trace

Risque faible ⚡ Contient des scripts🌐 Accès réseau

デバッグと分散トレーシングの設定

複雑なマルチサービスシステムのデバッグに苦労していませんか？このスキルは、包括的なデバッグ環境、分散トレーシング、および診断ツールをセットアップし、インフラストラクチャ全体で問題を迅速に特定して解決できるようにします。

Prend en charge: Claude Codex Code(CC)
📊 71 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "distributed-debugging-debug-trace". Express API 用にデバッグを設定する

Résultat attendu:

  • Node.js デバッグ設定で .vscode/launch.json を作成
  • --enable-source-maps フラグでソースマップサポートを追加
  • DEBUG および NODE_ENV の環境変数を設定
  • skipFiles を設定して node_modules からのステップ実行を除外
  • フルスタックデバッグ用のコンパウンド設定を追加

Utilisation de "distributed-debugging-debug-trace". OpenTelemetry を使用した分散トレースを実装

Résultat attendu:

  • Jaeger エクスポーターで NodeSDK を初期化
  • HTTP および Express の自動計装を設定
  • トレースコンテキスト伝播付きのカスタムスパンミドルウェアを追加
  • サービス識別用のリソース属性を設定
  • スパンフラッシュによるグレースフルシャットダウンを実装

Audit de sécurité

Risque faible
v1 • 2/24/2026

Static analysis flagged 183 patterns, but most are false positives. JavaScript template literals were misidentified as Ruby shell execution (52 findings). Environment variable access (62 findings) is standard Node.js configuration practice. One legitimate medium-severity finding: innerHTML usage in debug dashboard example code could enable XSS if WebSocket data is untrusted. Skill provides legitimate debugging and observability patterns.

2
Fichiers analysés
1,355
Lignes analysées
3
résultats
1
Total des audits
Problèmes à risque moyen (1)
resources/implementation-playbook.md:1183resources/implementation-playbook.md:1195-1200resources/implementation-playbook.md:1207-1212
Potential XSS via innerHTML
Debug dashboard example code uses innerHTML to render WebSocket data without sanitization. While this is documentation example code, users implementing this pattern should sanitize untrusted data.

Facteurs de risque

⚡ Contient des scripts (3)
resources/implementation-playbook.md:1183 resources/implementation-playbook.md:1195 resources/implementation-playbook.md:1208
🌐 Accès réseau (3)
resources/implementation-playbook.md:294 resources/implementation-playbook.md:315 resources/implementation-playbook.md:1163
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
85
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

マルチサービスデバッグ設定

サービス境界を越えたトレース相関を含む、マイクロサービスアーキテクチャのエンドツーエンドデバッグを設定。

本番環境の問題診断

サンプリング、認証、機密データのレッドアクションを含む、安全な本番環境デバッグ機能を確立。

パフォーマンス最適化

パフォーマンスクリティカルなアプリケーション向けに、CPU プロファイリング、ヒープスナップショット、メモリリーク検出を実装。

Essayez ces prompts

基本デバッグ設定 
ソースマップと環境変数を備えた Node.js アプリケーション用に VS Code デバッグを設定してください。
分散トレース実装 
Jaeger をバックエンドとして Express マイクロサービス用に OpenTelemetry トレースを設定してください。スパンコンテキストの伝播とカスタムスパン属性を含めてください。
本番環境デバッグダッシュボード 
メモリ使用量、アクティブなトレース、構造化ログを表示する本番環境対応のデバッグダッシュボードを作成してください。認証と IP ホワイトリストを含めてください。
メモリリークの調査 
Node.js サービスのメモリリークを調査するのを手伝ってください。ヒープスナップショットの自動化、メモリ傾向の監視、アラート閾値を設定してください。

Bonnes pratiques

  • パフォーマンスオーバーヘッドとストレージコストを回避するために、本番環境では常にトレースをサンプリングする
  • API キー、トークン、PII などの機密データを、すべてのログおよびトレース属性から削除する
  • 検索可能性と分析を向上させるために、一貫したフィールド名で構造化ログを使用する

Éviter

  • レート制限なしに本番環境で冗長なデバッグログを有効にする
  • 認証やネットワーク制限なしにリモートデバッグポートを公開する
  • サニタイズなしにデバッグダッシュボードで信頼できないデータと共に innerHTML を使用する

Foire aux questions

本番環境でリモートデバッグは安全ですか？
リモートデバッグは、厳格な認証、IP ホワイトリスト、短いタイムアウトウィンドウでのみ有効にするべきです。常にオン状態のデバッグサーバーではなく、特定のイベントによってトリガーされるエフェメラルデバッグセッションの使用を検討してください。
機密データがトレースに表示されないようにするにはどうすればよいですか？
スパン属性フィルターを使用してシークレットを含むフィールドを除外します。既知の機密パターンを削除するようにロガーを設定します。自動計装フックをレビューして、認証情報を含むリクエストボディを取得しないようにしてください。
本番環境のトレーシングにはどのサンプリングレートを使用すべきですか？
高トラフィックサービスでは 1〜10% のサンプリングから開始します。低トラフィックサービスまたはインシデント調査中は 100% に増やします。サービス間で一貫したトレース収集のために、ヘッドベースサンプリングを使用してください。
このスキルを Node.js 以外のアプリケーションで使用できますか？
中核的な概念はどの言語にも適用されます。OpenTelemetry には Python、Go、Java などの言語用 SDK があります。同じトレーシング原則に従いながら、技術スタックに合わせて設定パターンを適用してください。
ログとトレースを相関させるにはどうすればよいですか？
トレース ID とスパン ID をログコンテキストに注入します。ほとんどのトレーシングライブラリは、これらの ID をリクエストコンテキストに自動的に追加するミドルウェアを提供します。各ログエントリに対して、ロガーがこのコンテキストから読み取ることを確認してください。
分散トレーシングのパフォーマンスへの影響はどの程度ですか？
適切に設定されたトレーシングは 1〜5% のオーバーヘッドを追加します。バッチスパンプロセッサーを使用し、サンプリングレートを調整し、スパン属性で大きなペイロードの取得を避けてください。実際の影響を測定するために、特定のアプリケーションをプロファイリングしてください。

Détails du développeur

Auteur

sickn33

Licence

MIT

Dépôt

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/distributed-debugging-debug-trace

Réf

main

Structure de fichiers

📁 resources/

📄 implementation-playbook.md

📄 SKILL.md