Claude Skill

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

LLM Mart · 0 points · 14 views 2 listing impressions 0 install-command copies
Download bxmaximum-bitrix-framework-skills-skills_bitrix-logger-0c65452.zip · 4 KB

Install

skills CLI npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-logger
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install bxmaximum-bitrix-framework-skills@llmmart
Git 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.

No comments yet.

Reviews (0)

No reviews yet.