ddmitry/clickstream-data-platform
1
0 Fork 0
Code Issues 5 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

Хвост этапа 9: runbook keeper и system.text_log #117

New Issue
Closed
opened 2026-08-21 14:44:38 +03:00 by ddmitry · 1 comment
ddmitry commented 2026-08-21 14:44:38 +03:00
Owner
Copy link
Copy source

Part of #11. Блокируется #116.

Цель

Хвост этапа 9 — то, чему нужен прожитый опыт, а не свободные руки: runbook
«keeper упал / DDL повис в очереди» и серверный журнал, который под него и
подключается. Runbook, написанный до того, как кластер хоть раз повёл себя
плохо, будет вымышленным, — а вымышленному дежурный поверит.

Что войдёт

  • Runbook «keeper упал / DDL повис в очереди» — по живому опыту. Дом —
    docs/runbooks/; папки пока нет, правила имени для неё в AGENTS.md тоже,
    и завести придётся оба.
  • system.text_log: включается настройкой, таблице нужен TTL. Довод и условие
    отказа — ADR 0002: не окупился — уходит первым.
  • Правила оповещения — открытый вопрос, а не обещанная работа. Решается здесь,
    и решение может быть «не заводить»: подход предшественника ADR 0002 уже
    разобрал.

Границы

  • Панели порогов по-прежнему не несут. Оповещение, если появится, — отдельная
    сущность, а не раскраска панели.
  • Урок «посмотрели → сломали → увидели → вернули» пишется отдельной работой
    (спека, раздел 10). Здесь — runbook для дежурного.

Кому что

Целиком Opus: runbook читает человек в плохую минуту, и цена невнятной фразы
здесь выше обычного. Кодексу — прогоны опытов с поломкой кластера и разбор
журналов.

Сначала прочитать

  • docs/adr/0002-monitoring-scope.md — раздел про system.text_log и разбор
    правил оповещения предшественника;
  • docs/architecture/monitoring.md — устройство, каким оно вышло из #114–#116;
  • docs/architecture/testing.md, раздел «Проверка, которая не умеет краснеть,
    бесполезна» — как в этом репозитории ломают нарочно.

Проверка

  • Runbook проверен на живой поломке: keeper остановлен, DDL повис — по
    тексту человек доходит до диагноза и возвращает стенд.
  • Каждый шаг runbook называет, что смотреть и где: панель, таблицу или
    команду.
  • Решение по system.text_log принято по факту: цена названа числом,
    польза — случаем, в котором он пригодился. Не окупился — снят, и это
    записано.
  • Решение по правилам оповещения записано в ADR 0002 или monitoring.md —
    включая вариант «не заводим».
Part of #11. Блокируется #116. ## Цель Хвост этапа 9 — то, чему нужен прожитый опыт, а не свободные руки: runbook «keeper упал / DDL повис в очереди» и серверный журнал, который под него и подключается. Runbook, написанный до того, как кластер хоть раз повёл себя плохо, будет вымышленным, — а вымышленному дежурный поверит. ## Что войдёт - Runbook «keeper упал / DDL повис в очереди» — по живому опыту. Дом — `docs/runbooks/`; папки пока нет, правила имени для неё в AGENTS.md тоже, и завести придётся оба. - `system.text_log`: включается настройкой, таблице нужен TTL. Довод и условие отказа — ADR 0002: не окупился — уходит первым. - Правила оповещения — открытый вопрос, а не обещанная работа. Решается здесь, и решение может быть «не заводить»: подход предшественника ADR 0002 уже разобрал. ## Границы - Панели порогов по-прежнему не несут. Оповещение, если появится, — отдельная сущность, а не раскраска панели. - Урок «посмотрели → сломали → увидели → вернули» пишется отдельной работой (спека, раздел 10). Здесь — runbook для дежурного. ## Кому что Целиком Opus: runbook читает человек в плохую минуту, и цена невнятной фразы здесь выше обычного. Кодексу — прогоны опытов с поломкой кластера и разбор журналов. ## Сначала прочитать - `docs/adr/0002-monitoring-scope.md` — раздел про `system.text_log` и разбор правил оповещения предшественника; - `docs/architecture/monitoring.md` — устройство, каким оно вышло из #114–#116; - `docs/architecture/testing.md`, раздел «Проверка, которая не умеет краснеть, бесполезна» — как в этом репозитории ломают нарочно. ## Проверка - [ ] Runbook проверен на живой поломке: keeper остановлен, DDL повис — по тексту человек доходит до диагноза и возвращает стенд. - [ ] Каждый шаг runbook называет, что смотреть и где: панель, таблицу или команду. - [ ] Решение по `system.text_log` принято по факту: цена названа числом, польза — случаем, в котором он пригодился. Не окупился — снят, и это записано. - [ ] Решение по правилам оповещения записано в ADR 0002 или `monitoring.md` — включая вариант «не заводим».
ddmitry added the wontfix label 2026-08-31 11:15:59 +03:00
ddmitry commented 2026-08-31 11:16:00 +03:00
Author
Owner
Copy link
Copy source

Решение владельца: wontfix. Наблюдение выглядит пришельцем — воспроизвести проблему по нему стоило бы отдельных усилий, а урока за ней не видно. Этап 9 закрывается без этого хвоста.

Решение владельца: wontfix. Наблюдение выглядит пришельцем — воспроизвести проблему по нему стоило бы отдельных усилий, а урока за ней не видно. Этап 9 закрывается без этого хвоста.
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wayfinder:grilling
wayfinder:map
wayfinder:prototype
wayfinder:research
wayfinder:task
wontfix
No labels wontfix
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
ddmitry (Dmitry Dementiev)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Depends on
#116 Дашборды «Кластер» и «Запросы»: системные таблицы через clusterAllReplicas
ddmitry/clickstream-data-platform
Reference: ddmitry/clickstream-data-platform#117