Release 2.1.0: version bump and docs

Bump the version and image labels to 2.1.0, document LOG_FORMAT, and add the
2.1.0 changelog and upgrade notes.

Author: noxied

CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.0] - 2026-06-13
+
+Resilience and observability improvements. No breaking changes; all new
+behaviour is either automatic or opt-in, and existing configuration keeps
+working.
+
+### Added
+
+- Optional structured JSON logging (`LOG_FORMAT=json`). Each line is a single
+  JSON object with a UTC ISO 8601 timestamp, level, logger name, and message,
+  ready for aggregators such as Loki, Datadog, or Splunk. The default stays
+  human-readable text. No new dependencies; the formatter is built on the
+  standard library.
+
+### Changed
+
+- After a failed check the monitor now uses a short adaptive backoff (starting
+  at 30 seconds, doubling, capped at `CHECK_INTERVAL`) instead of always
+  waiting the full interval, so connectivity recovery is detected sooner. The
+  steady-state interval is unchanged when checks succeed.
+- Retry and backoff delays now include random jitter, so independent instances
+  do not all retry on the same second (avoids synchronised request spikes
+  against the detection and notification services).
+
 ## [2.0.0] - 2026-06-11
 
 The application was restructured into a Python package (`wanwatcher/`). The old

Dockerfile

@@ -2,10 +2,10 @@ FROM python:3.14-slim
 
 LABEL maintainer="noxied"
 LABEL description="WAN IP monitoring with notifications, DDNS updates and Home Assistant integration"
-LABEL version="2.0.0"
+LABEL version="2.1.0"
 LABEL org.opencontainers.image.title="WANwatcher"
 LABEL org.opencontainers.image.description="Monitor WAN IPv4/IPv6 addresses with notifications, DDNS and MQTT"
-LABEL org.opencontainers.image.version="2.0.0"
+LABEL org.opencontainers.image.version="2.1.0"
 LABEL org.opencontainers.image.authors="noxied"
 LABEL org.opencontainers.image.url="https://github.com/noxied/wanwatcher"
 LABEL org.opencontainers.image.source="https://github.com/noxied/wanwatcher"
@@ -83,6 +83,7 @@ ENV DISCORD_ENABLED="false" \
     SERVER_NAME="WANwatcher Docker" \
     IP_DB_FILE="/data/ipinfo.db" \
     LOG_FILE="/logs/wanwatcher.log" \
+    LOG_FORMAT="text" \
     BOT_NAME="WANwatcher" \
     CHECK_INTERVAL="900" \
     HTTP_TIMEOUT="10" \

README.md

@@ -43,15 +43,15 @@ docker run -d \
   -e SERVER_NAME="My Server" \
   -v ./data:/data \
   -v ./logs:/logs \
-  noxied/wanwatcher:2.0.0
+  noxied/wanwatcher:2.1.0
 ```
 
 Or with compose:
 
 ```yaml
 services:
   wanwatcher:
-    image: noxied/wanwatcher:2.0.0
+    image: noxied/wanwatcher:2.1.0
     container_name: wanwatcher
     restart: unless-stopped
     environment:
@@ -91,6 +91,7 @@ Everything is configured through environment variables. Booleans are the string
 | `HTTP_TIMEOUT` | `10` | Timeout in seconds for outbound HTTP requests |
 | `IP_DB_FILE` | `/data/ipinfo.db` | State file path |
 | `LOG_FILE` | `/logs/wanwatcher.log` | Log file path |
+| `LOG_FORMAT` | `text` | `text` for human-readable logs, or `json` for structured logs (one JSON object per line, UTC timestamps) for log aggregators like Loki or Datadog |
 
 ### Discord
 

SECURITY.md

@@ -37,7 +37,7 @@ Environment variables:
 
 ```bash
 export DISCORD_WEBHOOK_URL="your_webhook"
-docker run -e DISCORD_WEBHOOK_URL ... noxied/wanwatcher:2.0.0
+docker run -e DISCORD_WEBHOOK_URL ... noxied/wanwatcher:2.1.0
 ```
 
 A `.env` file (add it to `.gitignore`):
@@ -86,7 +86,7 @@ Reasonable extras for the paranoid:
 ```yaml
 services:
   wanwatcher:
-    image: noxied/wanwatcher:2.0.0   # pin a version, avoid :latest
+    image: noxied/wanwatcher:2.1.0   # pin a version, avoid :latest
     security_opt:
       - no-new-privileges:true
     deploy:

UPGRADING.md

@@ -2,6 +2,25 @@
 
 Version-specific upgrade notes. The newest upgrade path is at the top.
 
+## 2.0.x to 2.1.0
+
+No breaking changes and no required configuration. Pull the new image and
+restart:
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+What changed:
+
+- Optional structured JSON logging. Set `LOG_FORMAT=json` to emit one JSON
+  object per line (UTC timestamps) for log aggregators; the default stays
+  human-readable text, so doing nothing keeps the old behaviour.
+- After a failed check the monitor retries sooner (short adaptive backoff
+  capped at `CHECK_INTERVAL`) and adds jitter to retry delays. This is
+  automatic; there is nothing to configure.
+
 ## 1.x to 2.0.0
 
 v2.0.0 restructures the application into a Python package and adds a number

docker-compose.yml

@@ -1,6 +1,6 @@
 services:
   wanwatcher:
-    image: noxied/wanwatcher:2.0.0
+    image: noxied/wanwatcher:2.1.0
     container_name: wanwatcher
     restart: unless-stopped
 
@@ -20,6 +20,8 @@ services:
       IP_CHANGE_CONFIRMATION: "true"
       # Optional ipinfo.io token for geographic data
       IPINFO_TOKEN: ""
+      # Log format: "text" (default) or "json" for log aggregators
+      LOG_FORMAT: "text"
 
       # ========================================================================
       # Discord

docs/TROUBLESHOOTING.md

@@ -293,7 +293,7 @@ creating datasets for `/data` and `/logs`.
 Synology: create the shared folders in File Station first, give uid 1000
 write access, and use absolute paths in Container Manager.
 
-Raspberry Pi: the published image is multi-arch; `noxied/wanwatcher:2.0.0`
+Raspberry Pi: the published image is multi-arch; `noxied/wanwatcher:2.1.0`
 pulls the ARM64 variant automatically on a 64-bit OS. 32-bit ARM is not
 published; build locally if you need it.
 

wanwatcher/__init__.py

@@ -1,5 +1,5 @@
 """WANwatcher - WAN IP address monitor with notifications, DDNS and integrations."""
 
-VERSION = "2.0.0"
+VERSION = "2.1.0"
 
 __version__ = VERSION