From 41c867d68dfdc259ac8c6bde01a07e4038066d4e Mon Sep 17 00:00:00 2001
From: Dmitry Dementev <me@dementev.space>
Date: Sun, 8 Feb 2026 20:53:49 +0300
Subject: [PATCH] docs(operations): add post-pull monitoring refresh runbook

- Why:
  - student needs a simple way to apply Grafana/monitoring config updates after git pull
- What:
  - add TL;DR block with minimal commands in monitoring section
  - add detailed post-pull runbook for datasource/dashboard/alerting reload
  - include clickhouse restart note for prometheus_ch.xml changes
- Check:
  - reviewed commands and paths in docs/OPERATIONS.md
---
 docs/OPERATIONS.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md
index e98d88c..61ac4af 100644
--- a/docs/OPERATIONS.md
+++ b/docs/OPERATIONS.md
@@ -90,6 +90,17 @@ docker compose exec -T clickhouse clickhouse-client --user=default --password=12
 
 ## Мониторинг
 
+### TL;DR после `git pull`
+
+```bash
+docker compose up -d prometheus grafana
+curl -s -u admin:admin -X POST http://localhost:3000/api/admin/provisioning/datasources/reload
+curl -s -u admin:admin -X POST http://localhost:3000/api/admin/provisioning/dashboards/reload
+curl -s -u admin:admin -X POST http://localhost:3000/api/admin/provisioning/alerting/reload
+```
+
+Если менялся `configs/prometheus_ch.xml`: `docker compose restart clickhouse`.
+
 ### Prometheus + Grafana для ClickHouse
 
 Стек мониторинга поднимается вместе с остальной инфраструктурой:
@@ -111,6 +122,30 @@ curl -s http://localhost:9090/api/v1/targets | grep -o '"health":"[^"]*"'
   - Dashboard "ClickHouse Overview" загружается при старте
   - Alert rules для ClickHouse загружаются при старте
 
+### После `git pull`: быстрый апдейт мониторинга
+
+Если прилетели изменения в `configs/grafana/provisioning/*` или `configs/prometheus.yml`, примените их так:
+
+```bash
+# Поднять/обновить сервисы мониторинга
+docker compose up -d prometheus grafana
+
+# Перечитать provisioning Grafana без рестарта контейнера
+curl -s -u admin:admin -X POST http://localhost:3000/api/admin/provisioning/datasources/reload
+curl -s -u admin:admin -X POST http://localhost:3000/api/admin/provisioning/dashboards/reload
+curl -s -u admin:admin -X POST http://localhost:3000/api/admin/provisioning/alerting/reload
+
+# Быстрая проверка, что ресурсы применились
+curl -s -u admin:admin http://localhost:3000/api/datasources/name/Prometheus
+curl -s -u admin:admin http://localhost:3000/api/v1/provisioning/alert-rules
+```
+
+Если в пулле изменился `configs/prometheus_ch.xml`, дополнительно перезапустите ClickHouse:
+
+```bash
+docker compose restart clickhouse
+```
+
 ### Дашборд ClickHouse Overview
 
 URL: `http://localhost:3000/d/clickhouse-overview/clickhouse-overview`