2.1.0

This release includes the following changes:

• Updated project dependencies.
• Standardize multi-arch builds and document supported database versions.
• The metrics override capability is extended, allowing users to redefine individual existing metrics in custom metrics files. This allows users to modify individual default metrics without wholly replacing the default metrics file.
• If the exporter fails to connect to a database due to invalid or locked credentials (ORA-01017 or ORA-28000 errors), that database configuration will be invalidated and the exporter will not attempt to re-establish the database connection. Other databases will continue to be scraped.
• Metrics with an empty databases array (databases = []) are now considered disabled, and will not be scraped.
• Increased the default query timeout for the top_sql metric to 10 seconds (previously 5 seconds).
• Metrics using the scrapeinterval property will no longer be scraped on every request if they have a cached value. This only applies when the metrics exporter is configured to scrape metrics on request, rather than on a global interval.
• Metrics using the fieldtoappend property now support labels. The wait_time and activity default metrics use the fieldtoappend property, and now properly display their labels.
• Fix wait_time default metric to work with Oracle Database 19c.
• Fix an issue where the exporter would unnecessarily scrape metrics with a custom scrape interval.

Thank you to the following people for their suggestions and contributions:

• @romankspb
• @muhammadabdullah-amjad
• @MansuyDavid
• @borkoz
• @ristagg

2.0.4

This release includes the following changes:

• Added WARN logging when database configurations are duplicated in the exporter configuration.
• Added INST_ID to gv$ query metrics as a label.
• Fixed multiple concurrency bugs when the exporter is connected to multiple databases and using a custom scrape interval.

Thank you to the following people for their suggestions and contributions:

• @Supporterino
• @msafdal
• @aberinnj

2.0.3

Version 2.0.3, August 27, 2025

This release includes the following changes:

• Enable configuration of the prometheus webserver from the config file using the web prefix.
• Allow loading of database password(s) from a file.
• Fixed a bug where database type (CDB, PDB, etc.) was not reported in certain situations.
• Fixed a bug where literal passwords containing the '$' character (in the config file) would be evaluated as environment variables. To use literal passwords with the '$' character, escape the '$' character with a second '$': $test$pwd becomes $$test$$pwd.
• Fixed a bug when using metrics.scrapeInterval combined with per-metric scrape intervals that made the available metrics data set inconsistent.

Thank you to the following people for their suggestions and contributions:

• @Supporterino
• @neilschelly
• @aberinnj
• @redelang
• @qrkop
• @KevDi
• @bomuva
• @anilmoris
• @Sycri
• @kizuna-lek
• @rfrozza
• @neilschelly

2.0.2

This release includes the following changes:

• Fixed a case-sensitive issue with resource name in the default metrics file.
• Add query timeouts to initial database connections, which could cause the exporter to hang in multi-database configurations
• Fix an issue where rapidly acquiring connections could cause the exporter to crash. This was more common in multi-database configurations, due to the increased number of connection pools.
• Update some third-party dependencies.

Thank you to the following people for their suggestions and contributions:

• @rfrozza
• @neilschelly
• @rafal-szypulka
• @darkelfit

2.0.1

This release includes the following changes:

• Use gv$ views instead of v$ views to allow collection of metrics from all instances in a cluster. (In preparation for RAC support).
• Update some third-party dependencies.

2.0.0

This release includes the following changes:

• Fixed an issue with scrapeinterval that could cause metrics not to be scraped (#172, #176).
• Added configuration through a YAML file, passed using the --config.file command-line argument. Backwards compatibility is maintained for the command-line arguments, through it is recommended to use the configuration file from the 2.0.0 release onward. It is not recommended to use a combination of command-line arguments and the configuration file.
• Added support for multiple databases through the configuration file. As many database instances may be specified as needed, which will be scraped concurrently (#89).
• Updated provided dashboards.
• Updated some third-party dependencies.

1.6.1

This release includes the following changes:

• Updated some third-party dependencies.

Thank you to the following people for their suggestions and contributions:

• Deepak A.

1.6.0

This release includes the following changes:

• Added support for Azure Key Vault (#200).
• 4Aiur added missing grants for alert log to the demo environment (#207).
• Updated some third-party dependencies.

Thank you to the following people for their suggestions and contributions:

• Brian, Damian et al.
• 4Aiur

1.5.5 (#198)

This release includes the following changes:

• @VictorErmakov updated the docker-compose sample with connection pool parameters to avoid fast connect cycling (#191).
• Update default values for connection pool parameters to use go-sql pooling by default to avoid fast connet cycling.
• Updated some third-party dependencies.
• Updated TxEventQ load generator utility.

Thank you to the following people for their suggestions and contributions:

@VictorErmakov

1.5.4

This release includes the following changes:

• Based of this recommendation from godror, which relates to the two following items, and in discussion with the ODPI-C team, we have introduced additional parameters to allow you to set connection pool parameters, and have set defaults which will avoid fast connect cycling. It is our expectation that a fix may be produced in the underlying ODPI-C library for the underlying issue. In the mean time, these changes will avoid the conditions under which the error can occur.
• Fix malloc error (#177, #181).
• Fix intermittent connection issues with ADB-S when exporter is run in a container (#169).
• Fix Multiple custom metrics files overwrite one another (#179).
• Replace go-kit/log with log/slog, due to upstream changes in prometheus/common.
• Add support for additional admin roles, expanding list of options for DB_ROLE to SYSDBA, SYSOPER, SYSBACKUP, SYSDG, SYSKM, SYSRAC and SYSASM (#180).
• Updated some third-party dependencies.

Thank you to the following people for their suggestions and contributions:

• @Jman1993
• @oey
• @jlembeck06
• @Jman1993
• @PeterP55P
• @rlagyu0
• @Sycri

Thank you to @tgulacsi for changes in godror (godror/godror#361, godror/godror#360), and to @cjbj and @sudarshan12s for support and guidance from ODPI-C (https://github.com/oracle/odpi).

In this release, we also continued some minor code refactoring.