Changelog

v3.2.1

Bug fixes

• Replace limit number inputs with text inputs again
• Fix max values default being set to a low value
• Prevent datasource from trying to use unsupported asset API features when connecting to older Historian versions

v3.2.0

Changes

• Added a frame format option to control the shape of frames returned by queries.
• Changed the default event annotation query to ascending order, which better handles events without a stop time.
• Batched UUID asset lookups into a single request to reduce backend load.

Bug fixes

• Fixed the last-known point being dropped when its type differed from the result series.
• Fixed parent event asset name and path resolution when including parent info in event queries.
• Fixed asset measurement queries returning only one result when multiple properties linked to the same measurement.
• Fixed asset property names containing commas being split into separate properties, and ensured Grafana's legacy [[var]] multi-value syntax expands correctly.
• Fixed limit field defaults not being initialised in explore views, which caused invalid queries.
• Fixed No parent no longer being displayed when reloading the Asset Variable editor.

v3.1.0

Changes

• Add support for using variables in all free-form text inputs
• Change limit number inputs to combobox
• Sort frames in a query result by name to ensure consistent ordering in the frontend

Bug fixes

• Fixed using variables in SQL expressions.

Misc

• Updated dependencies to address security vulnerabilities.
• Added frontend unit tests and configured jest.

v3.0.1

Bug fixes

• Fixed an issue escaping special characters when calling the historian API
• Fixed the asset selection cascader only showing root level assets

v3.0.0

⚠️ Breaking changes

• Dropped support for Grafana versions earlier than 11.0

Changes

• Improve handling of dimension event properties in event queries when also querying asset properties
• Added options to order time series and events queries by both ascending and descending time
• Performance improvements when editing panels with multiple queries

Bug fixes

• Fixed regex selection for measurements not always working correctly
• Filter out UUIDs from other datasources in query displays
• Fixed possible panic in the event query
• Sort labels to ensure consistent ordering of series in the frontend

v2.4.0

Changes

• Added option to align the start of an aggregation to the start of the query interval or to the truncated aggregation interval.
• Added option to override limit filter for measurement queries in dashboard variables.
• Updated the max measurements setting for measurement queries to be unlimited if set to 0.

Bug fixes

• Avoid duplicate columns when a parent event has the same periodic property as the child event in event queries.

v2.3.2

Bug fixes

• Fixed an issue where dashboard variables of type Event Property Values could break if the configured Event Type was also a variable.

v2.3.1

Bug fixes

• Fixed dashboard variables of type Event Property Values not being migrated correctly and breaking dashboards

v2.3.0

Changes

• Changed minimum Grafana version to 10.4.0
• Added support for time weighted average aggregation for historian version v7.3.0 and later.
• If no asset properties are selected in the assets query editor or in the events query editor, the query will now return data for all asset properties instead of no asset properties
• Changed default unit for event duration column to use dtdhms format
• Refresh data from Factry Historian when opening a selection field instead of only on dashboard load
• Added keyword and datatype filter for asset property variable query editor
• Debounce keyword searches in variable query editors to reduce query load
• Show asset path in asset property variable query editor to help distinguish between properties on assets with the same name but different paths
• Added a configurable limit to the events query editor to limit the amount of events returned, default is 1000, 0 means no limit
• Allow to select which parent event properties to include in the result and allow to filter on them
• Added event duration filter to the event query editor, also works with parent events
• Allow use of dashboard variables in measurement regex queries
• Moved settings related to aggregations and grouped them together
• Added filtering on datatypes for measurement, asset property and event type property queries
• Added an Override time range option to the event query editor
• Enabled support for sql expressions
• Filter out selected event types and asset properties when changing the selected assets
• Add the option to override assets to select asset properties on in the event query editor

Bug fixes

• Fixed multi value filter for the event property values query
• Updating the selected databases in a measurement query will now correctly update the available measurements
• Fixed the display name for raw queries
• Fixed an issue when selecting parent event properties in the event query editor
• Don't show an error if the query returns no results
• Fixed UoM not being set for asset properties in event queries
• Fixed the use of dashboard variables in event property values variable queries
• Fixed a potential panicy race condition in the query handler that could be triggered by executing multiple queries.

v2.2.0

Changes

• Introduced the ability to include parent event information in event queries.
• Implemented support for event property value filters compatible with v7.2.0.
• Added an option to only return changed values in measurement queries.
• Added support for event properties with dimensions in event queries.
• Description of measurements and or asset properties are now available as labels in query results.

Bug Fixes

• Checked the validity of regular expressions before sending them to the historian.
• Fixed issues with custom interval selection in the event query.
• Fixed an issue where modifying a duplicated panel could impact the original panel.

v2.1.0

Bug Fixes

• Resolved issue where only one result was returned when multiple assets were queried in the asset property query.
• Corrected results for asset property queries using a regular expression.
• Ensured re-rendering after mount completion in the query editor.
• Fixed saving of Grafana variables in annotation queries.
• Addressed issue where aggregation reset to 'last' instead of clearing.

Changes

• Enabled aggregation over the entire time period of a dashboard.
• Added variable query for distinct event property values (requires historian > v7.2.0).
• Introduced support for value filters in time series queries (requires historian > v7.1.0).

v2.0.4

Changes

• Fixed logo in the README.
• The datasource now detects the running version of the historian and adapts to the available features.
• Error messages are now more descriptive.
• Enhanced units for event duration.

Bug Fixes

• Resolved styling issue with the dropdown cascader in the asset property query editor.
• Resolved an issue where the repeat by variable feature was malfunctioning.

v2.0.3

Changes

• Fixed filtering of event types in the event query when using a regular expression for the assets
• Fixed event queries when filtering on multiple statuses

v2.0.2

Changes

• Added 'first', 'last' and 'count' as aggregation options for array datatypes
• Fixed event property type selection
• Fixed broken link in the README
• Reworked introduction in the README

v2.0.1

Changes

• Pass datasource request context to the historian client
• Automatic instance management for data source
• Removed pprof code

v2.0.0

Changes

• Enabled annotations for events
• Added dashboard variable query editors for: measurement, databases, assets, asset properties, event types and event type properties
• Improved support for dashboard variables
  • Can use everywhere where it makes sense
  • Multi-value supported
• Reworked measurement selection, using a regular expression is now a toggle
• Fetch tag keys/values from the historian
• Support valid values in the event query
• Optionally query asset properties in the event query
• Improved error handling