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

62 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).