October 2023 Dashboard Release Notes
Release Name | Release Date | Description |
---|---|---|
pi.2023_10 | Oct 31, 2023 | Initial Release |
We have several ways that you can get hold of the latest release - see our Download Options page for more details.
Before upgrading, we always recommend that you review ALL release notes, from the version you are considering upgrading from and to. This is essential should there be a material change that could impact you or your customers. We always advise that you take a backup of your repository before beginning an upgrade and recommend testing out the new software on a test environment first.
We are pleased to present our latest offering of pi - our October 2023 product release! This page helps summarise the areas of the dashboard we have Added, Changed, or Fixed meaning you can make a quick and informed decision on when to upgrade to the latest release.
Here is what is included in the release.
- 1 Product Release
- 1.1 Added
- 1.1.1 ‘Drill to top on full screen close' Chart Attributes option now supports 'Drill to Chart’
- 1.1.2 Setting drill Start and End levels when embedding a chart
- 1.1.3 Automatic removal of Tomcat log files based upon a new setting
- 1.1.4 Redis support for session storage
- 1.1.5 Improved error handling in the Scheduler service
- 1.2 Changed
- 1.3 Fixed
- 1.1 Added
Product Release
Added
‘Drill to top on full screen close' Chart Attributes option now supports 'Drill to Chart’ | #2054 | 28024 & 25474 | Drill Down |
---|
The ‘Drill to top on full screen close’ option (introduced in our September 23 release) now supports the ‘Drill to Chart’ option.
Now, once this option or the related ‘Full screen to display this level’ are set to True that drill level and any below it will reflect that behaviour - even if you have drilled to another chart.
The two fields are now independent of one another. When editing a chart, you will be able to tell when a drill level has one/both settings overridden by a higher drill level as they will be disabled, appear as checked, and a warning icon with a helpful, on-hover tooltip will be displayed next to them.
Please note, the field appearing as checked when disabled does not relate to its value in the database it is a visualisation of the expected behaviour.
Setting drill Start and End levels when embedding a chart | #1892 | 26827 | Embedding |
---|
It is now possible to set a Start and End drill level that a user can see when viewing a chart - when embedded.
As an example, where a chart has 5 drill levels, it would be possible to have some users that can see levels 2-4. When skipping the top levels, no filter will be applied to the chart that is seen by the user.
You can set the values for drillStart and drillEnd as query parameters on the URL that you are using to embed.
When setting a drillStart you will also need to supply the identifiers for the chart and hierarchy levels of the drill levels above the start, and the drill level you wish the user to see by manipulating the URL directly.
These must be separated by the !$! delimiter when adding multiple levels. When drilling to the top, the user will return the level defined as the drillStart parameter. It is possible to use the parameters individually or together.
The parameters are 0 indexed - with the first hierarchy in the chart corresponding to drill level 0.
The functionality will also work for dynamic drill conditions.
The below URL would allow the user to see drill levels 1, 2 and 3 (i.e the 2nd, 3rd and 4th hierarchy levels) of the chart:
http://localhost:1234/pi/chart/?drillStart=1&drillEnd=3#chart-filter/251__1/d-f-p=251__0/!$!251__1
*Location and syntax of the query parameters.
*Example of identifiers added to view level 1 (2nd hierarchy level) of the given chart.
Further documentation on restricting drill levels when embedding charts can be found on our Embedding pages.
Automatic removal of Tomcat log files based upon a new setting | #1883 | 25355 & 26671 | Logging |
---|
Tomcat logs can now be set up to automatically be removed after a certain number of days. This behaviour is administered by a new setting that can be defined within;
Under the Tomcat tab of the Configuration-Tool GUI under a new ‘Logging’ section (see picture below)
Under the Tomcat > Logging section of the dashboard.json file
Set via the PI_TOMCAT_LOGGING_MAX_AGE environment variable
This new setting also dictates the turnover of a new, daily rotating log file name out.{date}.log.
This new file is where log messages from the Dashboard are written. The default value for this setting is 0 which means that no logs will be removed.
Redis support for session storage | #2003 | - | Scaling |
---|
To enhance our scaling capabilities, we now have support for using Redis to store session data. This allows you to run multiple Dashboard instances in a load balanced environment with a single, fast store of session data. The configuration for this is done via environment variables or in the configuration tool, and you can choose no session sync, tcp session sync which uses Tomcat’s built in sync or Redis where the session storage is fully offloaded to Redis.
This is configured via the configuration tool (Windows, Linux) or environment variables (containers).
For environment variable usage the following variables are required:
PI_TOMCAT_ENABLE_SESSION_SYNC: "true"
PI_TOMCAT_SESSION_SYNC_MODE: redis
PI_TOMCAT_SESSION_SYNC_REDIS_HOST: REDIS_HOST
PI_TOMCAT_SESSION_SYNC_REDIS_PORT: 6379
PI_TOMCAT_SESSION_SYNC_REDIS_PASSWORD: REDIS_PASSWORD
Improved error handling in the Scheduler service | #25885 | - | Scheduling |
---|
Error handling for the scheduler service has been improved to better direct you to issues when a schedule is not sending correctly. The scheduler will now correctly inform you of the following issues:
Attached chart having an issue with a data connection.
Attached chart having a SQL error.
User doesn't have permission to view an attached chart.
Failure associated with saving attachments to a directory.
"Other" chart specific errors.
Changed
Container images rebased and updated, to fully maintained versions | deployment#62 | - | Containers |
---|
To resolve reported vulnerabilities in the base used for our container images, all supported images have been either updated or rebased to resolve these issues. As a result of using more lightweight base images over 150 MiB has been saved from the images.
Driver Update - Athena | deployment#81 | - | Dependencies |
---|
The Athena JDBC driver (provided by Amazon) has been updated to address reported vulnerabilities.
3rd Party Library Update - JDom, AWS Marketplace & JAVA SAML | #2042 | - | Libraries |
---|
JDom, AWS Marketplace and Java SAML libraries have been upgraded to remain updated with the latest features, and to address reported vulnerabilities.
Fixed
Incorrect label for Category panel unpin | #2022 | - | Category Panel |
---|
The Category panel unpin label/description was incorrectly worded, which has been rectified as per the image below.
Embedding two categories in 1 html pages causes conflicts with the category mode | #1557 | 26883 & 23204 | Embedding |
---|
When embedding 2 categories within 1 html page, with 2 different category modes, the category modes would conflict and result in inconsistent behaviour. The result being that sometimes it would incorrectly use the same category mode for both embedded categories.
Failed to load time zone, defaulting time zone location to UTC | scheduler#64 | 25885 & 25900 | Scheduler |
---|
When running the dashboard on Windows, the Scheduler was unable to pick up and use the correct time zone. This meant that the times in the monitoring screen were incorrect, and the scheduler logs would fill up with errors.
Single Chart Mode - Encoding format URL feedback | #2065 | - | Embedding |
---|
An incorrect encoding format was being applied to the URL feedback snack bar, when using single-chart mode. The resolution helps improving both the security and user display experiences.
CUSTOMER NEWS - Our August 24 Release Is Now Available - Download It Now!