Download Latest Version Rrd2Svg_1_0_1.tar.gz (18.8 kB)
Email in envelope

Get an email when there's a new version of Rrd2Svg

Home
Name Modified Size InfoDownloads / Week
00_README.txt 2017-01-15 2.3 kB
0
Rrd2Svg_1_0_1.tar.gz 2017-01-15 18.8 kB
0
Rrd2Svg_1_0_0.tar.gz 2017-01-12 18.1 kB
0
Totals: 3 Items   39.2 kB 0 
------------------------------------------
$. What is it ?

This project consists of the Java classes that:
1) read the RRD files that are generated by 'collectd'.
2) extract the values and time stamps from each of those RRD file.
3) plot their graph in the form of SVG.

As for RRD and 'collectd', please read:
   http://oss.oetiker.ch/rrdtool/
   https://collectd.org/


------------------------------------------
$. Relationship with RRD4J

To read the RRD files, the classes under:
   src/com/aboutjun/rrd2svg/reader4collectd/
are based on:
   RRD4J
And those source files are covered by the copyright of their authors.

As for RRD4J, please look into:
   https://github.com/rrd4j/rrd4j


------------------------------------------
$. How to use it ?

The main class in this version is:
   com.aboutjun.rrd2svg.util.Runner4Pipe4Svg
It is specified as the main class by the manifest file of the JAR file.

So its usage is:
   java -jar rrd2svg_X_Y.jar <root for RRD> <root for SVG>
where:
<root for RRD> is:
The root directory of the sub directories for the RRD files.
<root for SVG> is:
The root directory of the sub directories for the SVG files.


------------------------------------------
$. Example for how to use it ?

For instance, let's assume:

1) How you configure 'collectd'
You configured the 'collectd' daemon so that it writes the system statistics into the RRD files under:
   /var/lib/collectd/host001
And you specified to gather the statistics for:
   interface-eth0
   memory
   disk-sda

2) What 'collectd' will do
The 'collectd' daemon will create the following sub directories:
   /var/lib/collectd/host001/interface-eth0
   /var/lib/collectd/host001/memory
   /var/lib/collectd/host001/disk-sda
And the corresponding RRD files will be generated under each of these substructures.

3) What you want
You want the graphs plotting the values and the time stamps in those RRD files.
And you want to save them as the SVG files under:
   /home/foo/tmp/svg4rrd

4) What you should do
What you should do is to type:
   java -jar rrd2svg_X_Y.jar \
      /var/lib/collectd/host001 \
      /home/foo/tmp/svg4rrd

5) What you will get
Then, you will find the SVG files under:
   /home/foo/tmp/svg4rrd/interface-eth0
   /home/foo/tmp/svg4rrd/memory
   /home/foo/tmp/svg4rrd/disk-sda
Source: 00_README.txt, updated 2017-01-15