Managing the Historian Using JMX

The Historian is instrumented with JMX to allow you to manage and monitor application settings. To enable JMX, you must run the Historian using the -jmxport command line option:

-jmxport:(port number) 

The JMX Monitor demo, located in demos\jmxmonitor in your RTView installation, shows how to use RTView to monitor the Historian using JMX.

The Historian contains one MBean named RTViewHistorian:name=Manager with the following methods:

Method/Attribute

Type

Description

DataConfigurationFileInfo

TabularData

For each Data Configuration File, the table contains the following columns:

File Name - Name of the Data Configuration File.

Last Access Time - Last time this file was accessed.

Substitutions - Substitutions applied to the Data Configuration File.

NumberOfDataConfigurationFiles

int

Number of data configuration files in use.

HistorianSuspended

boolean

True if the Historian is currently suspended (i.e.: not storing data), false otherwise.

The RTViewHistorian:name=Manager MBean also supports the following commands:

Method/Attribute

Description

killHistorian

Exit the Historian.

purgeHistoryData

Clear out tables (numeric and string).

resumeHistorian

Start storing data.

suspendHistorian

Stop storing data.