Наблюдатели сущностей: SPI для трассировки и метрик - #143
Open
nixel2007 wants to merge 14 commits into
Open
Conversation
Менеджер сущностей получил реестр наблюдателей: ДобавитьНаблюдателя и УдалитьНаблюдателя. Наблюдатель объявляет интерфейс НаблюдательСущностей аннотацией &Реализует и реализует ПередСобытием и ПослеСобытия; регистрация проверяет реализацию и называет недостающие методы. Событие - класс СобытиеСущностей: один объект в обеих фазах, поля читаются функциями, для данных наблюдателя между фазами есть Состояние. Реестр живет в пуле соединений, поэтому события хранилищ и Active Record приходят наблюдателям менеджера. Вложенность операций считается через данные потока исполнения: разыменование ссылки дает событие с глубиной 1. События уровня операции: Сохранить, Получить, ПолучитьОдно, Удалить, Инициализировать, ВыполнитьСКоннектором, ВычислитьСКоннектором. Чтение сообщает число строк, ошибка операции попадает в событие и доходит до вызывающего. Исключение наблюдателя пишется в лог и операцию не ломает. При пустом реестре событие не создается. Версия 4.4.1.0, зависимость extends 0.2.0. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
Коннектор, объявивший интерфейс НаблюдаемыйКоннектор, получает от пула реестр наблюдателей и сообщает о каждом запросе к СУБД: SELECT, INSERT, DELETE, CREATE TABLE, BEGIN, COMMIT, ROLLBACK. У SQL-коннекторов событие несет текст запроса с плейсхолдерами параметров и число строк выборки, у InMemory и JSON - только операцию и таблицу. Ошибка запроса попадает в событие и поднимается дальше. Тот же интерфейс дает описание соединения без секретов: система, адрес, порт, база. Им помечаются все события, включая события операций. Коннектор без интерфейса работает как раньше: наблюдатели получают только события операций, а система выводится из имени типа. АбстрактныйКоннектор помечен как &Интерфейс; встроенные коннекторы объявляют оба интерфейса аннотацией &Реализует. Проверка объявления делается один раз на тип коннектора пула, реализация - валидатором extends. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
Пул отдает наблюдателям события вида "Соединение" с операциями "Занять" и "Освободить": захват сообщает, открыто ли новое соединение, сколько заняло открытие и ожидание свободного, а оба события несут снимок пула (занято, свободно, ожидает, предел). Повторный захват тем же потоком событий не порождает. Обертка соединения ведет событие "Транзакция" от НачатьТранзакцию до исхода: commit, rollback, failed (ошибка завершения) или abandoned (транзакция брошена потоком и откачена при возврате в пул). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
Руководство docs/Наблюдатели.md: регистрация, виды событий и их поля по фазам, поведение при ошибках и в нескольких потоках, поддержка наблюдателей в своем коннекторе, накладные расходы. Справочники интерфейсов НаблюдательСущностей, НаблюдаемыйКоннектор и класса СобытиеСущностей; методы ДобавитьНаблюдателя и УдалитьНаблюдателя в справочнике менеджера. Раздел в README и перечень обязательств совместимости дополнены новыми интерфейсами. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
События, начатые до открытия первого соединения, - инициализация и ее захват соединения - создавались без описания от коннектора: пустые адрес, порт и база данных. Теперь реестр повторно проставляет описание при завершении события, когда оно уже известно, и наблюдатели видят один источник данных во всех событиях пула. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
ИсточникДанных описывает все параметры конструктора менеджера одним объектом, но размера пула в нем не было. Пятый параметр конструктора и функция РазмерПула с тем же значением по умолчанию, что у МенеджерСущностей; класс получил описание, справочник и запись в перечне документации. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
Contributor
|
Warning Review limit reachedNext included review available in 25 minutes. View limit detailsLimit details: You’ve used the included review currently available. You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. Review configuration: ⚙️ Run configurationConfiguration used: Repository UI Review profile: CHILL Plan: Team Run ID: 📒 Files selected for processing (37)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Owner
Author
|
Статус CI на e38d230. Падают все джобы Это не код этого PR: файл приходит из базовой ветки Готового фикса, который можно перенести сюда, нет: либо матрица в #141 переводится на Локально на dev night-build все 189 тестов зелёные (SQLite и PostgreSQL). Generated by Claude Code |
nixel2007
commented
Sep 3, 2026
Вид события больше не строковый литерал, разбросанный по библиотеке и наблюдателям: значения Операция, Запрос, Соединение, Транзакция и список Виды() живут в модуле ВидыСобытийСущностей, реестр наблюдателей, пул и соединение создают события через него. Документация и примеры наблюдателя сравнивают Вид() с перечислением. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
nixel2007
commented
Sep 3, 2026
Один слот Состояние на событие затирался при двух наблюдателях: второй перезаписывал спан первого, и первый в ПослеСобытия получал чужое. Событие хранит состояния по наблюдателям, реестр перед каждым вызовом отмечает, кому событие рассылается, и Состояние()/УстановитьСостояние работают с данными именно этого наблюдателя. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
nixel2007
commented
Sep 3, 2026
Экспортные переменные модуля можно переприсвоить снаружи, и перечисление перестало бы совпадать с тем, что создает библиотека. Значения отдаются функциями Операция(), Запрос(), Соединение(), Транзакция(). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
nixel2007
changed the base branch from
master
to
claude/entity-4.4.0.1-razmer-pula
September 5, 2026 19:21
…pentelemetry-integration-uhz1qn # Conflicts: # packagedef
…elemetry-integration-uhz1qn
… базы В CI пароль, пользователь и база PostgreSQL называются одинаково, и проверка "описание не содержит пароль" падала на имени базы. Теперь описание строится из строки соединения с заведомо уникальным паролем и проверяется по всем полям. Формулировка в docs/ИсточникДанных.md по замечанию ревью. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
nixel2007
changed the base branch from
claude/entity-4.4.0.1-razmer-pula
to
master
September 5, 2026 19:40
Quality Gate PR не пропускал 43 замечания bsl-language-server в новом коде: описания параметров и возвращаемых значений, строки длиннее 120 символов, приведение порта через исключение, конструктор структуры с четырьмя значениями, условие без ветви Иначе, магическое число порта, заглушка интерфейса без Возврат, латиница в именах тестов и экспортные переменные фикстур. Слова "Фикстуры" и "Валидатор" добавлены в исключения проверки опечаток. Описание соединения собирается одним помощником в СтрокиСоединения; порт проверяется на цифры, а не ловится исключением, с тестом на оба исхода. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
…параметрах Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Поверх master с влитым #144 (
ИсточникДанных.РазмерПула, 4.4.0.1). Здесь только наблюдатели.Зачем
Инструментирование в духе Spring Data JPA и Micrometer: приложение должно видеть, что делает ORM, не меняя ни entity, ни коннекторы. Сама entity об OpenTelemetry не знает: она публикует события, а реализацию наблюдателя даёт отдельная библиотека opentelemetry-instrumentation-entity, как
io.opentelemetry.contrib.*в Java.Что добавлено
НаблюдательСущностей(ПередСобытием/ПослеСобытия) и классСобытиеСущностей: один объект на обе фазы, поля читаются функциями, для данных наблюдателя между фазами естьСостояние— у каждого наблюдателя своё, чужого он не видит.ВидыСобытийСущностей: Операция (Сохранить, Получить, ПолучитьОдно, Удалить, Инициализировать, ВыполнитьСКоннектором, ВычислитьСКоннектором) с типом сущности, таблицей, вложенностью и числом строк; Запрос к СУБД с операцией, таблицей, текстом с плейсхолдерами и числом строк; Соединение пула (Занять/Освободить) с ожиданием, признаком открытия и снимком пула; Транзакция с исходом commit/rollback/failed/abandoned.НаблюдаемыйКоннектор(УстановитьНаблюдателей,ОписаниеСоединения) — отдельно отАбстрактныйКоннектор, который не меняется. Сторонний коннектор без него работает как раньше, просто не даёт событий уровня запроса. Встроенные коннекторы объявляют оба интерфейса черезextends. Описание соединения никогда не содержит пароля.МенеджерСущностей.ДобавитьНаблюдателя/УдалитьНаблюдателяпроверяют реализацию валидаторомextendsи называют недостающие методы.oscript.lib.entity.observersи операцию не прерывает. Наблюдатели вызываются из разных потоков одновременно, реестр копируется при записи.ПослеСобытия.docs/Наблюдатели.md, страницы классов и перечисления, раздел README, версионирование.Версия
4.4.1.0: API коннекторов не ломается, новые возможности описаны отдельным интерфейсом. Зависимость
extends 0.2.0.Тесты
Новые наборы
НаблюдателиСущностей(в том числе состояние у нескольких наблюдателей),НаблюдателиЗапросов(SQLite и PostgreSQL, описание соединения без пароля, разбор порта),НаблюдателиСоединений(захват, ожидание при пуле размера 1, четыре исхода транзакции),ВидыСобытийСущностей. Всего 193, CI зелёный на 2.2.0 и stable, Quality Gate Sonar пройден.🤖 Generated with Claude Code
https://claude.ai/code/session_017UYvrFghKi7WmhoF3vvpyp
Generated by Claude Code