Propagation Exporter
A small tool that watches systemd journal entries from opendnssec-signer.service, parses zone update stats, checks downstream DNS SOA serial propagation, and exposes Prometheus metrics.
Install
This project uses pyproject.toml. Install in your environment of choice.
Run
-
As a console script (recommended):
propagation-exporter -c /etc/coralogix-exporter/zones.yaml --metrics-port 8000
-
As a module:
python -m propagation_exporter -c /etc/coralogix-exporter/zones.yaml
-
Legacy script (still supported):
python main.py -c /etc/coralogix-exporter/zones.yaml
Testing with uv
This project uses uv for Python environment and dependency management in development.
-
Install dev deps (once):
uv sync --extra dev
-
Run tests with coverage:
uv run pytest -q --cov=propagation_exporter --cov-report=term-missing
-
Optional: type and style checks:
uv run mypy propagation_exporter uv run flake8 propagation_exporter
CLI options
- -c, --config-file: YAML with zones and nameservers
- --metrics-port: Prometheus HTTP port (default 8000)
- --zone / --ns: Ad-hoc SOA serial checks without systemd
- --stats-regex: Override the regex used to parse journal "[STATS]" lines.
Regex parsing
By default, the parser extracts zone, serial, and RR count from lines like:
[STATS] example.com 2024072826 RR[count=4 time=0(sec)] ...
Default pattern:
^\[STATS\]\s+(?P<zone>\S+)\s+(?P<serial>\d+)\s+RR\[count=(?P<rr_count>\d+)
You can override it via CLI --stats-regex or programmatically when creating ZoneManager.
Module layout
- propagation_exporter/
- init.py: public exports
- main.py:
python -mentry - cli.py: argument parsing and app wiring
- journal.py: systemd journal reader
- zone.py: ZoneInfo, ZoneConfig, ZoneManager, and parsing
- dns_utils.py: DNSChecker utilities
- metrics.py: Prometheus metrics
Prometheus metrics
- zone_out_of_sync{zone}
- zone_propagation_delay_seconds{zone, nameserver, serial}
Config file
YAML example:
zones:
example.com.:
primary_nameserver: 192.0.2.1
downstream_nameservers:
- 192.0.2.2
- 192.0.2.3
Notes
- Ensure
systemd-python,dnspython,PyYAML, andprometheus-clientare available in the runtime environment.
1 maintainer
Metadata
1 maintainer
Release files for propagation-exporter 0.9.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| propagation_exporter-0.9.2.tar.gz | 17.6 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| propagation_exporter-0.9.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 28.6 kB
Release files / propagation_exporter-0.9.2.tar.gz
| Download URL | propagation_exporter-0.9.2.tar.gz |
|---|---|
| Size | 17.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2c17e58c2473b599d761444eadb50e5dc56378e98c82c21b4c2440a826024c45
|
|
BLAKE2b-256 checksum How to use checksums |
231ae67a1bca62e284c072cb5d0ddd05803f520d7545e63d052b5b917f0f246f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 24, 2026.
Transparency logRelease files / propagation_exporter-0.9.2-py3-none-any.whl
| Download URL | propagation_exporter-0.9.2-py3-none-any.whl |
|---|---|
| Size | 11.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9e1a7f8cbfd9b6b61c77bea7d6aa343e4065a7729489b981c001d9aa16923bf6
|
|
BLAKE2b-256 checksum How to use checksums |
306b927d752235a7b26ed46778dacd87b494503f654cc060aa96a4204ebc3357
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 24, 2026.
Transparency logSecurity for propagation-exporter 0.9.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for propagation_exporter-0.9.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 24, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
