FIDO: RRD writing

FIDO: RRD writing
As of 2018, writing it split away from FIDO specifically and is now called ns-rrd-writer.
 

A properly formatted status file will cause information to be written to RRDs by the ns-rrd-writer.pl daemon.


See the code or Michael for more details



This is a simple example of a single update for a file. Regarding filenames, the desired format is


 rrdtmp.$(ticks,ideally fractional but not required).$(arbitrary unique id).info


 You can optionally gzip these files, so ".info" and ".info.gz" are suitable suffixes.  NS::FileUtils::saveFile will auto-gzip if presented with a filename that ends in .gz

For the below, the description is (exampleNSServerName.net.wisc.edu.trope.doit.wisc.edu.monitor_dhcp_leases.pl), which is broken into three components


1: "exampleNSServerName.net.wisc.edu" is the source of the archive, which is useful for tracking back problem origination
2: "trope.doit.wisc.edu" which is some additional information
3: "monitor_dhcp_leases.pl" which is the script $0 basename, again useful for tracking back problem origination


 The order of this stuff is arbitrary and is again just used for troubleshooting basically.

retrieving rrdtmp.1527178455.62114.exampleNSServerName.net.wisc.edu.trope.doit.wisc.edu.monitor_dhcp_leases.pl.info.gz
{
'...rrd_configuration' => {
'envProbeHumidity' => {
'ds_type' => 'GAUGE',
'rrd_path' => '/var/flows/rrds/envProbeHumidity',
'rrd_setup' => '1:2016,12:8670,288:3650',
'update_frequency' => '150'
},
'm-marion-opt.wiscnet.net_humidity_envProbeHumidity.rrd' => {
'rrd_type' => 'envProbeHumidity',
'time' => 1226693418,
'value' => 30
},
}



This is a simple example of a multiple updates for one or more files.  Updates are processed in array order.
{
'...files' => [
{
'rrd_file' => '/var/local/rrds/jnxXMLRPF/device=r-uwcbaraboosaukco.uwsys.net_interface=ge-1-1-0-0_family=inet_jnx-xml-RPFPacketCount.rrd',
'rrd_type' => 'jnx-xml-RPFPacketCount',
'time' => '1506438110',
'value' => '8819'
},
{
'rrd_file' => '/var/local/rrds/jnxXMLRPF/device=r-uwcbaraboosaukco.uwsys.net_interface=ge-1-1-0-0_family=inet_jnx-xml-RPFByteCount.rrd',
'rrd_type' => 'jnx-xml-RPFByteCount',
'time' => '1506438110',
'value' => '2895862'
},
{
'rrd_file' => '/var/local/rrds/jnxXMLRPF/device=r-uwcbaraboosaukco.uwsys.net_interface=ge-1-1-0-0_family=inet_jnx-xml-RPFPacketCount.rrd',
'rrd_type' => 'jnx-xml-RPFPacketCount',
'time' => '1506438167',
'value' => '8819'
},
{
'rrd_file' => '/var/local/rrds/jnxXMLRPF/device=r-uwcbaraboosaukco.uwsys.net_interface=ge-1-1-0-0_family=inet_jnx-xml-RPFByteCount.rrd',
'rrd_type' => 'jnx-xml-RPFByteCount',
'time' => '1506438167',
'value' => '2895862'
},
.. etc etc
],

'...rrd_configuration' => {
... same as simple example ...
}
}



The following is needed by FIDO:
rrd_writer: Help File


Keywords:
fido rrd writer fido_rrd_writer ns-rrd-writer 
Doc ID:
38037
Owned by:
Michael H. in Network Services
Created:
2014-02-27
Updated:
2022-04-29
Sites:
Network Services, Systems & Network Control Center, University of Wisconsin System Network FIDO