PhoenixDKIM 1.0.0-beta3

PhoenixDKIM 1.0.0-beta3

Date: 4 June 2026

New: metrics and observability

PhoenixDKIM now maintains in-process counters and can expose them two ways.
No extra library is linked; both exporters are switched on by configuration
alone.

Prometheus (textfile collector):

MetricsFile /var/lib/prometheus/node-exporter/phoenixdkim.prom
MetricsInterval 15 # seconds; default 15

A background thread writes atomically (temp file + rename(2)) every interval
and on clean shutdown. Place the file in the node_exporter textfile collector
directory; no network listener is added to the daemon. On Debian/Ubuntu the
directory is /var/lib/prometheus/node-exporter; other distributions commonly
use /var/lib/node_exporter/textfile_collector. Both systemd service files
carry the appropriate ReadWritePaths= entry.

StatsD (UDP push):

StatsDHost 127.0.0.1:8125
StatsDPrefix phoenixdkim # default

Events are pushed over a non-blocking UDP socket; packets drop silently if
the collector is unreachable, so a stalled collector never throttles mail.

Per-message log line (LogResults yes):

: summary action=verify result=pass d=example.com a=rsa-sha256 sigs=1

Exported series: phoenixdkim_messages_total, phoenixdkim_signatures_total
(result, algorithm), phoenixdkim_verifications_total (result mirrors RFC 8601
dkim= vocabulary), phoenixdkim_dns_queries_total, phoenixdkim_dns_responses_total
(result), phoenixdkim_dns_duration_seconds (histogram), phoenixdkim_build_info
(version). See the Metrics guide on the website for the full table and PromQL
examples.

Build fix

• CMake: accept Lua >= 5.4 rather than exactly 5.4; fixes builds on
  distributions shipping Lua 5.5 (e.g. Fedora Rawhide).