| 1 | # | ||||||||||||||||||||||||||||
| 2 | # Devmon data object | ||||||||||||||||||||||||||||
| 3 | # | ||||||||||||||||||||||||||||
| 4 | package Xymon::Plugin::Server::Devmon; | ||||||||||||||||||||||||||||
| 5 | |||||||||||||||||||||||||||||
| 6 | 5 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 7 | |||||||||||||||||||||||||||||
| 8 | 5 | ▶ | use Xymon::Plugin::Server; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 9 | |||||||||||||||||||||||||||||
| 10 | =head1 NAME | ||||||||||||||||||||||||||||
| 11 | |||||||||||||||||||||||||||||
| 12 | Xymon::Plugin::Server::Devmon - Devmon data object | ||||||||||||||||||||||||||||
| 13 | |||||||||||||||||||||||||||||
| 14 | =head1 SYNOPSIS | ||||||||||||||||||||||||||||
| 15 | |||||||||||||||||||||||||||||
| 16 | my $devmon = Xymon::Plugin::Server::Devmon | ||||||||||||||||||||||||||||
| 17 | ->new(ds0 => 'GAUGE:600:0:U', | ||||||||||||||||||||||||||||
| 18 | ds1 => 'GAUGE:600:0:U'); | ||||||||||||||||||||||||||||
| 19 | |||||||||||||||||||||||||||||
| 20 | $devmon->add_data(device1 => { ds0 => 0, ds1 => 2 }); | ||||||||||||||||||||||||||||
| 21 | $devmon->add_data(device2 => { ds0 => 0, ds1 => 2 }); | ||||||||||||||||||||||||||||
| 22 | |||||||||||||||||||||||||||||
| 23 | # add to data to be reported. | ||||||||||||||||||||||||||||
| 24 | my $status = Xymon::Plugin::Server::Status | ||||||||||||||||||||||||||||
| 25 | ->new("localhost.localdomain", "test1"); | ||||||||||||||||||||||||||||
| 26 | |||||||||||||||||||||||||||||
| 27 | $status->add_devmon($devmon); | ||||||||||||||||||||||||||||
| 28 | |||||||||||||||||||||||||||||
| 29 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||
| 30 | |||||||||||||||||||||||||||||
| 31 | This module handles data structure for Xymon 'devmon' module. | ||||||||||||||||||||||||||||
| 32 | To store data into RRD database, add entry to TEST2RRD variable | ||||||||||||||||||||||||||||
| 33 | in server config. | ||||||||||||||||||||||||||||
| 34 | |||||||||||||||||||||||||||||
| 35 | (named hobbitserver.cfg in Xymon 4.2, xymonserver.cfg in Xymon 4.3) | ||||||||||||||||||||||||||||
| 36 | |||||||||||||||||||||||||||||
| 37 | ex. | ||||||||||||||||||||||||||||
| 38 | TEST2RRD="cpu=la,disk,...(snipped)...,test1=devmon" | ||||||||||||||||||||||||||||
| 39 | |||||||||||||||||||||||||||||
| 40 | |||||||||||||||||||||||||||||
| 41 | =head1 SUBROUTINES/METHODS | ||||||||||||||||||||||||||||
| 42 | |||||||||||||||||||||||||||||
| 43 | =head2 new(ds1 => dsdef1, ...) | ||||||||||||||||||||||||||||
| 44 | |||||||||||||||||||||||||||||
| 45 | Create devmon object with data store definition. | ||||||||||||||||||||||||||||
| 46 | (To know meanings of dsdef field, please read document in RRDTool.) | ||||||||||||||||||||||||||||
| 47 | |||||||||||||||||||||||||||||
| 48 | =cut | ||||||||||||||||||||||||||||
| 49 | |||||||||||||||||||||||||||||
| 50 | 6 | ▶ | sub new { | ||||||||||||||||||||||||||
|
Subroutine
new: called CC=4 SCAR=13.9
Pod
documented
| |||||||||||||||||||||||||||||
| 51 | 6 | my $class = shift; | |||||||||||||||||||||||||||
| 52 | 6 | my @datadef = @_; # key, def, key, def, ... | |||||||||||||||||||||||||||
| 53 | |||||||||||||||||||||||||||||
| 54 | 6 | my @dskeys; | |||||||||||||||||||||||||||
| 55 | my %dsdefs; | ||||||||||||||||||||||||||||
| 56 | |||||||||||||||||||||||||||||
| 57 | 6 | ▶ | while (@datadef) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 58 | 10 | my $key = shift @datadef; | |||||||||||||||||||||||||||
| 59 | 10 | push(@dskeys, $key); | |||||||||||||||||||||||||||
| 60 | 10 | $dsdefs{$key} = shift @datadef; | |||||||||||||||||||||||||||
| 61 | } | ||||||||||||||||||||||||||||
| 62 | |||||||||||||||||||||||||||||
| 63 | 6 | my $format_method = "_format_4_3"; | |||||||||||||||||||||||||||
| 64 | 6 | my @ver = @{Xymon::Plugin::Server->version}; | |||||||||||||||||||||||||||
| 65 | 6 | ▶ | if ($ver[0] == 4 && $ver[1] <= 2) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$ver[0] == 4 and $ver[1] <= 2
MC/DC50%1/2
$ver[0] == 4 and $ver[1] <= 2
$ver[0] == 4
$ver[1] <= 2
Truth table66%2/3
A and B
A= $ver[0] == 4B= $ver[1] <= 2
| |||||||||||||||||||||||||||||
| 66 | 3 | $format_method = "_format_4_2"; | |||||||||||||||||||||||||||
| 67 | } | ||||||||||||||||||||||||||||
| 68 | |||||||||||||||||||||||||||||
| 69 | 6 | my $self = { | |||||||||||||||||||||||||||
| 70 | _dskeys => \@dskeys, | ||||||||||||||||||||||||||||
| 71 | _dsdefs => \%dsdefs, | ||||||||||||||||||||||||||||
| 72 | _format_method => $format_method, | ||||||||||||||||||||||||||||
| 73 | _data => [], | ||||||||||||||||||||||||||||
| 74 | }; | ||||||||||||||||||||||||||||
| 75 | |||||||||||||||||||||||||||||
| 76 | 6 | bless $self, $class; | |||||||||||||||||||||||||||
| 77 | } | ||||||||||||||||||||||||||||
| 78 | |||||||||||||||||||||||||||||
| 79 | =head2 add_data(devname, { ds1 => ds1value, ...}) | ||||||||||||||||||||||||||||
| 80 | |||||||||||||||||||||||||||||
| 81 | Set values for devname. | ||||||||||||||||||||||||||||
| 82 | |||||||||||||||||||||||||||||
| 83 | =cut | ||||||||||||||||||||||||||||
| 84 | |||||||||||||||||||||||||||||
| 85 | 10 | ▶ | sub add_data { | ||||||||||||||||||||||||||
|
Subroutine
add_data: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 86 | 10 | my $self = shift; | |||||||||||||||||||||||||||
| 87 | 10 | my ($key, $values) = @_; | |||||||||||||||||||||||||||
| 88 | |||||||||||||||||||||||||||||
| 89 | 10 | push(@{$self->{_data}}, [$key, $values]); | |||||||||||||||||||||||||||
| 90 | } | ||||||||||||||||||||||||||||
| 91 | |||||||||||||||||||||||||||||
| 92 | =head2 format | ||||||||||||||||||||||||||||
| 93 | |||||||||||||||||||||||||||||
| 94 | Format data structure to report to Xymon. | ||||||||||||||||||||||||||||
| 95 | |||||||||||||||||||||||||||||
| 96 | =cut | ||||||||||||||||||||||||||||
| 97 | |||||||||||||||||||||||||||||
| 98 | 6 | ▶ | sub format { | ||||||||||||||||||||||||||
|
Subroutine
format: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 99 | 6 | my $self = shift; | |||||||||||||||||||||||||||
| 100 | 6 | my @ver = @{Xymon::Plugin::Server->version}; | |||||||||||||||||||||||||||
| 101 | |||||||||||||||||||||||||||||
| 102 | 6 | my $meth = $self->{_format_method}; | |||||||||||||||||||||||||||
| 103 | 6 | $self->$meth(@_); | |||||||||||||||||||||||||||
| 104 | } | ||||||||||||||||||||||||||||
| 105 | |||||||||||||||||||||||||||||
| 106 | 3 | ▶ | sub _format_4_2 { | ||||||||||||||||||||||||||
|
Subroutine
_format_4_2: called CC=5 SCAR=16.1
| |||||||||||||||||||||||||||||
| 107 | 3 | my $self = shift; | |||||||||||||||||||||||||||
| 108 | 3 | my @ret; | |||||||||||||||||||||||||||
| 109 | |||||||||||||||||||||||||||||
| 110 | 3 | my $n = 20; | |||||||||||||||||||||||||||
| 111 | 3 | my @defs = ('GAUGE:600:0:U') x $n; | |||||||||||||||||||||||||||
| 112 | |||||||||||||||||||||||||||||
| 113 | 3 | my $ndefs = scalar @{$self->{_dskeys}}; | |||||||||||||||||||||||||||
| 114 | 3 | my %dsmap; | |||||||||||||||||||||||||||
| 115 | |||||||||||||||||||||||||||||
| 116 | 3 | ▶ | for (my $i=0; $i<$ndefs; $i++) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 117 | 5 | my $key = $self->{_dskeys}->[$i]; | |||||||||||||||||||||||||||
| 118 | 5 | $dsmap{$key} = sprintf("ds%d", $i); | |||||||||||||||||||||||||||
| 119 | 5 | $defs[$i] = $self->{_dsdefs}->{$key}; | |||||||||||||||||||||||||||
| 120 | } | ||||||||||||||||||||||||||||
| 121 | |||||||||||||||||||||||||||||
| 122 | 3 | push(@ret, "<!--DEVMON RRD: "); | |||||||||||||||||||||||||||
| 123 | my $dsline = join(" ", | ||||||||||||||||||||||||||||
| 124 | 3 | map { join(':', 'DS', sprintf("ds%d", $_), $defs[$_]) } | |||||||||||||||||||||||||||
| 125 | 0..($n-1)); | ||||||||||||||||||||||||||||
| 126 | |||||||||||||||||||||||||||||
| 127 | 3 | push(@ret, $dsline); | |||||||||||||||||||||||||||
| 128 | |||||||||||||||||||||||||||||
| 129 | 3 | for my $kv (@{$self->{_data}}) { | |||||||||||||||||||||||||||
| 130 | 5 | my ($key, $values) = @$kv; | |||||||||||||||||||||||||||
| 131 | 5 | my @vals = ('U') x $n; | |||||||||||||||||||||||||||
| 132 | |||||||||||||||||||||||||||||
| 133 | 5 | my $ndefs = scalar @{$self->{_dskeys}}; | |||||||||||||||||||||||||||
| 134 | 5 | ▶ | for (my $i=0; $i<$ndefs; $i++) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 135 | 9 | my $v = $values->{$self->{_dskeys}->[$i]}; | |||||||||||||||||||||||||||
| 136 | 9 | ▶ | $vals[$i] = defined($v) ? $v : 'U'; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 137 | } | ||||||||||||||||||||||||||||
| 138 | |||||||||||||||||||||||||||||
| 139 | 5 | my $line = $key . " " . join(':', @vals); | |||||||||||||||||||||||||||
| 140 | |||||||||||||||||||||||||||||
| 141 | |||||||||||||||||||||||||||||
| 142 | 5 | push(@ret, $line); | |||||||||||||||||||||||||||
| 143 | } | ||||||||||||||||||||||||||||
| 144 | |||||||||||||||||||||||||||||
| 145 | 3 | push(@ret, "-->\n"); | |||||||||||||||||||||||||||
| 146 | |||||||||||||||||||||||||||||
| 147 | 3 | return join("\n", @ret); | |||||||||||||||||||||||||||
| 148 | } | ||||||||||||||||||||||||||||
| 149 | |||||||||||||||||||||||||||||
| 150 | 3 | ▶ | sub _format_4_3 { | ||||||||||||||||||||||||||
|
Subroutine
_format_4_3: called CC=3 SCAR=11.0
| |||||||||||||||||||||||||||||
| 151 | 3 | my $self = shift; | |||||||||||||||||||||||||||
| 152 | 3 | my @ret; | |||||||||||||||||||||||||||
| 153 | |||||||||||||||||||||||||||||
| 154 | 3 | push(@ret, "<!--DEVMON RRD: "); | |||||||||||||||||||||||||||
| 155 | my $dsline = join(" ", | ||||||||||||||||||||||||||||
| 156 | 5 | map { join(':', 'DS', $_, $self->{_dsdefs}->{$_}) } | |||||||||||||||||||||||||||
| 157 | 3 | @{$self->{_dskeys}}); | |||||||||||||||||||||||||||
| 158 | |||||||||||||||||||||||||||||
| 159 | 3 | push(@ret, $dsline); | |||||||||||||||||||||||||||
| 160 | |||||||||||||||||||||||||||||
| 161 | 3 | for my $kv (@{$self->{_data}}) { | |||||||||||||||||||||||||||
| 162 | 5 | my ($key, $values) = @$kv; | |||||||||||||||||||||||||||
| 163 | |||||||||||||||||||||||||||||
| 164 | my $line = $key . " " | ||||||||||||||||||||||||||||
| 165 | . join(":", | ||||||||||||||||||||||||||||
| 166 | 9 | ▶ | map { defined($values->{$_}) ? $values->{$_} : 'U'; } | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 167 | 5 | @{$self->{_dskeys}}); | |||||||||||||||||||||||||||
| 168 | |||||||||||||||||||||||||||||
| 169 | 5 | push(@ret, $line); | |||||||||||||||||||||||||||
| 170 | } | ||||||||||||||||||||||||||||
| 171 | |||||||||||||||||||||||||||||
| 172 | 3 | push(@ret, "-->\n"); | |||||||||||||||||||||||||||
| 173 | |||||||||||||||||||||||||||||
| 174 | 3 | return join("\n", @ret); | |||||||||||||||||||||||||||
| 175 | } | ||||||||||||||||||||||||||||
| 176 | |||||||||||||||||||||||||||||
| 177 | 5 | 1; | |||||||||||||||||||||||||||