taler-monitoring/VERSIONS.md
Hernâni Marques e7a3cd558f
release 1.8.0: simplified mon pages + surface nmap + mail hosts
Public layout: only taler-monitoring-surface(+_err) for ecosystem
software/versions; nine landing stacks keep /monitoring(+_err).
Fold mail (firefly.gnunet.org, anastasis.taler-systems.com) and
mattermost into the surface job; deprecate separate mon pages/timers.
nmap OS fingerprinting; package-behind defaults to ERROR.
2026-07-19 00:58:09 +02:00

4.8 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.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.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.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.8.0