Навыки distributed-debugging-debug-trace
🔍

distributed-debugging-debug-trace

Низкий риск ⚡ Содержит скрипты🌐 Доступ к сети

Настройка отладки и распределенной трассировки

Сложности с отладкой сложных многокомпонентных систем? Этот навык настраивает комплексные среды отладки, распределенную трассировку и диагностические инструменты, чтобы помочь вам быстро выявлять и устранять проблемы в вашей инфраструктуре.

Поддерживает: Claude Codex Code(CC)
📊 69 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «distributed-debugging-debug-trace». Set up debugging for my Express API

Ожидаемый результат:

  • Создан .vscode/launch.json с конфигурацией отладки Node.js
  • Добавлена поддержка source maps с флагом --enable-source-maps
  • Настроены переменные окружения для DEBUG и NODE_ENV
  • Настроен skipFiles для исключения node_modules из пошаговой отладки
  • Добавлена compound-конфигурация для full-stack отладки

Использование «distributed-debugging-debug-trace». Implement distributed tracing with OpenTelemetry

Ожидаемый результат:

  • Инициализирован NodeSDK с Jaeger exporter
  • Настроены auto-instrumentations для HTTP и Express
  • Добавлено custom span middleware с propagation контекста трассировки
  • Настроены resource attributes для идентификации сервиса
  • Реализовано graceful shutdown с flush spans

Аудит безопасности

Низкий риск
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
Просканировано файлов
1,355
Проанализировано строк
3
находки
1
Всего аудитов
Проблемы среднего риска (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.

Факторы риска

⚡ Содержит скрипты (3)
resources/implementation-playbook.md:1183 resources/implementation-playbook.md:1195 resources/implementation-playbook.md:1208
🌐 Доступ к сети (3)
resources/implementation-playbook.md:294 resources/implementation-playbook.md:315 resources/implementation-playbook.md:1163
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
32
Сообщество
85
Безопасность
91
Соответствие спецификации

Что вы можете построить

Настройка отладки для микросервисов

Настройка сквозной отладки для архитектуры микросервисов с корреляцией трассировки across service boundaries.

Диагностика проблем в Production

Создание безопасных возможностей отладки в production с семплированием, аутентификацией и скрытием конфиденциальных данных.

Оптимизация производительности

Внедрение профилирования CPU, снимков кучи и обнаружения утечек памяти для критичных к производительности приложений.

Попробуйте эти промпты

Базовая конфигурация отладки 
Set up VS Code debugging for my Node.js application with source maps and environment variables.
Реализация распределенной трассировки 
Configure OpenTelemetry tracing for my Express microservices with Jaeger as the backend. Include span context propagation and custom span attributes.
Отладочная панель для Production 
Create a production-safe debug dashboard showing memory usage, active traces, and structured logs. Include authentication and IP allowlisting.
Исследование утечек памяти 
Help me investigate a memory leak in my Node.js service. Set up heap snapshot automation, memory trend monitoring, and alert thresholds.

Лучшие практики

  • Всегда используйте семплирование трассировки в production, чтобы избежать накладных расходов на производительность и затрат на хранение
  • Скрывайте конфиденциальные данные, такие как API-ключи, токены и PII, из всех логов и атрибутов трассировки
  • Используйте структурированное логирование с согласованными именами полей для лучшей поисковой способности и анализа

Избегать

  • Включение подробного debug-логирования в production без ограничения частоты
  • Предоставление доступа к удаленным отладочным портам без аутентификации или сетевых ограничений
  • Использование innerHTML с ненадежными данными в отладочных панелях без санитизации

Часто задаваемые вопросы

Безопасна ли удаленная отладка для production-сред?
Удаленную отладку следует включать только со строгой аутентификацией, белым списком IP-адресов и короткими окнами таймаута. Рассмотрите возможность использования эфемерных сессий отладки, запускаемых определенными событиями, вместо постоянно работающих debug-серверов.
Как предотвратить попадание конфиденциальных данных в трассировки?
Используйте фильтры атрибутов span для исключения полей, содержащих секреты. Настройте ваш логгер на скрытие известных чувствительных паттернов. Проверьте hooks auto-instrumentation, чтобы убедиться, что они не захватывают тела запросов с учетными данными.
Какую частоту семплирования использовать для production-трассировки?
Начните с семплирования 1-10% для высоконагруженных сервисов. Увеличьте до 100% для низконагруженных сервисов или во время расследования инцидентов. Используйте head-based семплирование для консистентного сбора трассировок across services.
Могу ли я использовать этот навык с не-Node.js приложениями?
Основные концепции применимы к любому языку. OpenTelemetry имеет SDK для Python, Go, Java и других языков. Адаптируйте паттерны конфигурации к вашему технологическому стеку, следуя тем же принципам трассировки.
Как коррелировать логи с трассировками?
Внедряйте trace ID и span ID в ваш log context. Большинство библиотек трассировки предоставляют middleware для автоматического добавления этих ID в контекст запроса. Убедитесь, что ваш логгер читает из этого контекста для каждой записи лога.
Каково влияние распределенной трассировки на производительность?
Правильно настроенная трассировка добавляет 1-5% накладных расходов. Используйте batch span processors, настраивайте частоту семплирования и избегайте захвата больших payload в атрибутах span. Профилируйте ваше конкретное приложение для измерения фактического влияния.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

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

Ссылка

main

Структура файлов

📁 resources/

📄 implementation-playbook.md

📄 SKILL.md