Overview of Historian for Linux

Historian for Linux is a high-performance timeseries database designed to store and retrieve time-based information at a high speed. It runs on the Linux platform using Docker.

Historian for Linux is a collection of several Docker images such as the Historian database, REST query, web admin, public REST APIs, and various Historian collectors.

Advantages of Using Historian for Linux

  • Time series data archiving
  • REST API for data query: Data query REST APIs are exactly the same as the Predix time series REST APIs.
  • Web admin: An administrative console to work with the Historian database.
  • OAUTH2 integration: The web admin, tuner, REST query, and public REST APIs leverage OAUTH2-based authentication and authorization.
  • Collector toolkit library: Used for implementing collectors that ingest data into Historian for Linux.
  • User API library: A C library for programmatically adding, deleting, and configuring tags for collectors.
  • Server-to-Server collector: Stream data of one Historian to another Historian or to Predix Time series. It helps in data filtering.
  • OPCUA DA collector: Collects data from an OPCUA DA server and ingests the data into Historian.
  • MQTT collector: Subscribes to an MQTT broker and ingests the data into Historian. This collector helps to integrate Historian for Linux with the data bus of Predix Edge.
  • Configuration: You can also change the configuration properties of the various applications such as the Historian database, web admin, tuner, REST APIs, REST query, and the various collectors using the JSON files provided with each application.
  • Public REST APIs: Query data from the Historian for Linux archives. The APIs use a Docker container on a Linux machine. They use the port number 9090 for REST client requests.


  • Input to the MQTT collector must be in the time-series format.
  • The protocol adapters must use the flat_to_timeseries block to translate the data to the required format before adding the data to the MQTT broker.
  • Historian for Linux only supports message IDs, not messages.

Supported Operating System Platforms

Any x64 based Linux machine or a Linux virtual machine with Docker installed.