III.8 Веб-интерфейс состояния (inspector)
Включается флагом --inspect-ui[=addr] на любом узле или командой oxl inspect --cluster <адрес> локально. Так как реестр кластера реплицирован на все узлы, интерфейс любого узла показывает весь кластер.
| Раздел | Что показывает |
|---|---|
| Узлы | все узлы: роли, зона, версия бинарника, адрес, статус, CPU, память, число задач, нагрузка |
| Роли | роли из cluster: желаемые и фактические реплики, needs, обслуживаемые сервисы и акторы |
| Конфиг | статический конфиг каждого узла с источником каждого значения (флаг, env, файл, профиль, умолчание); секреты скрыты |
| Динамический конфиг | текущие значения с переопределениями по уровням, история изменений, откат |
| Сервисы | rpc, их узлы, частота, ошибки, задержки p50/p95/p99, политики |
| Акторы и шарды | карта шардов по узлам, активные акторы, состояние актора (для @reflect) |
| Саги и пайплайны | запущенные, stuck, текущий шаг, компенсации, DLQ |
| Стримы и топики | подписчики, отставание, offset, broadcast-хабы |
| Трассы и логи | поиск по traceId, граф вызовов запроса, логи узлов |
| Права | граф «роль → метод», политики, who-can |
- Доступ — по политике
inspect(принципал с рольюAdminилиinspect; в этой реализации также принципал с рольюdebugи сертификат кластера с ролью — поправка редакции 1.0, D-8056; DIV-041; D-6401); адрес по умолчанию — только127.0.0.1. - Действия из интерфейса (изменение динамического конфига, дренирование узла, ручное разрешение саги, включение отладчика) требуют отдельных прав и пишутся в
oxl.audit. - Тот же API доступен как gRPC-сервис
oxl.Inspectдля автоматизации.
Определяется реализацией. Полнота inspector (D-8056; DIV-040; D-6408, D-6409). Эта реализация: состояние актора показывается по номерам полей (имена — для
@reflect); правила политик с условиями в разделе «Права» не видны.
Определяется реализацией. Состав программы по профилю (D-8063; D-7702). Программа профиля
prod, которая не обслуживает rpc и не входит в кластер, не содержит inspector, удалённого отладчика, экспортёра телеметрии и узлового сервера: флаги--inspect-ui,--debug-listen,--otlp-endpointдля неё недействительны. Программы профилейdevиtestи любая программа с сервисами или кластером содержат всё перечисленное.
Исходник: docs/spec/oxl-standard.md