centreon-plugins/database/oracle/mode/eventwaitsusage.pm

233 lines
8.2 KiB
Perl

#
# 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 database::oracle::mode::eventwaitsusage;
use base qw(centreon::plugins::templates::counter);
use strict;
use warnings;
use Digest::MD5 qw(md5_hex);
sub set_counters {
my ($self, %options) = @_;
$self->{maps_counters_type} = [
{ name => 'event_count', type => 0 },
{ name => 'event', type => 1, cb_prefix_output => 'prefix_event_output', message_multiple => 'All event waits are OK', skipped_code => { -11 => 1, -10 => 1 } },
];
$self->{maps_counters}->{event_count} = [
{ label => 'event-count', set => {
key_values => [ { name => 'count' } ],
output_template => 'Event Wait Count : %s events',
perfdatas => [
{ label => 'event_wait_count', template => '%s', min => 0 }
],
}
},
];
$self->{maps_counters}->{event} = [
{ label => 'total-waits-sec', set => {
key_values => [ { name => 'total_waits', per_second => 1 }, { name => 'display' } ],
output_template => 'Total Waits : %.2f/s',
perfdatas => [
{ label => 'total_waits', template => '%.2f',
unit => '/s', min => 0, label_extra_instance => 1, instance_use => 'display' },
],
}
},
{ label => 'total-waits-time', set => {
key_values => [ { name => 'time_waited_micro', diff => 1 }, { name => 'display' } ],
closure_custom_calc => $self->can('custom_usage_calc'),
output_template => 'Total Waits Time : %.2f %%', output_use => 'prct_wait', threshold_use => 'prct_wait',
perfdatas => [
{ label => 'total_waits_time', value => 'prct_wait', template => '%.2f', min => 0, max => 100, unit => '%',
label_extra_instance => 1, instance_use => 'display' },
],
}
},
],
}
sub custom_usage_calc {
my ($self, %options) = @_;
$self->{result_values}->{display} = $options{new_datas}->{$self->{instance} . '_display'};
my $delta_total = $options{new_datas}->{$self->{instance} . '_time_waited_micro'} - $options{old_datas}->{$self->{instance} . '_time_waited_micro'};
$self->{result_values}->{prct_wait} = 100 * ($delta_total / 1000000) / $options{delta_time};
return 0;
}
sub new {
my ($class, %options) = @_;
my $self = $class->SUPER::new(package => __PACKAGE__, %options, statefile => 1);
bless $self, $class;
$options{options}->add_options(arguments => {
'filter-name:s' => { name => 'filter_name' },
'wait-time-min:s' => { name => 'wait_time_min', default => 1000 },
'show-details' => { name => 'show_details' }
});
return $self;
}
sub prefix_event_output {
my ($self, %options) = @_;
return "Event '" . $options{instance_value}->{display} . "' ";
}
sub event_count_and_details {
my ($self, %options) = @_;
my $query_count = "SELECT count(*) as NB
FROM v\$session
WHERE WAIT_TIME_MICRO>" . $self->{option_results}->{wait_time_min} . "
AND status='ACTIVE' and WAIT_CLASS <>'Idle'";
$self->{sql}->query(query => $query_count);
my $result = $self->{sql}->fetchrow_hashref();
$self->{event_count}->{count} = $result->{NB};
if (defined($self->{option_results}->{show_details})) {
my $query_details = "SELECT
a.username USERNAME,
a.program PROGRAM,
a.event EVENT,
round(a.WAIT_TIME_MICRO/1000000,0) SEC_WAIT,
d.sql_text SQL_TEXT
FROM
v\$session a,
v\$sqlstats d
WHERE
a.sql_id = d.sql_id
and a.status='ACTIVE'
and a.wait_class <> 'Idle'
and WAIT_TIME_MICRO>" . $self->{option_results}->{wait_time_min} . "
and a.sid not in (SELECT SID FROM V\$SESSION WHERE audsid = userenv('SESSIONID'))
ORDER BY
a.WAIT_TIME_MICRO desc";
$self->{sql}->query(query => $query_details );
while (my $result = $self->{sql}->fetchrow_hashref()) {
$self->{output}->output_add(long_msg => sprintf("Username: '%s', Program: '%s' Event: '%s', Second wait: '%s's, Details: '%s'\n",
$result->{USERNAME}, $result->{PROGRAM}, $result->{EVENT}, $result->{SEC_WAIT}, $result->{SQL_TEXT}));
}
}
}
sub manage_selection {
my ($self, %options) = @_;
$self->{sql} = $options{sql};
$self->{sql}->connect();
my $query = q{
SELECT e.event#, e.name,
NVL(s.total_waits, 0), NVL(s.total_timeouts, 0), NVL(s.time_waited, 0),
NVL(s.time_waited_micro, 0), NVL(s.average_wait, 0)
FROM v$event_name e LEFT JOIN sys.v_$system_event s ON e.name = s.event
};
if ($self->{sql}->is_version_minimum(version => '10')) {
$query = q{
SELECT e.event_id, e.name,
NVL(s.total_waits, 0), NVL(s.total_timeouts, 0), NVL(s.time_waited, 0),
NVL(s.time_waited_micro, 0), NVL(s.average_wait, 0)
FROM v$event_name e LEFT JOIN sys.v_$system_event s ON e.name = s.event
};
}
$self->{sql}->query(query => $query);
my $result = $self->{sql}->fetchall_arrayref();
$self->{event} = {};
foreach my $row (@$result) {
my ($name, $total_waits, $time_waited_micro) = ($row->[1], $row->[2], $row->[5]);
if (defined($self->{option_results}->{filter_name}) && $self->{option_results}->{filter_name} ne '' &&
$name !~ /$self->{option_results}->{filter_name}/) {
$self->{output}->output_add(long_msg => "skipping '" . $name . "': no matching filter.", debug => 1);
next;
}
$self->{event}->{$name} = {
display => $name,
total_waits => $total_waits,
time_waited_micro => $time_waited_micro
};
}
if ($self->{sql}->is_version_minimum(version => '10')) {
$self->event_count_and_details();
}
$self->{sql}->disconnect();
if (scalar(keys %{$self->{event}}) <= 0) {
$self->{output}->add_option_msg(short_msg => "No event found.");
$self->{output}->option_exit();
}
$self->{cache_name} = "oracle_" . $self->{mode} . '_' . $self->{sql}->get_unique_id4save() . '_' .
(defined($self->{option_results}->{filter_counters}) ? md5_hex($self->{option_results}->{filter_counters}) : md5_hex('all')) . '_' .
(defined($self->{option_results}->{filter_name}) ? md5_hex($self->{option_results}->{filter_name}) : md5_hex('all'));
}
1;
__END__
=head1 MODE
Check Oracle event wait usage.
=over 8
=item B<--warning-*>
Threshold warning.
Can be: 'total-waits-sec', 'total-waits-time', 'event-count'.
=item B<--critical-*>
Threshold critical.
Can be: 'total-waits-sec', 'total-waits-time', 'event-count'.
=item B<--filter-name>
Filter by event name. Can be a regex.
=item B<--wait-time-min>
Time in ms above which we count an event as waiting
=item B<--show-details>
Print details of waiting events (user, query, ...) in long output
=back
=cut