Version Information

New Features

TSM-5364 Grafana Extension: Support for Grafana 11

Breaking Changes

The following parameters have changed and require migration:

The search.name parameter has been deprecated. Use the searchNames (or in legacy search objects: search.names) parameter instead.
In annotations the formula object (formula: { formula, interval, intervalMultiplier}) has been flattened, so that annotation queries are compatible with metric queries. As such formulas in annotations requires the following migration path:
- formula.formula → annotationFormula (or annotationQuery.formula in legacy annotationQuery objects)
- formula.interval → annotationInterval (or annotationQuery.interval in legacy annotationQuery objects)
- formula.intervalMultiplier → annotationIntervalMultiplier (or annotationQuery.intervalMultiplier in legacy annotationQuery objects)

Non-breaking Changes with Migration Recommendation

The following parameters will still work, but will not be shown in builder mode, hence a migration is recommended for best user experience:

search object each property of the object shall be directly referenced as search<OldPropertyName>. Example: search.orderBy > searchOrderBy
columns object: each property of the object shall be directly referenced as columns<OldPropertyName>. Example: columns.allAttributes > columnsAllAttributes
treeNodeSum object: each property of the object shall be directly referenced as treeNodeSum<OldPropertyName>. Example: treeNodeSum.includeSum → treeNodeSumIncludeSum
annotations object: each property shall be directly referenced as annotation<OldPropertyName>. Example: annotation.timeseries > annotationTimeseries

To migrate old payloads and annotation payloads to new builder mode capable payloads, you may use the following extension endpoints:

POST baseUrl/extensions/grafana/payloadconverter: post an old payload within the body, the endpoint will return the migrated payload
POST baseUrl/extensions/grafana/annotationpayloadconverter: post an old annotation query within the body, the endpoint will return the migrated payload

Obsolete Parameters

The following parameter is obsolete and marked for deprecation with the next release: timeseriesNames.

Please use one of the following parameters instead:

Use searchNames parameter with a list of time series names to be combined with additional search parameters and ad hoc filters.
Use searchExactNames parameter with a list of time series names to be added to the metric query on top, disregarding any other search or filter parameters.

TSM-5876 Support for the Latest Database Versions

The latest database versions are now supported:

Oracle 23ai
SQL Server 2022
PostgreSQL 16

TSM-6353 TSM App: Reporting Functions for the TSM+

The reporting functions now also work in TSM+.

TSM-6321 WebTSM Services: Ability to Query Multiple Quotations for Multiple Time Series

A new endpoint has been added to allow querying data for multiple quotations for one or more time series in a single request: GET /repositories/{repository}/timeseriescollections/data/quotations

For further details, please refer to the Open API specification for the new request: Open API Reference

Fixed Bugs

TSM-6213 Error When Upgrading an Oracle Database Created With the Very First Initial Script

If an Oracle database was created with the very first initial script, an error occurred when upgrading to version 3.8.7 because the precision of a field was greater than expected.

This error has now been fixed.