Backup de dashboards de Grafana

Este servidor corre Grafana en http://localhost:3000 (puerto expuesto: 3000). El backup se hace vía la API HTTP de Grafana (no toca los volúmenes/DB de Docker directamente), exportando cada dashboard como JSON.

Archivos involucrados

Ruta	Qué es
`/opt/server/scripts/backup-grafana-dashboards.sh`	Script de backup (root:root, permisos 700 porque contiene la contraseña de Grafana)
`/opt/server/backups/grafana_dashboards/`	Carpeta con los `.tar.gz` generados

No está agregado a crontab (a diferencia de backup-jenkins-home.sh). Se ejecuta manualmente con sudo cuando se necesite.

Cómo correr el backup manualmente

sudo /opt/server/scripts/backup-grafana-dashboards.sh

Esto genera /opt/server/backups/grafana_dashboards/grafana_dashboards_YYYYMMDD.tar.gz y conserva solo los últimos 4 backups (los más viejos se borran automáticamente, KEEP=4 dentro del script).

Convención de nombres dentro del tar.gz

Cada dashboard se guarda como:

<título_sanitizado>__<uid>.json

Ejemplo:

Monitoreo__adpjcx6.json
Node_Exporter_Full__rYdddlPWk.json
Node_Exporter_Full_completo__rYdddlPWk3.json
MySQL_Overview__MQWgroiiz.json

El título se sanitiza (solo A-Za-z0-9, resto reemplazado por _), y el uid real de Grafana queda al final por si dos títulos sanitizados coinciden.

Ver contenido de un backup sin extraerlo

sudo tar tzf /opt/server/backups/grafana_dashboards/grafana_dashboards_<fecha>.tar.gz

Cómo restaurar un dashboard

Cada archivo .json dentro del tar tiene esta forma (respuesta cruda de la API GET /api/dashboards/uid/{uid}):

{
  "meta": { ... },
  "dashboard": { ... }   <- esto es lo que Grafana necesita para importar
}

IMPORTANTE: para importar, Grafana necesita únicamente el contenido del campo dashboard, sin el wrapper meta. Si se sube/pega el JSON completo (meta + dashboard) da el error:

Invalid or unknown dashboard schema

Opción A — Restaurar vía API (rápido, scripteable)

sudo bash -c '
LATEST=$(ls -1t /opt/server/backups/grafana_dashboards/grafana_dashboards_*.tar.gz | head -1)
mkdir -p /tmp/restore
tar xzf "$LATEST" -C /tmp/restore ./<archivo>.json

jq "{dashboard: (.dashboard + {id: null}), overwrite: true}" \
  /tmp/restore/<archivo>.json > /tmp/restore/payload.json

curl -sf -X POST -H "Content-Type: application/json" \
  -u admin:<password_de_grafana> \
  http://localhost:3000/api/dashboards/db \
  -d @/tmp/restore/payload.json
'

Notas:

id: null — el id interno viejo puede no existir más (ej. si se borró el dashboard); ponerlo en null hace que Grafana cree uno nuevo.
El uid se mantiene igual, así el dashboard vuelve con la misma URL que tenía.
overwrite: true evita el error 412 si el uid ya existiera.
Respuesta esperada: {"status":"success", "uid": "...", "url": "...", ...}.
Limpiar /tmp/restore después (sudo rm -rf /tmp/restore).

Opción B — Restaurar a mano desde la UI

Extraer solo el campo dashboard (sin el wrapper meta):

sudo bash -c '
LATEST=$(ls -1t /opt/server/backups/grafana_dashboards/grafana_dashboards_*.tar.gz | head -1)
mkdir -p /tmp/restore
tar xzf "$LATEST" -C /tmp/restore ./<archivo>.json
jq ".dashboard" /tmp/restore/<archivo>.json > /tmp/restore/import.json
'

Bajar /tmp/restore/import.json a tu equipo si vas a subirlo como archivo (scp jenkins-srv:/tmp/restore/import.json .), o simplemente abrirlo con cat/editor para copiar el contenido.
En la UI de Grafana (http://172.19.13.204:3000): Dashboards → New → Import → Upload JSON file (o pegar el contenido en "Import via panel json").
Confirmar el nombre/folder propuesto y click Import.
Si Grafana avisa que el uid ya existe, ofrece la opción de sobrescribir en el mismo diálogo.
Limpiar /tmp/restore cuando termines.

Encontrar rápido el uid/título de un dashboard sin extraer todo el tar

for f in $(tar tzf <backup>.tar.gz | grep '\.json$'); do
  echo -n "$f -> "
  tar xzOf <backup>.tar.gz "$f" | jq -r '.dashboard.title'
done

(Con la convención de nombres actual esto ya no es necesario para uso normal, pero sirve como referencia si en algún momento se cambia el formato del script.)

Credenciales

El script usa el usuario admin de Grafana (admin) y su contraseña, embebidas en /opt/server/scripts/backup-grafana-dashboards.sh. Por eso el script tiene permisos 700 (solo root puede leerlo/ejecutarlo), a diferencia de otros scripts en /opt/server/scripts/ que son 755.

Probado el (2026-08-05)

Ciclo completo validado: crear dashboard de prueba → backup → borrar dashboard → restaurar (API y manual) → verificar que el contenido vuelve idéntico. Ambos métodos de restauración funcionan.

5.0 KiB Raw Permalink Blame History