bitrix-logger
Covers PSR-3 logging in Bitrix — Bitrix\Main\Diag\Logger, FileLogger, SysLogger, NullLogger, LogFormatter, loggers section in .settings.php, named kernel loggers (main.Default, main.HttpClient, main.GeoIpManager, main.EventLog.*), integration with Monolog and third-party PSR-3 lo
Install
npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-logger
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install bxmaximum-bitrix-framework-skills@llmmart
git clone https://github.com/bxmaximum/bitrix-framework-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole bxmaximum/bitrix-framework-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Логирование (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текст сообщения добавлен в контекст.
Files (bitrix-framework-skills)
-
rules
-
configuration.md 2.1 KB
Loading… -
factory.md 1.4 KB
Loading… -
writing.md 1.8 KB
Loading…
-
-
SKILL.md 2.4 KB
--- name: bitrix-logger description: 'Используй для PSR-3 логирования в Битриксе: Diag\FileLogger, LoggerFactory, секция loggers и форматы журналов. Передача LoggerInterface сервисам и защита секретов в логах.' --- # Логирование (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` текст сообщения добавлен в контекст.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.