HOME | Library | JRobin API | Utilities | Support | About Us | Forum

Utilities
JRobin MRTG
Inspector
Convertor

# Inspector

(sensitive information removed)

Inspector is a small swing utility usable for RRD files debugging (only RRD files created with JRobin can be inspected). To start it, use the following command:

    java -jar inspector-{version}.jar

Once Inspector is up and runnig, you'll have to select a JRobin RRD file from your local file system. To eliminate a few mouse clicks, you can specify the desired file path on the command line (patch was provided by Pieter Olivier):

    java -jar inspector-{version}.jar path_to_my_rrd_file

Inspector requires the core JRobin library (jrobin-{version}.jar file) to be present in the same directory as inspector.jar. If you move inspector library somewhere else, be sure to copy the core library to the same place.

It's very simple to use inspector... Just choose JRobin RRD file from the 'File' menu and all data from the RRD file will be displayed.

On the left side you will see the complete structure of RRD file in the tree form. Datasource and archive notation is borrowed from RRDTool.

Complete details are shown on the right site in four tabbed panes:

1. General info pane: Contains information about RRD file path, last update time and primary RRD step.

2. Datasource pane: When you select datasource node in the tree on the left side, complete datasource information will be displayed in the datasource pane on the right. This information consists of two parts: datasource definition and its internal state. To understand what internal state variables mean, you'll need to understand the whole concept of JRobin (which is the same as the concept of RRDTool).

3. Archive pane: When you select archive node in the tree on the left side, archive information will be displayed in the archive pane on the right. This information consists of two parts: archive definition and its internal state. To understand what internal state variables mean, you'll need to understand the whole concept of JRobin (which is the same as the concept of RRDTool).

4. Archive data pane: This pane displays archived values with corresponding timestamps and dates for the selected archive node on the left side.

Inspector utility has been greatly improved in JRobin 1.3.0 release (File menu has been extended):

Now you have the possibility to change almost all parameters of a RRD file: you can add datasources and archives, or edit their respective properties (heartbeat, minimum and maximum datasource values, archive sizes and x-file factors). Inspector is also an excellent debugging tool - if you become suspicious if your data gets written to a RRD file, just open the file in the Inspector and check it out.

Back to the top

Copyright © 2003, 2004 Sasa Markovic & Arne Vandamme. All Rights Reserved.