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

Design: Fix Vinograd WAN dashboard annotations

Файл

Файл	Действие
/opt/monitoring/grafana/dashboards/vinograd-wan.json	убрать annotations.list (ссылка на __grafana__) → "list": []

Изменение

Было:

"annotations": {
  "list": [
    {
      "builtIn": 1,
      "datasource": {"type": "grafana", "uid": "__grafana__"},
      "enable": true,
      "hide": true,
      "iconColor": "rgba(0, 211, 255, 1)",
      "name": "Annotations & Alerts",
      "type": "style"
    }
  ]
}

Стало:

"annotations": {
  "list": []
}

Почему так

• __grafana__ — встроенный datasource (аннотации/алерты), не существует в БД этой инсталляции (в data_source только Prometheus и Loki).
• Панели дашборда не ссылаются на аннотации; секция добавлена автоматически при создании JSON (скопирована из шаблона) и бесполезна.
• Рабочий garage-cluster.json имеет "list": [] — дашборд открывается.

Применение и проверка

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).