centreon-plugins/apps/monitoring/netdata/restapi/mode/disks.pm

232 lines
7.9 KiB
Perl

#
# Copyright 2020 Centreon (http://www.centreon.com/)
#
# Centreon is a full-fledged industry-strength solution that meets
# the needs in IT infrastructure and application monitoring for
# service performance.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
package apps::monitoring::netdata::restapi::mode::disks;
use base qw(centreon::plugins::templates::counter);
use strict;
use warnings;
sub custom_usage_output {
my ($self, %options) = @_;
my ($total_size_value, $total_size_unit) = $self->{perfdata}->change_bytes(value => $self->{result_values}->{total});
my ($total_used_value, $total_used_unit) = $self->{perfdata}->change_bytes(value => $self->{result_values}->{used});
my ($total_free_value, $total_free_unit) = $self->{perfdata}->change_bytes(value => $self->{result_values}->{free});
return sprintf(
'total: %s used: %s (%.2f%%) free: %s (%.2f%%)',
$total_size_value . " " . $total_size_unit,
$total_used_value . " " . $total_used_unit, $self->{result_values}->{prct_used},
$total_free_value . " " . $total_free_unit, $self->{result_values}->{prct_free}
);
}
sub prefix_diskpath_output {
my ($self, %options) = @_;
return "Partition '" . $options{instance_value}->{display} . "' ";
}
sub set_counters {
my ($self, %options) = @_;
$self->{maps_counters_type} = [
{ name => 'global', type => 0 },
{ name => 'diskpath', type => 1, cb_prefix_output => 'prefix_diskpath_output', message_multiple => 'All partitions are ok' }
];
$self->{maps_counters}->{global} = [
{ label => 'count', nlabel => 'storage.partitions.count', display_ok => 0, set => {
key_values => [ { name => 'count' } ],
output_template => 'Partitions count : %d',
perfdatas => [ { label => 'count', value => 'count', template => '%d', min => 0 } ]
}
}
];
$self->{maps_counters}->{diskpath} = [
{ label => 'usage', nlabel => 'storage.space.usage.bytes', set => {
key_values => [ { name => 'used' }, { name => 'free' }, { name => 'prct_used' }, { name => 'prct_free' }, { name => 'total' }, { name => 'display' } ],
closure_custom_output => $self->can('custom_usage_output'),
perfdatas => [
{ template => '%d', min => 0, max => 'total',
unit => 'B', cast_int => 1, label_extra_instance => 1, instance_use => 'display' }
]
}
},
{ label => 'free', display_ok => 0, nlabel => 'storage.space.free.bytes', set => {
key_values => [ { name => 'free' }, { name => 'used' }, { name => 'prct_used' }, { name => 'prct_free' }, { name => 'total' }, { name => 'display' } ],
closure_custom_output => $self->can('custom_usage_output'),
perfdatas => [
{ template => '%d', min => 0, max => 'total',
unit => 'B', cast_int => 1, label_extra_instance => 1, instance_use => 'display' }
]
}
},
{ label => 'usage-prct', display_ok => 0, nlabel => 'storage.space.usage.percentage', set => {
key_values => [ { name => 'prct_used' }, { name => 'display' } ],
output_template => 'used: %.2f %%',
perfdatas => [
{ template => '%.2f', min => 0, max => 100,
unit => '%', label_extra_instance => 1, instance_use => 'display' }
]
}
}
];
}
sub new {
my ($class, %options) = @_;
my $self = $class->SUPER::new(package => __PACKAGE__, %options, force_new_perfdata => 1);
bless $self, $class;
$options{options}->add_options(arguments => {
'chart-period:s' => { name => 'chart_period', default => '300' },
'chart-statistics:s' => { name => 'chart_statistics', default => 'average' },
'fs-name:s' => { name => 'fs_name' },
'space-reservation' => { name => 'space_reservation'}
});
return $self;
}
sub manage_selection {
my ($self, %options) = @_;
my $full_list = $options{custom}->list_charts();
foreach my $chart (values %{$full_list->{charts}}) {
next if ($chart->{name} !~ 'disk_space._');
push @{$self->{fs_list}}, $chart->{name};
}
foreach my $fs (@{$self->{fs_list}}) {
my $result = $options{custom}->get_data(
chart => $fs,
dimensions => 'used,avail,reserved_for_root',
after_period => $self->{option_results}->{chart_period},
group => $self->{option_results}->{chart_statistics}
);
$fs =~ s/disk_space.//;
$fs =~ s/_/\//g;
next if (defined($self->{option_results}->{fs_name}) &&
$self->{option_results}->{fs_name} ne '' &&
$fs !~ /$self->{option_results}->{fs_name}/
);
foreach my $fs_value (@{$result->{data}}) {
foreach my $fs_label (@{$result->{labels}}) {
$self->{fs}->{$fs}->{$fs_label} = shift @{$fs_value};
}
}
my $reserved_space = defined($self->{option_results}->{space_reservation}) ? $self->{fs}->{$fs}->{'reserved for root'} * (1024 ** 3) : '0';
my $used = $self->{fs}->{$fs}->{used} * (1024 ** 3);
my $free = $self->{fs}->{$fs}->{avail} * (1024 ** 3);
my $total = $used + $free + $reserved_space;
my $prct_used = $used * 100 / $total;
my $prct_free = 100 - $prct_used;
if ($prct_used > 100) {
$free = 0;
$prct_used = 100;
$prct_free = 0;
}
$self->{diskpath}->{$fs} = {
display => $fs,
used => $used,
total => $total,
free => $free,
prct_used => $prct_used,
prct_free => $prct_free
};
$self->{global}->{count}++;
}
};
1;
__END__
=head1 MODE
Check disks FS usage of *nix based servers using the Netdata agent RestAPI.
Example:
perl centreon_plugins.pl --plugin=apps::monitoring::netdata::restapi::plugin
--mode=disks --hostname=10.0.0.1 --chart-period=300 --chart-statistics=average --warning-usage-prct=80 --critical-usage-prct=90 --verbose
More information on'https://learn.netdata.cloud/docs/agent/web/api'.
=over 8
=item B<--chart-period>
The period in seconds on which the values are calculated
Default: 300
=item B<--chart-statistic>
The statistic calculation method used to parse the collected data.
Can be : average, sum, min, max
Default: average
=item B<--fs-name>
Filter on one or more specific FS. Regexp can be used
Example: --fs-name='(^/$|^/boot$)'
=item B<--warning-usage>
Warning threshold on FS space usage (in B).
=item B<--critical-usage>
Critical threshold on FS space usage (in B).
=item B<--warning-usage-prct>
Warning threshold on FS percentage space usage (in %).
=item B<--critical-usage-prct>
Critical threshold on FS percentage space usage (in %).
=item B<--warning-free>
Warning threshold on FS free space.
=item B<--critical-free>
Critical threshold on FS free space.
=item B<--space-reservation>
On specific systems, partitions can have reserved space (like ext4 for root).
This option will consider this space in the calculation (like for the 'df' command).
=back
=cut