--- name: onec-techlog-and-diagnostics description: "Расследует сбои, ожидания на управляемых блокировках (TLOCK, TTIMEOUT, TDEADLOCK), исключения (EXCP) и тяжёлые запросы по технологическому журналу 1С (logcfg.xml), журналу регистрации и серверу отладки. Используй при зависаниях базы, конфликтах блокировок транзакций, падениях фоновых заданий и разборе логов платформы." --- # Технологический журнал (`logcfg.xml`), журнал регистрации и диагностика сбоев 1С Используй навык, когда на стенде или в рабочей базе возникают ошибки конфликта блокировок при выполнении транзакции, взаимоблокировки (`Deadlock`), необработанные исключения фоновых заданий, обрывы сеансов или деградация запросов, требующие разбора событий платформы и сопоставления их с кодом в `edt-mcp`. Для интерактивного замера строк BSL в сеансе используй `edt-mcp-project-profiling`, а для пошаговой остановки на строке — `edt-mcp-project-runtime-debug`. ## Безопасная настройка технологического журнала (`logcfg.xml`) Никогда не включай на рабочей сервере сбор всех событий `SDBL` и `DBMSSQL`/`DBPOSTGRS` с `Context` без фильтров по длительности или информационной базе: это за минуты переполняет диск и кратно замедляет рабочий процесс `rphost`. Собирай только минимальный целевой профиль под конкретный симптом, всегда ограничивая `history` (например, `4`–`24` часа) и отбор `ib` (`p:processName="<ИмяИБ>"`): | Симптом | События `logcfg.xml` | Обязательные свойства и фильтры | |---|---|---| | «Конфликт блокировок при выполнении транзакции» / ожидания | `TLOCK`, `TTIMEOUT`, `TDEADLOCK` (+ `SDBL` только с порогом длительности) | Для `TTIMEOUT` и `TDEADLOCK` события редкие — собирай все (`property name="all"`), чтобы получить `WaitConnections` и стек `Context` | | Скрытые исключения, падения регламентных заданий и HTTP-сервисов | `EXCP`, `EXCPCNTX` | Фильтр по имени базы `p:processName`; читать `Descr` и `Context` | | Медленные запросы к СУБД | `DBPOSTGRS` / `DBMSSQL`, `SDBL` | Обязательный фильтр длительности (например, `Durationus >= 1000000` — от `1 с` в микросекундах! Помни, что единица `Duration` зависит от версии платформы — сверяй разрядность в файле ТЖ) | | Тяжёлые серверные вызовы и утечка памяти контекста | `CALL`, `SCALL`, `MEM`, `LEAKS` | Порог по `Duration` или `MemoryPeak` для `CALL` | ## Алгоритм расследования `TTIMEOUT` и `TDEADLOCK` 1. **Найди событие жертвы (`TTIMEOUT` или `TDEADLOCK`)**: зафиксируй время, `t:connectID` жертвы, её `Context` (точный модуль и строку BSL, где запрос или `Блокировка.Заблокировать()` упёрлись в ожидание) и атрибут **`WaitConnections`** — номер соединения-виновника! 2. **Установи уровень блокировки**: - События `TLOCK` с заполненным `Regions` и `Locks` означают ожидание на **менеджере управляемых блокировок 1С** (`rmngr`); - Отсутствие конфликта в `TLOCK` при ошибке блокировки на запросе `DBPOSTGRS`/`DBMSSQL` означает блокировку или эскалацию **на уровне СУБД** (часто из-за чтения/записи таблицы без предварительной управляемой блокировки либо отсутствия нужного индекса при `UPDATE`/`DELETE`). 3. **Найди активную транзакцию виновника (`t:connectID = WaitConnections`)** на том же отрезке времени до момента таймаута: посмотри, какой `TLOCK` / `SDBL` он захватил и что держало его транзакцию открытой (медленный запрос, вызов внешнего HTTP-сервиса внутри транзакции, необъявленная управляемая блокировка по пустому измерению). 4. **При `TDEADLOCK` сравни порядок захвата пространств у обоих соединений**: если соединение A блокирует `ТоварыНаСкладах → СвободныеОстатки`, а соединение B — `СвободныеОстатки → ТоварыНаСкладах`, приведи порядок блокировки в коде к единому алфавитному порядку через `edt-mcp` (см. навык `onec-transactions-and-locks`). ## Сопоставление с журналом регистрации и моделью `edt-mcp` - **Журнал регистрации (ЖР)** фиксирует бизнес-контекст: пользователя, имя регламентного задания, метаданные и ссылку на документ (`Данные`), текст `ПодробноеПредставлениеОшибки`. **Технологический журнал (ТЖ)** фиксирует низкоуровневый системный стек, SQL-текст, планы запросов и номера соединений `t:connectID` / сеансов `SessionID`. Связывай их по `SessionID` и метке времени. - Получив из `Context` путь вида `Документ.<Имя>.МодульОбъекта(<Строка>)` или `ОбщийМодуль.<Имя>.Модуль(<Строка>)`, прочитай метод через `edt-mcp` (`read_method_source` / `read_module_source`), учитывая возможное смещение строк при наличии активных перехватчиков расширений (`&ИзменениеИКонтроль` / `&Вместо`)! ## Гигиена серверной отладки (`RDBG` / `dbgs`) При подключении к серверу отладки (через `edt-mcp-project-runtime-debug`): - На точке останова внутри открытой транзакции рабочий процесс удерживает все захваченные блокировки БД и кластера! Не останавливай выполнение внутри транзакции на общей базе с другими пользователями. - При вычислении выражений в отладчике (`evaluate`) не вызывай функции с побочными эффектами (`Записать()`, модифицирующие серверные методы, сдвиг `Выборка.Следующий()`, изменяющий позицию курсора текущего цикла!), чтобы сама отладка не исказила проверяемый сценарий.