From 9f2619039a0ec2bbc1b3c6590a3c9c10ddbf77d9 Mon Sep 17 00:00:00 2001 From: kpa39l Date: Tue, 8 Sep 2026 18:26:42 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=D0=B7=D0=B0=D0=BA=D1=80=D1=8B=D1=82?= =?UTF-8?q?=D0=B8=D0=B5=20=D1=81=D0=B5=D1=81=D1=81=D0=B8=D0=B8=20(=D0=B2?= =?UTF-8?q?=D0=B5=D1=87=D0=B5=D1=80)=20=E2=80=94=20STATUS/TODO/WALKTHROUGH?= =?UTF-8?q?/README:=20=D0=BF=D0=BE=D0=B4=D0=BF=D0=B0=D0=BF=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=B4=D0=B0=D1=88=D0=B1=D0=BE=D1=80=D0=B4=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 8 ++++++-- STATUS.md | 10 ++++++++-- TODO.md | 1 + WALKTHROUGH.md | 22 +++++++++++++++++++++- 4 files changed, 36 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index d9bda23..b1722c0 100644 --- a/README.md +++ b/README.md @@ -190,9 +190,13 @@ admin-эндпоинты на loopback :8081: `/healthz`, `/readyz`, `/metrics` ## Node-дашборды (диски/память/сеть/доступность) — этап 7, РЕШЕНО ✅ На каждую ноду (vps01, vps02, vps03, bigbox) — **отдельный дашборд**, -`grafana/dashboards/node-.json` (uid `node-`, title "Node "). +`grafana/dashboards/nodes/node-.json` (uid `node-`, title "Node "). Генерируются скриптом `/tmp/gen_nodes_dash.py` (в git не хранится; при желании -перенести — в EXPERIENCE.md). +перенести — в EXPERIENCE.md). Файлы дашбордов разложены по подпапкам +(папки в UI Grafana совпадают): +- `grafana/dashboards/` — garage-cluster.json → папка **Garage** +- `grafana/dashboards/nodes/` — node-*.json → папка **nodes** +- `grafana/dashboards/vinogorod/` — vinograd-wan.json → папка **vinogorod** Панели (все по `{host=""}`, job=node): 1. **Availability** — stat-панель `up{job="node",host=...}` (UP/DOWN) diff --git a/STATUS.md b/STATUS.md index d45e43f..36cb45f 100644 --- a/STATUS.md +++ b/STATUS.md @@ -1,6 +1,6 @@ # Мониторинг кластера — Статус -Обновлено: 2026-09-08 (сессия @session:default/20260908_142639_b2d5b4) +Обновлено: 2026-09-08 (сессия @session:default/20260908_180858_730d1b) ## Текущее состояние Стек мониторинга на bigbox (/opt/monitoring): Prometheus 2.53 + Grafana 11.1 + @@ -20,6 +20,10 @@ Vinograd WAN + tproxy-панели. vps03 подключён к WG (10.8.0.3), availability + disk free + memory + load + **Net RX/TX (bytes/s)** + **Net utilization (%)** (физические интерфейсы, контейнерные исключены) - README.md/EXPERIENCE.md обновлены (грабли: node_network_* метрики, speed=-125000 на виртуалках) +- **Дашборды разложены по подпапкам**: `grafana/dashboards/nodes/` (node-*) и + `grafana/dashboards/vinogorod/` (vinograd-wan) — в git и на диске; provisioning + `dashboards.yml` получил 3 провайдера (Garage / nodes / vinogorod); в UI Grafana + дашборды лежат в папках **Garage / nodes / vinogorod** (проверено по БД, коммит 4b0539d) ## В работе / Следующие шаги - [ ] Разные admin_token / metrics_token в Garage (совпадают) @@ -36,7 +40,9 @@ curl -s "http://127.0.0.1:9090/api/v1/targets?state=any" | python3 -m json.tool ## Ключевые артефакты - /opt/monitoring/docker-compose.yml, prometheus.yml, alerts.yml -- /opt/monitoring/grafana/dashboards/node-.json (4 шт), garage-cluster.json, vinograd-wan.json +- /opt/monitoring/grafana/dashboards/garage-cluster.json (папка Garage) +- /opt/monitoring/grafana/dashboards/nodes/node-.json (4 шт, папка nodes) +- /opt/monitoring/grafana/dashboards/vinogorod/vinograd-wan.json (папка vinogorod) - /opt/monitoring/grafana/provisioning/datasources/datasources.yml, dashboards/dashboards.yml - README.md, EXPERIENCE.md, PLAN.md (в этом каталоге), STATUS.md/TODO.md/WALKTHROUGH.md diff --git a/TODO.md b/TODO.md index 03c9c26..950d50a 100644 --- a/TODO.md +++ b/TODO.md @@ -9,6 +9,7 @@ | 2026-09-08 | Дашборд per-node (Node vps01/vps02/vps03/bigbox, uid node-*) | ✅ закрыта | @session:default/20260908_142639_b2d5b4 | | 2026-09-08 | Сеть по интерфейсам: RX/TX + утилизация канала (node_network_*, speed) | ✅ закрыта | @session:default/20260908_142639_b2d5b4 | | 2026-09-08 | EXPERIENCE.md/README.md: грабли (WG, node_network_*, speed=-125000) | ✅ закрыта | @session:default/20260908_142639_b2d5b4 | +| 2026-09-08 | Дашборды по подпапкам (nodes/, vinogorod/) + provisioning folder | ✅ закрыта | @session:default/20260908_180858_730d1b | | 2026-09-08 | Git: push в gitverse + mirror gitea | ✅ закрыта | @session:default/20260908_142639_b2d5b4 | | — | admin_token / metrics_token в Garage — разные | 🔵 открыта | | | — | Пароль Grafana (ручной, пользователь) | 🔵 открыта | | diff --git a/WALKTHROUGH.md b/WALKTHROUGH.md index 6719c15..851ccf1 100644 --- a/WALKTHROUGH.md +++ b/WALKTHROUGH.md @@ -72,4 +72,24 @@ ### Итог проверки - `api/v1/targets?state=any` → node ×4 up (10.8.0.1/2/3/4) - grafana.nixg.ru/api/health → 200 -- Дашборды node-vps01/02/03/bigbox — в БД Графаны \ No newline at end of file +- Дашборды node-vps01/02/03/bigbox — в БД Графаны + +## 2026-09-08 (вечер) — подпапки дашбордов (сессия @session:default/20260908_180858_730d1b) + +Пользователь создал папки в UI Grafana (nodes, vinogorod) и попросил разложить +дашборды по ним (в файловой системе + в интерфейсе). + +1. Перемещение на диске (git mv, история сохранена): + ``` + grafana/dashboards/nodes/node-{bigbox,vps01,vps02,vps03}.json + grafana/dashboards/vinogorod/vinograd-wan.json + garage-cluster.json — остался в корне + ``` +2. `grafana/provisioning/dashboards/dashboards.yml` — 3 провайдера: + - garage-dashboards → path /var/lib/grafana/dashboards (корень), folder: Garage + - node-dashboards → path .../dashboards/nodes, folder: nodes + - vinogorod-dashboards → path .../dashboards/vinogorod, folder: vinogorod + (Grafana type:file НЕ ходит рекурсивно — поэтому на подпапку свой provider.) +3. `docker compose restart grafana` — provisioning применил папки. +4. Проверка по БД: Node * → nodes, Vinograd WAN → vinogorod, Garage Cluster → Garage. +5. Коммит 4b0539d → gitverse + gitea mirror-sync. \ No newline at end of file