v0.9.4 - Fix windows executable build and other bugs

After playing around with the windows executable, I recognized, that it is not working as it should… So I worked on this release.

• bugfixes
  • ensure that ZIP file extension is used always, if a ZIP is created
  • ensure that files are properly stored in ZIP file, which was not the case for the windows executable
  • fixed a bug during demo report creation, which lead to exceptions, when dashboards contain Prometheus queries
  • handle grafana alert datasource 404s properly
  • handle queries, which have no targets configuration
  • print warning if a dashboard variable is not supported, instead of a debug message
• nerd stuff
  • introduced automated tests for windows executable

Hope you enjoy it!

v0.9.3 - Add API service endpoint, support subpaths

Thanks for your feedback, which finally lead to this new release!

• new features
  • added API endpoints to integrate the reporter in your toolchain; details are explained in the README.md (#54)
  • reporter webservice (and also the new API endpoints) can now be called from any subpathes (#55)
• bugfixes
  • rendered ERB templates always received .zip extension on downloading, which was definitely wrong. Now we use the default_result_extension configured in the report class, which is the better choice also for custom report classes (#51)

Enjoy!

PS: Because of test issues in the build pipeline, I had to skip previous 0.9.x releases to keep a concise version numbering.

v0.8.0 - Add disabling SSL checks, modified query result transformation, support new ruby versions

Thanks for your feedback, which finally lead to this new release!

• new features
  • the configuration wizard now supports accessing grafana, also with unsigned and invalid SSL certificates (#48)
    • the configuration wizard now checks, if your grafana is using a valid SSL certificate:
      • If this is not the case (e.g. it is self-signed), it provides you the possibility to configure your self-signed certificate file.
      • If this is also not working for your installation (e.g. the certificate is expired), it also allows disabling any SSL check. Anyway, you should NOT use the disabling over unsecure channels, as e.g. the internet.
  • By having the new options for configuring SSL through the wizard in the configuration file, the --ssl-cert command line option has now been removed (which was anyway not reasonable, as the reporter supports multiple grafana deployments within the same report, but those grafana deployments can for sure have different certificates...).
  • the default behavior of calling the query value transformations in the order: format, replace_values, filter_columns, transpose can now be changed, by specifying the order in after_fetch (which is being called directly after the query results have been received from the database; default: filter_columns) and after_calculate (which is being called after value calculations as e.g. select_value have been applied; default: format,replace_values). To get the previous behavior, you might set the configuration as after_fetch="",after_calculate="format,replace_values,filter_columns,transpose".
  • a new transformation transpose! (with an exclamation mark!) has been introduced in addition to the existing transpose. The new transformation will always enforce to transpose a query, independent of the additional configuration transpose=true, which is required for the old transpose transformation. I am not so happy with this change, but at least it ensures backward compatibility...
• improvements
  • windows executables are now built with standard AppVeyor ruby versions (currently ruby 3.2.4), to reduce potential security issues with old versions
  • issues, which might happen because of impossible value translations of replace_values (e.g. applying float formatting on a string value) now won't destroy your reports anymore, but will keep the database result instead in the report. From now on, you only receive a warning on the console log.
• bugfixes
  • fixed several bugs, which occured because of supporting newer ruby versions

Enjoy!

v0.7.0 - Improved demo report creation and added select_value option

I was struggling, if I make this a minor or major update. In the end, it doesn't matter: it should be now much more easy, to use the ruby-grafana-reporter!

• breaking changes
• new features
  • added option select_value for grafana_panel_query_value and grafana_sql_value to specify the desired return value. It supports min, max, avg, sum, first, last
• improvements
  • added an animated gif to the readme, which hopefully helps new users to understand on how to use the ruby-grafana-reporter
  • demo report now is now creating with more content, also for very light dashboards, to support better understanding for new users
• bugfixes
  • fix regexp to escape '+' symbol in positive delta times such as e.g. now/h+8h, which lead to an infinite loop (#47)
  • grafana_sql_table and grafana_panel_query_table were not creating any demo entries... this is not fixed
  • fixed build pipeline

Enjoy!

v0.6.6 - Support influx in newer grafana versions and added 'render-scale'

This release contains some improvements and bugfixes, mostly mentioned by you. Thanks for staying with me!
Don't worry about the missing releases - I mistakenly created intermediate releases, which should not have been done.

• breaking changes
• new features
  • now supports option render-scale (#44)
  • supports InfluxDB now for Grafana versions >= 8 (#42)
• improvements
  • explanations in documentation are overworked
  • error messages clarified
  • moved from ocra to ocran to support newer ruby versions
• bugfixes
  • timeout handed over for image renderings are now also forwarded to the webrequest (#45)
  • fixed build pipeline

Looking forward to your feedback!

v0.6.3 - Avoid errors with nil datasources and improved error messages

This release contains a bugfix and further improved debugging capabilities.

• improvements
  • shows whole stacktrace on internal errors
• bugfixes
  • removes nil datasources from grafana datasource array to avoid exceptions including a proper warning message (#35)

If you see FATAL errors when using the reporter, you should definitely move to this version.

Happy to hear your feedback!

v0.6.2 - Support new datasource API for SQL databases

This release adds support to the new datasource API for SQL databases.

• bugfixes
  • SQL queries now support new API endpoint, when using Grafana >= 8.x (#31)
• nerd stuff
  • setup a complete automated build pipeline to reduce efforts for testing in multiple environments and releasing properly

Awaiting your feedback!

v0.6.1 - Bugfix and improved debugging capabilities

This release is mainly intended to debug specific bugs and therefore provides extended debugging capabilities and minor bugfixes.

• improvements
  • adds option verbose_log="true" as option for queries, which prints additional information about query results to the log
  • added grafana_value_as_variable as well as include_headline to the functional documentation
• bugfixes
  • some queries could not be executed, because of wrong evaluation of headlines (#31)

Hopefully this supports debugging us in debugging the issues :-)

v0.6.0 - adjust version dependencies and add support for new prometheus queries

This release updates all dependencies to current docker asciidoctor release, which means Ruby >=2.7 at least.
The main reason for this release anyway was to add support for newer prometheus queries since grafana 7.5.x and to hunt down current bugs reported.

• improvements
  • adjust dependencies to match current docker asciidoctor release
  • add support for prometheus queries for grafana >= 7.5.x
  • datasources now receive information about the used grafana version, so that different handling is possible for different grafana versions
• bugfixes
  • handle properly, if an unsupported variable is used on a dashboard - anyway queries which rely on this, won't run properly, but other queries can be used without any issues
  • handle issue if datasources are nil - which should never happen, but did in bug #29. A message is added to the logs giving more details for a future final fix

Enjoy!

v0.5.4 - Critical bugfix release

This release fixes a critical bug introduced with v0.5.3.

• bugfixes
  • panels using the default datasource could no longer be rendered