AIKraft/AI/Войти
AIKraft/Skills/Лучшие практики логирования

Лучшие практики логирования

Logging best practices for applications and services including structured logging, log levels, and log management strategies

mindrally official Другое

Что делает навык

Набор принципов логирования для обеспечения эффективного отладки, мониторинга и аудита в приложениях и сервисах. Включает правила структурирования логов, управления уровнями, безопасности и агрегации данных.

Когда применять

  • Настройка структурированного логирования (JSON) для всех выходных данных приложения
  • Определение и применение корректных уровней логов (DEBUG, INFO, WARN, ERROR, FATAL) в зависимости от контекста
  • Обеспечение безопасности логов путем маскирования чувствительных данных и PII
  • Настройка конфигурации логирования для различных сред (Development, Staging, Production)
  • Агрегация логов из всех сервисов в единую платформу с поддержкой поиска и алертинга

Как работает

  1. Использовать библиотеку логирования, поддерживающую нативный вывод в формате JSON, избегая конкатенации строк
  2. Включать в каждую запись стандартные поля: timestamp (ISO 8601), level, message, service, version, trace_id, span_id, request_id
  3. Применять контекст запроса (MDC или аналог), пропугировать trace IDs через границы сервисов и добавлять анонимизированный контекст пользователя
  4. Выбирать уровни логирования согласно правилам: DEBUG для разработки, INFO для штатных событий, WARN для обработанных аномалий, ERROR для сбоев операции, FATAL для критических сбоев
  5. Использовать асинхронное логирование, сэмплирование для DEBUG-логов в продакшене и буферизацию для балансировки задержки и пропускной способности
  6. Настроить централизованную агрегацию логов с ротацией, политиками хранения, полным текстовым поиском и алертами на критические паттерны

Примеры запросов агенту

Настрой логирование в моем сервисе так, чтобы все сообщения были в формате JSON и включали trace_id и request_id.
Какие поля обязательно должны быть в каждой записи лога согласно лучшим практикам?
Как правильно настроить уровни логирования для продакшн-окружения, чтобы не перегружать систему?

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «logging-best-practices» из репозитория: # https://github.com/mindrally/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r logging-best-practices/ ~/.claude/skills/logging-best-practices/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.