centreon-plugins/cloud/aws/custom/paws.pm

625 lines
20 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 cloud::aws::custom::paws;
use strict;
use warnings;
use Paws;
use Paws::Net::LWPCaller;
use DateTime;
sub new {
my ($class, %options) = @_;
my $self = {};
bless $self, $class;
if (!defined($options{output})) {
print "Class Custom: Need to specify 'output' argument.\n";
exit 3;
}
if (!defined($options{options})) {
$options{output}->add_option_msg(short_msg => "Class Custom: Need to specify 'options' argument.");
$options{output}->option_exit();
}
if (!defined($options{noptions})) {
$options{options}->add_options(arguments => {
'aws-secret-key:s' => { name => 'aws_secret_key' },
'aws-access-key:s' => { name => 'aws_access_key' },
'aws-session-token:s' => { name => 'aws_session_token' },
'region:s' => { name => 'region' },
'timeframe:s' => { name => 'timeframe' },
'period:s' => { name => 'period' },
'statistic:s@' => { name => 'statistic' },
'zeroed' => { name => 'zeroed' },
'proxyurl:s' => { name => 'proxyurl' }
});
}
$options{options}->add_help(package => __PACKAGE__, sections => 'PAWS OPTIONS', once => 1);
$self->{output} = $options{output};
$self->{mode} = $options{mode};
return $self;
}
sub get_region {
my ($self, %options) = @_;
return $self->{option_results}->{region};
}
sub set_options {
my ($self, %options) = @_;
$self->{option_results} = $options{option_results};
}
sub set_defaults {
my ($self, %options) = @_;
foreach (keys %{$options{default}}) {
if ($_ eq $self->{mode}) {
for (my $i = 0; $i < scalar(@{$options{default}->{$_}}); $i++) {
foreach my $opt (keys %{$options{default}->{$_}[$i]}) {
if (!defined($self->{option_results}->{$opt}[$i])) {
$self->{option_results}->{$opt}[$i] = $options{default}->{$_}[$i]->{$opt};
}
}
}
}
}
}
sub check_options {
my ($self, %options) = @_;
if (defined($self->{option_results}->{proxyurl}) && $self->{option_results}->{proxyurl} ne '') {
$ENV{HTTP_PROXY} = $self->{option_results}->{proxyurl};
$ENV{HTTPS_PROXY} = $self->{option_results}->{proxyurl};
}
if (defined($self->{option_results}->{aws_secret_key}) && $self->{option_results}->{aws_secret_key} ne '') {
$ENV{AWS_SECRET_KEY} = $self->{option_results}->{aws_secret_key};
}
if (defined($self->{option_results}->{aws_access_key}) && $self->{option_results}->{aws_access_key} ne '') {
$ENV{AWS_ACCESS_KEY} = $self->{option_results}->{aws_access_key};
}
if (defined($self->{option_results}->{aws_session_token}) && $self->{option_results}->{aws_session_token} ne '') {
$ENV{AWS_SESSION_TOKEN} = $self->{option_results}->{aws_session_token};
}
if (!defined($self->{option_results}->{region}) || $self->{option_results}->{region} eq '') {
$self->{output}->add_option_msg(short_msg => "Need to specify --region option.");
$self->{output}->option_exit();
}
if (defined($self->{option_results}->{statistic})) {
foreach my $statistic (@{$self->{option_results}->{statistic}}) {
if ($statistic !~ /minimum|maximum|average|sum/) {
$self->{output}->add_option_msg(short_msg => "Statistic '" . $statistic . "' is not handled");
$self->{output}->option_exit();
}
}
}
return 0;
}
sub cloudwatch_get_metrics {
my ($self, %options) = @_;
my $metric_results = {};
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $cw = Paws->service('CloudWatch', caller => $lwp_caller, region => $options{region});
my $start_time = DateTime->now->subtract(seconds => $options{timeframe})->iso8601;
my $end_time = DateTime->now->iso8601;
foreach my $metric_name (@{$options{metrics}}) {
my $metric_result = $cw->GetMetricStatistics(
MetricName => $metric_name,
Namespace => $options{namespace},
Statistics => $options{statistics},
#ExtendedStatistics => ['p100'],
EndTime => $end_time,
StartTime => $start_time,
Period => $options{period},
#Unit => $unit,
Dimensions => $options{dimensions},
);
$metric_results->{$metric_result->{Label}} = { points => 0 };
foreach my $point (@{$metric_result->{Datapoints}}) {
if (defined($point->{Average})) {
$metric_results->{$metric_result->{Label}}->{average} = 0 if (!defined($metric_results->{$metric_result->{Label}}->{average}));
$metric_results->{$metric_result->{Label}}->{average} += $point->{Average};
}
if (defined($point->{Minimum})) {
$metric_results->{$metric_result->{Label}}->{minimum} = $point->{Minimum}
if (!defined($metric_results->{$metric_result->{Label}}->{minimum}) || $point->{Minimum} < $metric_results->{$metric_result->{Label}}->{minimum});
}
if (defined($point->{Maximum})) {
$metric_results->{$metric_result->{Label}}->{maximum} = $point->{Maximum}
if (!defined($metric_results->{$metric_result->{Label}}->{maximum}) || $point->{Maximum} > $metric_results->{$metric_result->{Label}}->{maximum});
}
if (defined($point->{Sum})) {
$metric_results->{$metric_result->{Label}}->{sum} = 0 if (!defined($metric_results->{$metric_result->{Label}}->{sum}));
$metric_results->{$metric_result->{Label}}->{sum} += $point->{Sum};
}
$metric_results->{$metric_result->{Label}}->{points}++;
}
if (defined($metric_results->{$metric_result->{Label}}->{average})) {
$metric_results->{$metric_result->{Label}}->{average} /= $metric_results->{$metric_result->{Label}}->{points};
}
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $metric_results;
}
sub cloudwatch_get_alarms {
my ($self, %options) = @_;
my $alarm_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $cw = Paws->service('CloudWatch', caller => $lwp_caller, region => $options{region});
my $alarms = $cw->DescribeAlarms();
foreach my $alarm (@{$alarms->{MetricAlarms}}) {
push @$alarm_results, {
AlarmName => $alarm->{AlarmName},
StateValue => $alarm->{StateValue},
MetricName => $alarm->{MetricName},
StateReason => $alarm->{StateReason},
StateUpdatedTimestamp => $alarm->{StateUpdatedTimestamp},
};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $alarm_results;
}
sub cloudwatch_list_metrics {
my ($self, %options) = @_;
my $metric_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $cw = Paws->service('CloudWatch', caller => $lwp_caller, region => $options{region});
my %cw_options = ();
$cw_options{Namespace} = $options{namespace} if (defined($options{namespace}));
$cw_options{MetricName} = $options{metric} if (defined($options{metric}));
while ((my $list_metrics = $cw->ListMetrics(%cw_options))) {
foreach (@{$list_metrics->{Metrics}}) {
my $dimensions = [];
foreach my $dimension (@{$_->{Dimensions}}) {
push @$dimensions, { Name => $dimension->{Name}, Value => $dimension->{Value} };
}
push @{$metric_results}, {
Namespace => $_->{Namespace},
MetricName => $_->{MetricName},
Dimensions => $dimensions,
};
}
last if (!defined($list_metrics->{NextToken}));
$cw_options{NextToken} = $list_metrics->{NextToken};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $metric_results;
}
sub cloudwatchlogs_describe_log_groups {
my ($self, %options) = @_;
my $log_groups_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $cw = Paws->service('CloudWatchLogs', caller => $lwp_caller, region => $options{region});
my %cw_options = ();
while ((my $list_log_groups = $cw->DescribeLogGroups(%cw_options))) {
foreach (@{$list_log_groups->{logGroups}}) {
push @$log_groups_results, $_;
}
last if (!defined($list_log_groups->{NextToken}));
$cw_options{NextToken} = $list_log_groups->{NextToken};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $log_groups_results;
}
sub cloudwatchlogs_filter_log_events {
my ($self, %options) = @_;
my $log_groups_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $cw = Paws->service('CloudWatchLogs', caller => $lwp_caller, region => $options{region});
my %cw_options = ();
$cw_options{StartTime} = $options{start_time} if (defined($options{start_time}));
$cw_options{LogStreamNames} = [@{$options{LogStreamNames}}] if (defined($options{LogStreamNames}));
while ((my $list_log_groups = $cw->FilterLogEvents(%cw_options))) {
foreach (@{$list_log_groups->{logGroups}}) {
push @$log_groups_results, $_;
}
last if (!defined($list_log_groups->{NextToken}));
$cw_options{NextToken} = $list_log_groups->{NextToken};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $log_groups_results;
}
sub ebs_list_volumes {
my ($self, %options) = @_;
my $volume_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $ebsvolume = Paws->service('EC2', caller => $lwp_caller, region => $options{region});
my $ebsvolume_requests = $ebsvolume->DescribeVolumes(DryRun => 0);
foreach my $request (@{$ebsvolume_requests->{Volumes}}) {
my @name_tags;
foreach my $tag (@{$request->{Tags}}) {
if ($tag->{Key} eq "Name" && defined($tag->{Value})) {
push @name_tags, $tag->{Value};
}
};
push @{$volume_results}, {
VolumeId => $request->{VolumeId},
VolumeName => join(",", @name_tags),
VolumeType => $request->{VolumeType},
VolumeState => $request->{State}
};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $volume_results;
}
sub ec2_get_instances_status {
my ($self, %options) = @_;
my $instance_results = {};
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $ec2 = Paws->service('EC2', caller => $lwp_caller, region => $options{region});
my $instances = $ec2->DescribeInstanceStatus(DryRun => 0, IncludeAllInstances => 1);
foreach (@{$instances->{InstanceStatuses}}) {
$instance_results->{$_->{InstanceId}} = {
state => $_->{InstanceState}->{Name},
status => $_->{InstanceStatus}->{Status}
};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $instance_results;
}
sub ec2spot_get_active_instances {
my ($self, %options) = @_;
my $instance_results = {};
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $ec2 = Paws->service('EC2', caller => $lwp_caller, region => $options{region});
my $instances = $ec2->DescribeSpotFleetInstances('SpotFleetRequestId' => $options{spot_fleet_request_id}, DryRun => 0, IncludeAllInstances => 1);
foreach (@{$instances->{ActiveInstances}}) {
$instance_results->{$_->{InstanceId}} = {
health => $_->{InstanceHealth},
type => $_->{InstanceType},
request_id => $_->{SpotInstanceRequestId} };
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $instance_results;
}
sub ec2spot_list_fleet_requests {
my ($self, %options) = @_;
my $resource_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $ec2spot = Paws->service('EC2', caller => $lwp_caller, region => $options{region});
my $spot_fleet_requests = $ec2spot->DescribeSpotFleetRequests(DryRun => 0);
foreach (@{$spot_fleet_requests->{SpotFleetRequestConfigs}}) {
push @{$resource_results}, {
SpotFleetRequestState => $_->{SpotFleetRequestState},
SpotFleetRequestId => $_->{SpotFleetRequestId},
ActivityStatus => $_->{ActivityStatus}
};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $resource_results;
}
sub ec2_list_resources {
my ($self, %options) = @_;
my $resource_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $ec2 = Paws->service('EC2', caller => $lwp_caller, region => $options{region});
my $list_instances = $ec2->DescribeInstances(DryRun => 0);
foreach my $reservation (@{$list_instances->{Reservations}}) {
foreach my $instance (@{$reservation->{Instances}}) {
my @instance_tags;
foreach my $tag (@{$instance->{Tags}}) {
my %already = map { $_->{Name} => $_ } @{$resource_results};
if ($tag->{Key} eq "aws:autoscaling:groupName") {
next if (defined($already{$tag->{Value}}));
push @{$resource_results}, {
Name => $tag->{Value},
Type => 'asg',
};
} elsif (defined($tag->{Key}) && defined($tag->{Value})) {
push @instance_tags, $tag->{Key} . ":" . $tag->{Value};
}
}
push @{$resource_results}, {
Name => $instance->{InstanceId},
Type => 'instance',
AvailabilityZone => $instance->{Placement}->{AvailabilityZone},
InstanceType => $instance->{InstanceType},
State => $instance->{State}->{Name},
Tags => join(",", @instance_tags),
};
}
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $resource_results;
}
sub asg_get_resources {
my ($self, %options) = @_;
my $autoscaling_groups = {};
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $asg = Paws->service('AutoScaling', caller => $lwp_caller, region => $options{region});
$autoscaling_groups = $asg->DescribeAutoScalingGroups();
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return \@{$autoscaling_groups->{AutoScalingGroups}};
}
sub rds_get_instances_status {
my ($self, %options) = @_;
my $instance_results = {};
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $rds = Paws->service('RDS', caller => $lwp_caller, region => $options{region});
my $instances = $rds->DescribeDBInstances();
foreach (@{$instances->{DBInstances}}) {
$instance_results->{$_->{DBInstanceIdentifier}} = { state => $_->{DBInstanceStatus} };
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $instance_results;
}
sub rds_list_instances {
my ($self, %options) = @_;
my $instance_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $rds = Paws->service('RDS', caller => $lwp_caller, region => $options{region});
my $list_instances = $rds->DescribeDBInstances();
foreach my $instance (@{$list_instances->{DBInstances}}) {
push @{$instance_results}, {
Name => $instance->{DBInstanceIdentifier},
AvailabilityZone => $instance->{AvailabilityZone},
Engine => $instance->{Engine},
StorageType => $instance->{StorageType},
DBInstanceStatus => $instance->{DBInstanceStatus},
};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $instance_results;
}
sub rds_list_clusters {
my ($self, %options) = @_;
my $cluster_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $rds = Paws->service('RDS', caller => $lwp_caller, region => $options{region});
my $list_clusters = $rds->DescribeDBClusters();
foreach my $cluster (@{$list_clusters->{DBClusters}}) {
push @{$cluster_results}, {
Name => $cluster->{DBClusterIdentifier},
DatabaseName => $cluster->{DatabaseName},
Engine => $cluster->{Engine},
Status => $cluster->{Status},
};
}
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $cluster_results;
}
sub vpn_list_connections {
my ($self, %options) = @_;
my $connections_results = [];
eval {
my $lwp_caller = new Paws::Net::LWPCaller();
my $vpn = Paws->service('EC2', caller => $lwp_caller, region => $options{region});
my $list_vpn = $vpn->DescribeVpnConnections();
foreach my $connection (@{$list_vpn->{VpnConnections}}) {
my @name_tags;
foreach my $tag (@{$connection->{Tags}}) {
if ($tag->{Key} eq "Name" && defined($tag->{Value})) {
push @name_tags, $tag->{Value};
}
}
push @{$connections_results}, {
id => $connection->{VpnConnectionId},
name => join(",", @name_tags),
state => $connection->{State}
}
};
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "error: $@");
$self->{output}->option_exit();
}
return $connections_results;
}
1;
__END__
=head1 NAME
Amazon AWS
=head1 SYNOPSIS
Amazon AWS
=head1 PAWS OPTIONS
=over 8
=item B<--aws-secret-key>
Set AWS secret key.
=item B<--aws-access-key>
Set AWS access key.
=item B<--aws-session-token>
Set AWS session token.
=item B<--region>
Set the region name (Required).
=item B<--period>
Set period in seconds.
=item B<--timeframe>
Set timeframe in seconds.
=item B<--statistic>
Set cloudwatch statistics
(Can be: 'minimum', 'maximum', 'average', 'sum').
=item B<--zeroed>
Set metrics value to 0 if none. Usefull when CloudWatch
does not return value when not defined.
=item B<--proxyurl>
Proxy URL if any
=back
=head1 DESCRIPTION
B<custom>.
=cut