taler-monitoring/VERSIONS.md

7.9 KiB

VERSIONS — taler-monitoring

Release history for the standalone taler-monitoring suite
(https://git.hacktivism.ch/hernani/taler-monitoring).

Version scheme

Tags and VERSION use MAJOR.FEATURE.FIX (three components), introduced in v1.4.0:

Part Meaning
MAJOR Breaking changes to CLI, layout, or host-agent contract
FEATURE New capabilities (phases, HTML features, i18n packs, …)
FIX Bugfixes and docs that do not add a feature

Git tags: vMAJOR.FEATURE.FIX (e.g. v1.8.0). File VERSION omits the v prefix.

Tag Date (UTC) Notes
v1.10.0 2026-07-19 Feature: aptdeploy container overview board — inventory + per-pod matrix (state, merchant, httpd, ldd, OK/ERROR) in log and HTML sticky/top (#container-overview).
v1.9.4 2026-07-19 Fix: restore taler-monitoring-aptdeploy(+_err) as first-class GOA mon page (catalog + monpages path allow + surface docs). Mail/mattermost stay folded into surface.
v1.9.3 2026-07-19 Bugfix (suite): monpages merchant code 21 always ERROR (bare no longer soft-WARN); apply hints use absolute /home/hernani/koopa-caddy/…; ship host-agent/apply-monitoring-live.sh (smoke array, bare check); fix ROOT-ON-KOOPA wrong redir /path/ 302 examples.
v1.9.2 2026-07-19 Bugfix: Caddy bare-path redir footgun — inside handle use redir * /path/ 302 (not redir /path/ 302, which becomes Location: 302 and bare URLs fall through to merchant code 21). Snippet + ROOT-APPLY: absolute apply path (/home/hernani/koopa-caddy/…, not ~ as root).
v1.9.1 2026-07-19 Bugfix: stale path confusions in repo — sticky pages_i3 no longer lists mail/mattermost/aptdeploy mon pages; lib.sh/android-test drop scripts/taler-monitoring/; monpages/host-agent hints match v1.8 layout; clarify GIT vs GUI vs CLI *AUTOMATION-NOTES.md (three files by design).
v1.9.0 2026-07-19 monpages content: ERROR if page missing or markers incomplete — top (sticky-bar/status-bar/generated) + bottom (footer/taler-mon:bottom); mid-run (progress <100% / incomplete meta) relaxes bottom only. Surface required on normal GOA runs with meaningful body (not progress-only). HTML emits taler-mon:top / `taler-mon:bottom:complete
v1.8.0 2026-07-19 Simplified public pages: only /taler-monitoring-surface(+_err) on taler.hacktivism.ch for ecosystem software/versions; 9 landing stacks each keep /monitoring(+_err). Mail (firefly.gnunet.org + anastasis.taler-systems.com) and Mattermost folded into surface job; separate mail/mattermost mon pages + timers deprecated. nmap OS fingerprinting on surface (SURFACE_NMAP); ERROR when packages are behind (TALER_PKG_BEHIND=error default) or OS fingerprint is EOL.
v1.8.1 planned L10n packs: fr-CH (FrancPaysan) and de-CH (hacktivism / Taler CH German).
v1.7.7 2026-07-18 domains: stage mytops merchant FQDN is stage.my.taler-ops.ch (betel mon sites).
v1.9.1 2026-07-19 Bugfix: stale path confusions in repo — sticky pages_i3 no longer lists mail/mattermost/aptdeploy mon pages; lib.sh/android-test drop scripts/taler-monitoring/; monpages/host-agent hints match v1.8 layout; clarify GIT vs GUI vs CLI *AUTOMATION-NOTES.md (three files by design).
v1.9.0 2026-07-19 monpages content: ERROR if page missing or markers incomplete — top (sticky-bar/status-bar/generated) + bottom (footer/taler-mon:bottom); mid-run (progress <100% / incomplete meta) relaxes bottom only. Surface required on normal GOA runs with meaningful body (not progress-only). HTML emits taler-mon:top / `taler-mon:bottom:complete
v1.8.0 2026-07-18 monpages obligatory (ERROR): GOA checks full suite inventory (bank/exchange/taler /monitoring/ + surface/aptdeploy/mattermost/mail + on-disk discovery); FP only its own mon hosts; MONPAGES_REQUIRE_PUBLIC=1 default (escape hatch =0). Bugfix: with_timeout no longer re-runs a phase when it exits non-zero.
v1.9.1 2026-07-19 Bugfix: stale path confusions in repo — sticky pages_i3 no longer lists mail/mattermost/aptdeploy mon pages; lib.sh/android-test drop scripts/taler-monitoring/; monpages/host-agent hints match v1.8 layout; clarify GIT vs GUI vs CLI *AUTOMATION-NOTES.md (three files by design).
v1.9.0 2026-07-19 monpages content: ERROR if page missing or markers incomplete — top (sticky-bar/status-bar/generated) + bottom (footer/taler-mon:bottom); mid-run (progress <100% / incomplete meta) relaxes bottom only. Surface required on normal GOA runs with meaningful body (not progress-only). HTML emits taler-mon:top / `taler-mon:bottom:complete
v1.8.0 2026-07-18 Bugfix: monpages soft mode MONPAGES_REQUIRE_PUBLIC=0 (FP wrappers default) — missing public HTML is WARN until vhost publish; generic publish hints.
v1.7.4 2026-07-18 Bugfix: monpages bare URLs (/monitoring without /) WARN by default (trailing slash remains ERROR); avoids false red when slash form is live.
v1.7.3 2026-07-18 Monitoring pages themselves as suite scope: README section + sticky “What this monitors” block (monpages / public HTML paths).
v1.7.2 2026-07-18 Bugfix: Caddy static handles — root must be host dir + matcher /monitoring* (not leaf dir + /monitoring/), else file_server returns empty 404 after apply.
v1.7.1 2026-07-18 Host-agent default STRICT_EXIT=1; monpages staging-vs-public diagnosis; re-htmlify after public check fails.
v1.7.0 2026-07-18 CLI --ver / --version / -V: suite version, git commit, repo/tag/commit URLs.
v1.6.0 2026-07-18 Mail monitoring: phase mail (firefly + pixel/TSA); MX/SMTP/IMAP/SPF/DMARC; /taler-monitoring-mail*.
v1.5.0 2026-07-18 Mattermost monitoring: phase mattermost for mattermost.taler.net; /taler-monitoring-mattermost*.
v1.4.1 2026-07-18 Generic docs (no client hostnames); canonical install path ~/src/taler-monitoring.
v1.4.0 2026-07-18 MAJOR.FEATURE.FIX version scheme formalized (three-component tags + VERSION file).
v1.3.4 2026-07-18 Summary i18n, monpages code-21 detection, aptdeploy rsync path.
v1.3.3 2026-07-18 GIT notes vs GUI notes; monpages in TESTS.
v1.3.2 2026-07-18 Suite paths only ~/src/taler-monitoring (no admin-log suite tree).
v1.3.1 2026-07-18 monpages FQDN check + deploy no longer silent-skip.
v1.3.0 2026-07-18 Sticky bar suite version + Forgejo tag link.
v1.2.0 2026-07-18 Language selection: --lang / TALER_MON_LANG (en|fr).
v1.1.0 2026-07-18 i18n chrome: English default; French for FrancPaysan.
v1.0.0 2026-07-18 Initial standalone release.

Sticky bar version (v1.3.0+)

Generated HTML shows the installed release tag (e.g. v1.8.0) and links to Forgejo:

https://git.hacktivism.ch/hernani/taler-monitoring/src/tag/<tag>

Resolved via git describe --tags / VERSION.

Public monitoring pages (v1.3.1+)

Publish under DEPLOY_WWW_ROOT and Caddy handles. Missing handles → merchant JSON code 21.
See koopa-admin-log issue I-09 / apply-monitoring-live.sh.

Check How
Phase ./taler-monitoring.sh monpages
CLI version ./taler-monitoring.sh --ver

Language (v1.2.0+)

Method Example
CLI ./taler-monitoring.sh --lang fr …
Env TALER_MON_LANG=en or fr
Auto *lefrancpaysan* → fr, else en

Full locale packs (fr-CH / de-CH): v1.8.0 (planned).

Pin a release

git clone https://git.hacktivism.ch/hernani/taler-monitoring.git ~/src/taler-monitoring
cd ~/src/taler-monitoring && git checkout v1.9.1