taler-monitoring/host-agent/ROOT-APPLY-MONITORING.md
2026-07-18 13:56:54 +02:00

2 KiB

Root: make monitoring pages live on koopa (GOA)

Symptom if not applied

Public URLs return merchant/bank JSON like:

{ "code": 21, "hint": "There is no endpoint defined for the URL provided..." }

or a 404 HTML page from the app reverse_proxy.

Cause: live /etc/caddy/Caddyfile has no handle /monitoring* (falls through to API). Prepared config is only under /home/hernani/koopa-caddy/Caddyfile.

sudo /home/hernani/koopa-caddy/apply-monitoring-live.sh

That script:

  1. rsync staging HTML → /var/www/monitoring-sites/ (incl. surface + aptdeploy)
  2. Makes tree writable for hernani (group caddy + ACL) so later runs self-sync
  3. Installs prepared Caddyfile → /etc/caddy/Caddyfile, validates, reloads Caddy
  4. Smoke-curls all monitoring URLs (must not be JSON code:21)

Paths

Path Host Source timer
/monitoring/ + /monitoring_err/ bank + exchange + taler taler-monitoring-hacktivism.timer (4h)
/taler-monitoring-surface/ + /_err/ taler.hacktivism.ch only taler-monitoring-surface.timer (1h)
/taler-monitoring-aptdeploy/ + /_err/ taler.hacktivism.ch only taler-monitoring-aptdeploy.timer (4h)

HTML is generated as hernani into
/home/hernani/monitoring-sites-staging/.

Manual equivalent

rsync -a --delete /home/hernani/monitoring-sites-staging/ /var/www/monitoring-sites/
chown -R hernani:caddy /var/www/monitoring-sites && chmod -R g+rwX /var/www/monitoring-sites
sudo /home/hernani/koopa-caddy/apply.sh   # or apply-monitoring-live.sh

Expect 200 (HTML with sticky bar). Not merchant JSON code:21.

After each monitoring run (if www is not hernani-writable)

rsync -a --delete /home/hernani/monitoring-sites-staging/ /var/www/monitoring-sites/
chown -R caddy:caddy /var/www/monitoring-sites

Or grant hernani write on /var/www/monitoring-sites once so the host-agent can rsync itself.