Releases: bennybrit/promcsv
Release list
promcsv v1.4.2
Full Changelog: v1.4.1...v1.4.2
promcsv v1.4.1
promcsv v1.4.1 - documentation restructure (docs-only release).
- The README is now a slim landing page: quick pip install, clearly separated RPM vs pip install paths, systemd setup for pip installs, CLI reference.
- New usage guide at docs/USAGE.md: CSV format specification for consumers, directory lifecycle, S3/SFTP upload setup, monitoring and alerting, operational best practices.
- README documentation links are pinned to the release tag, so the PyPI page of every version links to matching docs permanently.
No code changes; version bump only.
Install (Rocky/RHEL 8+, recommended):
dnf install ./python3.12-promcsv-1.4.1-1.el8.noarch.rpm
Install (any Linux):
sudo python3.12 -m pip install promcsv
428 tests, 100% branch coverage.
promcsv v1.4.0
promcsv v1.4.0 - self-sufficient wheel installs.
The deployment files now ship inside the package, and the CLI prints them on demand - a wheel install no longer needs the git checkout:
promcsv --print-config > /etc/promcsv/config.yaml
promcsv --print-unit > /usr/lib/systemd/system/promcsv.service
promcsv --print-logrotate > /etc/logrotate.d/promcsv
promcsv --print-env > /etc/promcsv/env && chmod 0600 /etc/promcsv/env
Changes:
- New CLI flags: --print-config / --print-unit / --print-logrotate / --print-env (mutually exclusive with each other and with --once / --validate-config)
- New /etc/promcsv/env credentials template (all placeholders commented out); the RPM now installs it with mode 0600, preserved on upgrades
- README: flag-based wheel setup, venv ExecStart note, "upgrade, never reinstall" operational note
Install (Rocky/RHEL 8+, recommended):
dnf install ./python3.12-promcsv-1.4.0-1.el8.noarch.rpm
Install (any Linux, wheel):
sudo python3.12 -m pip install promcsv-1.4.0-py3-none-any.whl
425 tests, 100% branch coverage.
promcsv v1.3.0
First public release of promcsv.
promcsv scrapes Prometheus /metrics endpoints on a wall-clock-aligned interval and writes one CSV file per target per cycle (fixed schema: timestamp,metric,type,labels,value), with optional gzip compression, upload to S3 or SFTP (flat or per-target remote layout), retention cleanup, a status.json health file and full systemd integration (Type=notify watchdog).
Install (Rocky/RHEL 8+, recommended):
dnf install ./python3.12-promcsv-1.3.0-1.el8.noarch.rpm
Install (any Linux, wheel):
sudo python3.12 -m pip install promcsv-1.3.0-py3-none-any.whl
See the README for configuration, the CSV format specification, and monitoring/alerting guidance.
413 tests, 100% branch coverage.