Custom archives

Values are stored in JRDS in rrd files, using RRD4J. This storage uses the same concept than rrdtool. They are organized in RRA (Round Robin Archives).

JRDS uses a default RRA set that is:

  1. aggregate function: average, xff: 0.5, steps: 1, rows 25920
  2. aggregate function: average, xff: 0.5, steps: 12, rows 8760
  3. aggregate function: average, xff: 0.5, steps: 288, rows 730

With a 5 minutes step, those rows keep values for 3 months, one year and two years.

Not everyone might agree with those values and some may want to change it.

It's possible to change the default archives or for any probe.

A archive set must be declared in a XML configuration file.

The default archives to be used can be changed in the jrds.properties file using the key archivesset that give the name of an archives set.

For each probe, the archives set to use can be changed with the probe attributes archivesset.

The DTD for the XML archives set is :

<?xml version="1.0" encoding="UTF-8"?>
<!ELEMENT archivesset (archive+)>
<!ATTLIST archivesset name CDATA #REQUIRED>
<!ELEMENT archive (consolFun, xff, steps, rows)>
<!ELEMENT consolFun (#PCDATA)>
<!ELEMENT xff (#PCDATA)>
<!ELEMENT steps (#PCDATA)>
<!ELEMENT rows (#PCDATA)>

The archive XML file for the default archives set is :

<archivesset name="_default_">
    <archive>
        <consolFun>average</consolFun>
        <xff>0.5</xff>
        <steps>1</steps>
        <rows> 25920 </rows>
    </archive>
    <archive>
        <consolFun>average</consolFun>
        <xff>0.5</xff>
        <steps>12</steps>
        <rows>8760</rows>
    </archive>
    <archive>
        <consolFun>average</consolFun>
        <xff>0.5</xff>
        <steps>288</steps>
        <rows>730</rows>
    </archive>
</archivesset>

A archives set changed in a probe will be like that :

<probe type="IpSnmp" archivesset="toto"/>
 
archives.txt · Last modified: 2014/03/27 10:53 by root     Back to top