Archive fix-vinograd-dashboard-datasource: убрана ссылка на __grafana__ в annotations дашборда vinograd-wan (Datasource not found)

openspec/changes/archive/2026-09-08-fix-vinograd-dashboard-datasource/design.md

@@ -0,0 +1,62 @@
+# Design: Fix Vinograd WAN dashboard annotations
+
+## Файл
+
+| Файл | Действие |
+|---|---|
+| `/opt/monitoring/grafana/dashboards/vinograd-wan.json` | убрать `annotations.list` (ссылка на `__grafana__`) → `"list": []` |
+
+## Изменение
+
+Было:
+
+```json
+"annotations": {
+  "list": [
+    {
+      "builtIn": 1,
+      "datasource": {"type": "grafana", "uid": "__grafana__"},
+      "enable": true,
+      "hide": true,
+      "iconColor": "rgba(0, 211, 255, 1)",
+      "name": "Annotations & Alerts",
+      "type": "style"
+    }
+  ]
+}
+```
+
+Стало:
+
+```json
+"annotations": {
+  "list": []
+}
+```
+
+## Почему так
+
+- `__grafana__` — встроенный datasource (аннотации/алерты), не существует в
+  БД этой инсталляции (в `data_source` только Prometheus и Loki).
+- Панели дашборда не ссылаются на аннотации; секция добавлена автоматически
+  при создании JSON (скопирована из шаблона) и бесполезна.
+- Рабочий garage-cluster.json имеет `"list": []` — дашборд открывается.
+
+## Применение и проверка
+
+```bash
+cd /opt/monitoring
+# правка файла (руками или jq)
+jq '.annotations.list = []' grafana/dashboards/vinograd-wan.json > /tmp/vw.json && mv /tmp/vw.json grafana/dashboards/vinograd-wan.json
+# провайдер перечитает файл за ≤30с (updateIntervalSeconds: 30); рестарт не нужен
+sleep 35
+# проверка: дашборд без ошибки __grafana__
+curl -s -u 'estorozhenko:...' 'http://127.0.0.1:3001/api/dashboards/uid/vinograd-wan' | jq '.dashboard.annotations'
+# и главное — открытие страницы без ошибки в браузере
+```
+
+## Риски
+
+- Минимальные. Изменение декоративное (удаление неиспользуемой секции).
+- Если Grafana всё же нужна встроенная аннотация — она добавится автоматически
+  в рантайме (built-in annotation не зависит от дашборд-JSON).