All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.0 - 2019-07-23
- Initial release
1.1.0 - 2019-07-31
- Added support for environment variables
- Better excpetions treatment
1.1.1 - 2019-09-24
- Fixed metrics collection bug
1.2.0 - 2020-08-06
-
Added new argument:
--debug: Enable debug mode--rundeck.projects.executions: Get projects executions metrics--rundeck.projects.filter: Get executions only from listed projects (delimiter = space)--rundeck.projects.executions.limit: Limit project executions metrics query. Default: 20--rundeck.cached.requests.ttl: Rundeck cached requests (by now, only for rundeck.projects.executions) expiration time. Default: 120
-
Added code improvements
-
Added cachetools to pip install on Dockerfile
-
Added logging module to replace print calls
-
Added better error handling
- Changed args location, now located at class RundeckMetricsCollector
2.0.0 - 2020-08-12
- Added argument
--rundeck.projects.executions.cacheandRUNDECK_PROJECTS_EXECUTIONS_CACHEenv var - Added counter metrics rundeck_services_[services,controllers,api,web]_total
- Changed rundeck_project_executions_info metrics to rundeck_project_status{job_id=...,job_name=...,project_name=...,status=....}
- Removed all gauge metrics rundeck_[services,controllers,api,web]...{type="..."}
- Removed metrics rundeck_system_stats_[cpu,memory,uptime_duration]...
- Removed argument
--rundeck.token. NeedRUNDECK_TOKENenv now. - Removed argument
--rundeck.projects.executions.limit - Removed rundeck_node label from all metrics
- Fixed json response validation
2.1.0 - 2020-11-04
- Added pull request Fixed order labels and values the same way in execution metrics #3
- Fixed issue #2, Long Running Jobs. Added metric rundeck_project_execution_duration_seconds
- Fixed issue #4, Project executions metrics not show all jobs info
2.2.0 - 2020-11-28
- Fixed issue Last Run #5 - Merged @h4wkmoon patch that adds rundeck_project_start_timestamp metric
2.2.1 - 2020-12-15
- Fixed exception messages on failed Rundeck api requests
2.2.2 - 2021-01-05
- Fixed GaugeMetricFamily definition location on method get_project_executions to correctly shows the HELP/TYPE
2.2.3 - 2021-02-26
- Fixed issue invalid API request #10 - Added warning message for API version < 25
2.2.4 - 2021-03-02
- Fixed issue Regarding execution status #11 - Modified GaugeMetricFamily location in the function get_project_executions
2.2.5 - 2021-03-22
- Fixed issue #13 - Added new label execution_id to rundeck_project_execution_status metrics
2.2.6 - 2021-03-31
- Fixed issue #14 - Fixed the info about running status
2.3.0 - 2021-04-15
- Fixed issue #16 - Added options --rundeck.cpu.stats, --rundeck.memory.stats and --version
2.3.1 - 2021-07-28
- PR #19: Added job_group label to job metrics
2.3.2 - 2021-09-24
- Added pip requirements.txt file
- Update .gitignore
- Update Dockefile to use requirements.txt
- Update Makefile to get VERSION from rundeck_exporter.py
- Fixed -h/--help description about required RUNDECK_TOKEN env var
2.4.0 - 202-11-06
- Added Grafana dashboard examples
- Added execution_type and user to rundeck_project_execution_status metrics
2.4.1 - 2021-12-27
- Added docker-compose example
2.4.2 - 2022-02-22
- Added hub.docker.com image build and publish
- Added .gitkeep file
- Update Version and api version unsupported message
2.4.3 - 2022-02-24
- Added rundeck.username and RUNDECK_PASSWORD env support for Rundeck API versions older than 24
- Fixed issue #27 rundeck_scheduler_quartz_scheduledJobs not showing up
2.4.4 - 2022-02-25
- Removed the Rundeck token requiment if username and password options are used
2.4.5 - 2022-03-03
- Added
nodelabel in metrics
- Fixed issue #34 Put RUNDECK_URL into the label instance
2.4.6 - 2022-03-05
- Added
instance_addresslabel in metrics
- Removed
nodelabel from metrics
- Fixed issue #34 Put RUNDECK_URL into the label instance
2.4.7 - 2022-04-20
- Changed the job_execution_duration calc to get info from job attribute
averageDuration
- Fixed issue #40, negative job_execution_duration value
2.4.8 - 2022-05-09
2.4.9 - 2022-05-09
2.4.10 - 2022-06-07
- Cast api_version to an integer by @broferek in #51
2.4.11 - 2022-06-11
- Moved changelogs from README.md to CHANGELOG.md
- Added changelogs version compare links
- Update exporter version
2.4.12 - 2022-07-04
- Fixed issue #55, support for Python 3.6
2.4.13 - 2022-07-19
- Increased project executions max limit results to 250. Details on issue #56
2.4.14 - 2022-07-21
- rundeck.projects.executions.limit argument
- Inaccurate projects executions results, Details on issue #56
2.5.0 - 2022-09-29
- Added new metric
rundeck_project_executions_total
- Fixed issue #59, unable to pass the RUNDECK_PROJECTS_FILTER environment variables
- Fixed issue #65, rundeck_project_execution_duration_seconds metric reporting wrong values. Instead of using the job
averageDurationattribute, now the value is calculated based on thestart timeandend time
2.5.1 - 2023-05-02
- Added VERSION file
2.5.2 - 2023-05-02
- Update Dockerfile and Makefile to support the new VERSION file
- Fixed rundeck_project_execution_duration_seconds metric return values from milliseconds to seconds
2.6.0 - 2023-05-30
- Issue #68, added new argument
rundeck.projects.executions.filter
2.6.1 - 2023-06-01
- PR#70 Removed
recentFilterquery string from/executions/runningendpoint - PR#71 Bumped requests library version to latest stable version that mitigates CVE-2023-32681
2.6.2 - 2023-09-01
- Issue #73, fix VERSION file path.
- VERSION not found in docker image
2.6.2 - 2023-09-01
- Issue #73, fix VERSION file path.
- VERSION not found in docker image
2.6.3 - 2023-11-10
- Added Helm Chart by @nataliagranato in #76
- Issue #77, systemd service doesn't work according to docs.
- Remove VERSION file and keep version in the app.
2.6.4 - 2024-03-05
- Issue #83, added new
--no_checks_in_passive_modeargument andRUNDECK_EXPORTER_NO_CHECKS_IN_PASSIVE_MODE=<False|True>env var introduced to keep the rundeck_exporter idle while the Rundeck host is inpassiveexecution mode.
2.6.5 - 2024-03-11
- Issue #85, added new metric
rundeck_project_nodes_total.
2.7.0 - 2024-04-20
- Added the following new arguments:
-
--rundeck.projects.nodes.info- If passed, display Rundeck projects nodes info metrics, currently only therundeck_project_nodes_totalmetric is available.- Requests for this check are cached as it can cause high CPU load depending on the number of projects.
-
--threadpool_max_workers- The maximum number of workers in the threadpool to run rundeck_exporter asynchronous checks.- Defaults to
(number of CPUs) + 4, which may be too much on a server running other services.
- Defaults to
-
--rundeck.requests.timeout- The maximum number of seconds that requests to the Rundeck API should timeout.- Defaults to 30.
-
- Changed the functions
request_data_fromandcached_request_data_fromtorequestandcached_request, respectively.
- Issue #89, correctly started the
project_executions_totalvariable and also fixed the metric return.
2.7.1 - 2024-05-30
- Fix security issue by avoiding running container as root in Dockerfile by @nataliagranato in #92
- Improve docker build and publish actions workflow by @phsmith in #93
2.8.0 - 2024-08-31
- Issue #97, new rundeck_execution_mode_<active/passive> metrics.
- Update Docker Compose example files.
- Issue #95, improved and fixed the exporter helm chart.
- Issue #98, fixed exception errors when the user does not have the required permissions.
2.8.1 - 2024-09-01
- Return the accidentally removed
no_checks_in_passive_modecondition.
2.8.2 - 2024-09-11
- Issue #101, fix broken validation of boolean environment variables.
2.8.3 - 2024-10-16
- Issue #103, fix boolean env vars broken in Python > 3.12.
2.8.4 - 2025-01-13
- Bump chart version (
0.3.1)
- Helm chart error when using
serviceMonitor.name(formatting error) - Remove default
RUNDECK_TOKENenv variable (default value overrules value from secret if set) - Issue #108, fix Prometheus duplicate metrics error report when
rundeck.projects.executions.cacheoption is enabled.
2.8.5 - 2025-08-07
v3.0.0 - 2025-08-27
- Added pr-checks, relase and update-changelog gh actions
- Added docker-compose-ci.yml
- Added
UVas the default package and project manager - Added test/test_rundeck_exporter_metrics.py
- Added src/rundeck_exporter module
args.py: module responsible for the CLI arguments definitioncli.py: module that initializes the rundeck_exporter command line interface.constants.py: module that stores the app constants.metrics_collector.py: module that handles all the Rundeck metrics collection.utils.py: module containing utilities and middlewares used by the modules.
- Updated docker-compose examples and configs
- Updated README.md
- Removed rundeck_exporter.py. The code was refactored in the
src/rundeck_exportermodule.
Full Changelog: https://github.com/phsmith/rundeck_exporter/compare/v2.8.5...v3.0.0
v3.0.1 - 2025-08-27
- Update pr-checks workflow trigger by @phsmith in #115
Full Changelog: https://github.com/phsmith/rundeck_exporter/compare/v3.0.0...v3.0.1
v3.0.2 - 2025-09-02
- Fix rundeck_exporter_args not properly parsing args by @phsmith in #117
Full Changelog: https://github.com/phsmith/rundeck_exporter/compare/v3.0.1...v3.0.2
v3.0.3 - 2025-11-07
- Fix: rundeck_exporter exits if it is unable to reach the Rundeck host by @phsmith in #120
Full Changelog: https://github.com/phsmith/rundeck_exporter/compare/v3.0.2...v3.0.3