Plugins 〉Factry Historian Datasource


Developer

Factry


Sign up to receive occasional product news and updates:



Data Source
commercial

Factry Historian Datasource

  • Overview
  • Installation
  • Change log
  • Related content

Factry Historian Datasource

Grafana datasource for Factry Historian.

Introduction

Empower anyone to analyze industrial process and event data with Grafana. The Grafana Data Source for Factry Historian makes it easy for users to browse assets, trend time-series and event data such as batches or shifts – with zero technical skills required.

Typical use cases

  • Browsing your asset structure (e.g. ISA88/ISA95 equipment model)
  • Trending time-series data, while auto-configuring units of measurement
  • Overlaying of events (e.g. golden batch analysis)
  • Ad-hoc overlaying of time-series data on top of events

Features

  • Query historical data using the asset tree defined in Factry Historian
  • Query historical data using measurements from Factry Historian
  • Autoload Units of Measurement, Y-axis scaling and HI/LO boundaries
  • Query Events from Factry Historian (e.g. batches, CIP cycles)
  • Annotate trends with Event data from Factry Historian
  • Use assets, measurements and events from Factry Historian as variables to build dynamic dashboards

Installation

A full step-by-step guide can be found in the 'Installing Factry Historian Datasource' Tutorial.

Install using the grafana-cli or by cloning the repository directly into the Grafana plugins directory.

grafana-cli plugins install factry-historian-datasource

Configuration

Create a new instance of the data source from the Grafana Data Sources administration page. And configure the necessary settings.

Datasource_configuration

  • URL: The URL of the Factry Historian API.
  • Token: The API token to authenticate with the Factry Historian API.
  • Organization: The UUID of the organization to query data from.
  • Default tab: The default tab to show when opening the query editor.

Documentation

Full documentation can be found at the Factry documentation site: https://docs.factry.cloud/docs/grafana-datasource

Installing Factry Historian Datasource on Grafana Cloud:

For more information, visit the docs on plugin installation.

Changelog

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 periodic values in the event query
  • Optionally query asset properties in the event query
  • Improved error handling