技能 structured-logging
📋

structured-logging

安全 🌐 网络访问📁 文件系统访问⚙️ 外部命令🔑 环境变量

Внедрение структурированного JSON-логирования

也可从以下获取: Chemiseblanc

Традиционные логи в консоли трудно искать и парсить. Этот навык предоставляет паттерны и примеры кода для внедрения JSON-структурированного логирования, которое обеспечивает мощную фильтрацию, агрегацию и наблюдаемость во всех ваших сервисах.

支持: Claude Codex Code(CC)
📊 69 充足
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“structured-logging”。 Set up structured logging for my Node.js API

预期结果:

  • Create logger.ts with Pino configured for JSON output
  • Add environment-based log level (info for production, debug for development)
  • Include base fields: service name, environment, requestId
  • Use pino-pretty transport for development readability
  • Configure redact option for sensitive fields

正在使用“structured-logging”。 How do I trace a user request through multiple services?

预期结果:

  • Generate unique requestId at API entry point using crypto.randomUUID()
  • Propagate requestId via AsyncLocalStorage across all async operations
  • Include requestId in every log entry for correlation
  • Set x-request-id header for upstream service communication

安全审计

安全
v5 • 1/17/2026

This is a documentation-only skill containing logging best practices and code examples. All code is illustrative, demonstrating legitimate patterns like Pino/Winston configuration, AsyncLocalStorage context propagation, and sensitive data redaction. No executable code, no network calls, no credential access patterns. The static scanner flagged generic patterns in documentation examples that are false positives.

2
已扫描文件
632
分析行数
4
发现项
5
审计总数
审计者: claude 查看审计历史 →

质量评分

38
架构
100
可维护性
85
内容
20
社区
100
安全
91
规范符合性

你能构建什么

Настройка логирования в production

Настройте структурированное логирование для production-сервисов с Pino или Winston для лучшей отладки и наблюдаемости.

Пайплайн агрегации логов

Настройте отправку логов в ELK Stack или Datadog с корректным распространением контекста трассировки.

Отслеживание API-запросов

Реализуйте middleware для request ID и контекстно-ориентированное логирование, чтобы трассировать запросы между микросервисами.

试试这些提示

Базовая настройка логгера
Set up Pino logger with environment-based log level, service name, and development pretty-print mode.
Распространение контекста
Create AsyncLocalStorage context to propagate requestId and userId across all async operations.
Редактирование чувствительных данных
Configure Pino redact option to mask passwords, tokens, API keys, and credit card numbers.
Агрегация логов
Create Winston transport that sends JSON logs to Elasticsearch for the ELK Stack.

最佳实践

  • Всегда используйте временные метки ISO 8601 для единообразного парсинга логов в разных системах
  • Включайте requestId во все логи, чтобы обеспечить распределённую трассировку между сервисами
  • Никогда не логируйте чувствительные данные, такие как пароли, токены или номера кредитных карт

避免

  • Логирование неструктурированных строк со строковой интерполяцией вместо JSON-объектов
  • Включение чувствительных учетных данных или персональной информации в вывод логов
  • Чрезмерное debug-логирование в production, вызывающее проблемы производительности и разрастание логов

常见问题

Какую библиотеку логирования мне выбрать?
Pino рекомендуется для новых проектов благодаря минимальным накладным расходам и отличной производительности.
Какой уровень логирования использовать в production?
Используйте уровень info в production, чтобы уменьшить шум. Включайте debug или trace только при устранении неполадок.
Как добавить контекст во все записи логов?
Используйте AsyncLocalStorage для хранения requestId и userId. Создайте обёртку логгера, которая включает контекст.
Безопасны ли мои чувствительные данные в логах?
Настройте редактирование чувствительных полей с помощью опции Pino redact или кастомной санации.
Почему мои логи не появляются в ELK?
Убедитесь в JSON-формате вывода, проверьте, что Filebeat может парсить ваш формат, проверьте подключение к Elasticsearch.
Чем это отличается от console.log?
Структурированное логирование дает доступный для поиска JSON-вывод, в отличие от console.log. Это позволяет агрегацию и алертинг.

开发者详情

文件结构

📄 SKILL.md