Factry Historian Datasource for Grafana

always check the compatibility matrix below before installing a new version compatibility matrix this is the compatibility matrix for version listed on this page if you have downloaded a newer version than the one listed on this page please check the release notes of that version historian grafana datasource version compatible factry historian versions <= v1 2 x <= v6 3 x >= v2 x > v6 3 v3 3 0 released 11/08/2026 changes the asset tree cascader loads nodes on demand instead of fetching the whole tree up front, which keeps the asset pickers responsive on large trees requires historian v8 2 0 or later; earlier versions keep loading the tree eagerly requests to the historian api identify themselves with a user agent of factry historian datasource/\<version> historian failures are reported to grafana as downstream errors carrying their original status code, so a 429 or a 504 is no longer attributed to the plugin bug fixes fixed regex input disappearing in every field that accepts a regex fixed the event property pickers offering parent properties that cannot match when the event type is selected through a template variable, and fixed the parent property datatype falling back to number in that case, which made the query fail fixed template variables not being interpolated in event query options, event filter statuses and asset properties fixed a template variable that resolves to an empty value being sent as an empty query parameter, which historian v8 2 and later reject the filter is left out of the request instead, matching the behaviour before v8 2 tightened validation fixed a chained variable listing every measurement, asset property or event type property when its parent variable resolved to an empty value, instead of listing nothing fixed asset property value parsing, and derived the asset property column type from the named value field fixed asset property values being appended twice when a query returned multiple frames fixed an event with a parent reference but no parent data failing the query fixed parent stoptime being written to the event labels instead of the periodic column labels fixed unknown event property datatypes failing instead of falling back to a nullable string column fixed duplicate asset properties in measurement selection fixed the prepended last known point being removed from frames that never received one fixed a serieslimit of zero or less being applied as a limit instead of meaning unlimited fixed the timeout, query timeout and skip tls verify settings not being applied to the historian client fixed percent escaped path segments being decoded when the historian url contains a path prefix fixed the organization field in the datasource configuration reusing the url field's name attribute fixed tag queries using a regex operator the api does not support fixed feature detection treating an unknown historian version as supported, and corrected pre release version comparison hardened variable queries against unknown query types, legacy migrated property filters and filters modified in place hardened query and frame handling against empty frames, missing aggregations, a zero query interval, out of range periodic values and frame merges with differing field counts misc added an end to end testing framework updated dependencies v3 2 1 released 11/05/2026 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 released 05/05/2026 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 released 22/04/2026 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 released 06/03/2026 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 released 05/03/2026 ⚠️ 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 released 17/12/2025 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 released 21/10/2025 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 released 11/08/2025 bug fixes fixed dashboard variables of type event property values not being migrated correctly and breaking dashboards v2 3 0 released 27/06/2025 migrating from an older version to v2 3 0 has the possibility to break dashboards that have variables of type event property values to mitigate, upgrade to v2 3 1 or later 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 released 22/02/2025 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 released 18/11/2024 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 released 26/09/2024 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 released 02/08/2024 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 released 04/07/2024 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 periodic values in the event query optionally query asset properties in the event query improved error handling