From f13025c6a754fe174962304efd915b095564311c Mon Sep 17 00:00:00 2001 From: matoy Date: Fri, 21 May 2021 11:33:47 +0200 Subject: [PATCH] new mode: --mode='backend-health' (#2795) * Update plugin.pm adds a mode to get backends unhealthy host count (FYI: mode backend-status DOES ONLY work on App Gateway v2, not on v1 which are the most deployed globally; app gateway v2 is recent) * Add files via upload * Update backendunhealthyhost.pm * Update backendunhealthyhost.pm * Update and rename backendunhealthyhost.pm to backendhealth.pm * Update backendhealth.pm * Update plugin.pm * Update cloud/azure/network/appgateway/plugin.pm Co-authored-by: Thibault S <48209914+thibaults-centreon@users.noreply.github.com> * Update cloud/azure/network/appgateway/mode/backendhealth.pm Co-authored-by: Thibault S <48209914+thibaults-centreon@users.noreply.github.com> * fix help and style Co-authored-by: Thibault S <48209914+thibaults-centreon@users.noreply.github.com> --- .../network/appgateway/mode/backendhealth.pm | 149 ++++++++++++++++++ cloud/azure/network/appgateway/plugin.pm | 1 + 2 files changed, 150 insertions(+) create mode 100644 cloud/azure/network/appgateway/mode/backendhealth.pm diff --git a/cloud/azure/network/appgateway/mode/backendhealth.pm b/cloud/azure/network/appgateway/mode/backendhealth.pm new file mode 100644 index 000000000..a9a4a3d5f --- /dev/null +++ b/cloud/azure/network/appgateway/mode/backendhealth.pm @@ -0,0 +1,149 @@ +# +# Copyright 2021 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 cloud::azure::network::appgateway::mode::backendhealth; + +use base qw(cloud::azure::custom::mode); + +use strict; +use warnings; + +sub get_metrics_mapping { + my ($self, %options) = @_; + + my $metrics_mapping = { + 'unhealthyhostcount' => { + 'output' => 'Unhealthy Host Count', + 'label' => 'unhealthy-host-count', + 'nlabel' => 'appgateway.backend.unhealthy.host.count', + 'unit' => '', + 'min' => '0' + }, + 'healthyhostcount' => { + 'output' => 'Healthy Host Count', + 'label' => 'healthy-host-count', + 'nlabel' => 'appgateway.backend.healthy.host.count', + 'unit' => '', + 'min' => '0' + } + }; + + return $metrics_mapping; +} + +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 => { + 'filter-metric:s' => { name => 'filter_metric' }, + 'resource:s' => { name => 'resource' }, + 'resource-group:s' => { name => 'resource_group' } + }); + + return $self; +} + +sub check_options { + my ($self, %options) = @_; + $self->SUPER::check_options(%options); + + if (!defined($self->{option_results}->{resource}) || $self->{option_results}->{resource} eq '') { + $self->{output}->add_option_msg(short_msg => 'Need to specify either --resource with --resource-group option or --resource .'); + $self->{output}->option_exit(); + } + my $resource = $self->{option_results}->{resource}; + my $resource_group = defined($self->{option_results}->{resource_group}) ? $self->{option_results}->{resource_group} : ''; + if ($resource =~ /^\/subscriptions\/.*\/resourceGroups\/(.*)\/providers\/Microsoft\.Network\/applicationGateways\/(.*)$/) { + $resource_group = $1; + $resource = $2; + } + + $self->{az_resource} = $resource; + $self->{az_resource_group} = $resource_group; + $self->{az_resource_type} = 'applicationGateways'; + $self->{az_resource_namespace} = 'Microsoft.Network'; + $self->{az_timeframe} = defined($self->{option_results}->{timeframe}) ? $self->{option_results}->{timeframe} : 900; + $self->{az_interval} = defined($self->{option_results}->{interval}) ? $self->{option_results}->{interval} : 'PT5M'; + $self->{az_aggregations} = ['Average']; + if (defined($self->{option_results}->{aggregation})) { + $self->{az_aggregations} = []; + foreach my $stat (@{$self->{option_results}->{aggregation}}) { + if ($stat ne '') { + push @{$self->{az_aggregations}}, ucfirst(lc($stat)); + } + } + } + + foreach my $metric (keys %{$self->{metrics_mapping}}) { + next if (defined($self->{option_results}->{filter_metric}) && $self->{option_results}->{filter_metric} ne '' + && $metric !~ /$self->{option_results}->{filter_metric}/); + push @{$self->{az_metrics}}, $metric; + } +} + +1; + +__END__ + +=head1 MODE + +Check Azure Application Gateway backend hosts health statistics. + +Example: + +Using resource name : + +perl centreon_plugins.pl --plugin=cloud::azure::network::appgateway::plugin --mode=backend-health --custommode=api +--resource= --resource-group= --aggregation='average' +--warning-unhealthy-host-count='1' --critical-unhealthy-host-count='2' + +Using resource id : + +perl centreon_plugins.pl --plugin=cloud::azure::network::appgateway::plugin --mode=backend-health --custommode=api +--resource='/subscriptions//resourceGroups//providers/Microsoft.Network/applicationGateways/' +--aggregation='average' --warning-unhealthy-host-count='1' --critical-unhealthy-host-count='2' + +Default aggregation: 'average' / 'total', 'minimum' and 'maximum' are valid. + +=over 8 + +=item B<--resource> + +Set resource name or id (Required). + +=item B<--resource-group> + +Set resource group (Required if resource's name is used). + +=item B<--warning-*> + +Warning threshold where '*' can be: +'healthyhostcount', 'unhealthyhostcount'. + +=item B<--critical-*> + +Critical threshold where '*' can be: +'healthyhostcount', 'unhealthyhostcount'. + +=back + +=cut diff --git a/cloud/azure/network/appgateway/plugin.pm b/cloud/azure/network/appgateway/plugin.pm index bc5b8e15e..a3c819180 100644 --- a/cloud/azure/network/appgateway/plugin.pm +++ b/cloud/azure/network/appgateway/plugin.pm @@ -31,6 +31,7 @@ sub new { $self->{version} = '0.1'; $self->{modes} = { + 'backend-health' => 'cloud::azure::network::appgateway::mode::backendhealth', 'backend-status' => 'cloud::azure::network::appgateway::mode::backendstatus', 'backend-time' => 'cloud::azure::network::appgateway::mode::backendtime', 'clients-traffic' => 'cloud::azure::network::appgateway::mode::clientstraffic',