ia_dev/deploy/README-lpldf-https-watch.md
Nicolas Cantu 4a0b031b89 Add LPLDF HTTPS watchdog systemd units for 4NK proxy
**Motivations:**
- Alert when the LPLDF storefront HTTPS endpoint is down from the proxy

**Root causes:**
- N/A (monitoring gap)

**Correctifs:**
- N/A

**Evolutions:**
- watch-https-lpldf.sh: curl check, state file, syslog tag lpldf-https-watch, optional webhook/email via env file
- systemd oneshot + 5-minute timer; install script via SSH/scp

**Pages affectées:**
- tools/proxy-https-watch-lpldf.sh
- tools/proxy-https-watch-lpldf.env.example
- deploy/proxy-units/lpldf-https-watch.service
- deploy/proxy-units/lpldf-https-watch.timer
- deploy/scripts/install-lpldf-https-watch-on-proxy.sh
- deploy/README-lpldf-https-watch.md
2026-03-22 23:35:43 +01:00

33 lines
1.4 KiB
Markdown

# LPLDF HTTPS watchdog on the 4NK proxy
## Purpose
Detect downtime of `https://xn--lespetitesleonsdefrdric-89b1db.fr/` from the proxy and emit alerts (syslog tag `lpldf-https-watch`, optional webhooks / mail). Acts as an availability watchdog; a SIEM (e.g. Wazuh) can ingest these syslog lines.
## Repository paths
- Watch script (installed to `/opt/proxy-config/scripts/watch-https-lpldf.sh`): `tools/proxy-https-watch-lpldf.sh`
- Optional env example: `tools/proxy-https-watch-lpldf.env.example`
- Systemd units: `deploy/proxy-units/lpldf-https-watch.service`, `deploy/proxy-units/lpldf-https-watch.timer`
- Installer (from ia_dev root): `./deploy/scripts/install-lpldf-https-watch-on-proxy.sh`
## Behaviour
- Accepts HTTP status 200, 301, 302, 307, 308.
- State under `/var/lib/lpldf-https-watch/`.
- First DOWN: `daemon.warning` + optional `ALERT_WEBHOOK_URL` / `ALERT_EMAIL_TO`.
- Repeats while down at most every `ALERT_REPEAT_SECONDS` (default 3600).
- Recovery: `daemon.info` + optional `ALERT_WEBHOOK_URL_RECOVER`.
## Optional proxy config
Create `/opt/proxy-config/scripts/env/watch-https-lpldf.env` (e.g. `chmod 600`), see `tools/proxy-https-watch-lpldf.env.example`.
## Operations
- Manual run on proxy: `sudo /opt/proxy-config/scripts/watch-https-lpldf.sh`
- Logs: `sudo journalctl -t lpldf-https-watch`
- Timer: `systemctl status lpldf-https-watch.timer`
Nginx is not modified for this check.