bitrix-logger
Используй для PSR-3 логирования в Битриксе: Diag\FileLogger, LoggerFactory, секция loggers и форматы журналов. Передача LoggerInterface сервисам и защита секретов в логах.
How do I install this agent skill?
npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-loggerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive instructions for implementing PSR-3 logging in the Bitrix framework, emphasizing security best practices like avoiding sensitive data in logs and using secure storage paths.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Логирование (PSR-3)
Baseline: main 23.0+ · Verified: main 26.1000.0
Перед PHP-кодом прочитай bitrix-framework, если ещё не читал его в этой задаче.
В таблице выбери только нужный rules/*.md; пути относительны каталогу скилла.
Код зависит от Psr\Log\LoggerInterface; реализация выбирается в секции loggers файла .settings.php. AddMessage2Log() — только для совместимости.
| Задача | Читать |
|---|---|
| Получить/включить логгер, передать в сервис | rules/factory.md |
Секция loggers, фабрики, ID логгеров ядра | rules/configuration.md |
| Выбрать реализацию/формат, записать сообщение, Monolog | rules/writing.md |
Основные правила
- Бизнес-код получает
LoggerInterface; настройка конкретной реализации находится вне сервиса. - Секреты и персональные данные не должны попадать в текст, контекст, заголовки и URL журналов.
- HTTP-трафик по умолчанию не записывается. Безопасная локальная диагностика:
bitrix-http-client→rules/config-security.md.
Проверка
- Сервисы получают
LoggerInterface(по умолчаниюNullLogger), безnew FileLogger()внутри бизнес-логики. - ID логгеров имеют префикс модуля; при
LoggerFactoryвключены черезLoggerRegistry. - Файлы журналов находятся вне
DOCUMENT_ROOT, задан размер ротации. - Сообщения и контекст не содержат паролей, токенов и персональных данных.
- При
JsonLinesFormatterтекст сообщения добавлен в контекст.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bxmaximum/bitrix-framework-skills/bitrix-logger">View bitrix-logger on skillZs</a>