# ops/

Scripts operativos que corren por cron en el nodo admin, fuera del ciclo de
vida de CodeDeploy (no se despliegan via appspec.yml).

## sync_grafana_node_labels.py

Mantiene al dia la leyenda "Nombre (ID)" de los paneles por-nodo del
dashboard Grafana "Hyva El Ganso - Resumen". El CloudWatch Agent (version
OTel) no soporta dimensiones personalizadas en `append_dimensions` -- solo
`InstanceId`, `ImageId`, `InstanceType` y `AutoScalingGroupName` -- asi que
este script reescribe la transformacion `renameByRegex` de cada panel a
partir del estado real de EC2 (`ec2:DescribeInstances`), en vez de dejar un
mapeo fijo que se queda obsoleto en cada ciclo del ASG.

- Cron en el nodo admin (root): `*/10 * * * * python3 /opt/hyva-elganso/bin/sync_grafana_node_labels.py`
- Copia desplegada: `/opt/hyva-elganso/bin/sync_grafana_node_labels.py`
- Credenciales AWS: rol de instancia `hyva-elganso-app-instance` (permiso
  inline `Ec2DescribeReadOnly`, solo lectura).
- Credenciales Grafana: `/etc/grafana-sync.json` (chmod 600, NO en git) con
  `{"url": "http://<ip-privada-grafana>:3000", "token": "<service account token>"}`.
  Service account `cron-node-labels` (rol Editor) creado en Grafana para esto.
- Requiere que el security group de Grafana permita el puerto 3000 desde la
  VPC interna (10.50.0.0/16) -- Grafana solo escucha en loopback + Caddy
  (80/443), asi que sin esa regla el admin no llega a la API.
- Log: `/var/log/hyva-elganso/grafana-node-labels.log`
