centreon-plugins/centreon/common/microsoft/skype/mssql/mode/appsharingqoe.pm

156 lines
5.7 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 centreon::common::microsoft::skype::mssql::mode::appsharingqoe;
use base qw(centreon::plugins::templates::counter);
use strict;
use warnings;
sub set_counters {
my ($self, %options) = @_;
$self->{maps_counters_type} = [
{ name => 'global', type => 0, skipped_code => { -10 => 1 } },
{ name => 'count', type => 0 },
];
$self->{maps_counters}->{global} = [
{ label => 'spoiled-tile-prct-total-avg', set => {
key_values => [ { name => 'SpoiledTilePercentTotal' } ],
output_template => 'Average Spoiled Tiles: %.2f%%',
perfdatas => [
{ label => 'spoiled_tile_prct_total_avg', value => 'SpoiledTilePercentTotal',
template => '%.2f', unit => '%', min => 0, max => 100 },
],
}
},
{ label => 'rdp-tile-processing-latency-avg', set => {
key_values => [ { name => 'RDPTileProcessingLatencyAverage' } ],
output_template => 'Average RDP Tiles Processing Latency: %.2f ms',
perfdatas => [
{ label => 'rdp_tile_processing_latency_avg', value => 'RDPTileProcessingLatencyAverage',
template => '%.2f', unit => 'ms', min => 0 },
],
}
},
{ label => 'relative-one-way-average', set => {
key_values => [ { name => 'RelativeOneWayAverage' } ],
output_template => 'Average Amount of One-way Latency: %.2f ms',
perfdatas => [
{ label => 'relative_one_way_average', value => 'RelativeOneWayAverage',
template => '%.2f', unit => 'ms', min => 0 },
],
}
},
];
$self->{maps_counters}->{count} = [
{ label => 'stream-count', set => {
key_values => [ { name => 'TotalStreams' } ],
output_template => 'Streams Count: %.2f/s',
perfdatas => [
{ label => 'stream_count', value => 'TotalStreams', template => '%.2f',
unit => 'streams/s', min => 0 },
],
}
},
];
}
sub new {
my ($class, %options) = @_;
my $self = $class->SUPER::new(package => __PACKAGE__, %options);
bless $self, $class;
$options{options}->add_options(arguments =>
{
"timeframe:s" => { name => 'timeframe', default => '900' },
"filter-counters:s" => { name => 'filter_counters', default => '' },
});
return $self;
}
sub manage_selection {
my ($self, %options) = @_;
$self->{sql} = $options{sql};
$self->{sql}->connect();
my $query = "SELECT AVG(SpoiledTilePercentTotal) AS SpoiledTilePercentTotal,
AVG(RDPTileProcessingLatencyAverage) AS RDPTileProcessingLatencyAverage,
AVG(RelativeOneWayAverage) AS RelativeOneWayAverage,
COUNT(*) AS TotalStreams
FROM [QoEMetrics].[dbo].AppSharingStream
WHERE ConferenceDateTime > (DATEADD(SECOND,-" . $self->{option_results}->{timeframe} . ",SYSUTCDATETIME()))
AND ConferenceDateTime < SYSUTCDATETIME()";
$self->{sql}->query(query => $query);
my $results = $self->{sql}->fetchrow_hashref;
$self->{global} = {
SpoiledTilePercentTotal => (defined($results->{SpoiledTilePercentTotal})) ? $results->{SpoiledTilePercentTotal} : 0,
RDPTileProcessingLatencyAverage => (defined($results->{RDPTileProcessingLatencyAverage})) ? $results->{RDPTileProcessingLatencyAverage} : 0,
RelativeOneWayAverage => (defined($results->{RelativeOneWayAverage})) ? $results->{RelativeOneWayAverage} : 0,
};
$self->{count}->{TotalStreams} = $results->{TotalStreams} / $self->{option_results}->{timeframe};
}
1;
__END__
=head1 MODE
Check app sharing QoE metrics from SQL Server (Lync 2013, Skype 2015).
MS Recommandations :
SpoiledTilePercentTotal (Total percentage of the content that did not reach the viewer but was instead discarded and overwritten by fresh content) > 36
RDPTileProcessingLatencyAverage (Average processing time for remote desktop protocol (RDP) tiles. A higher total equates to a longer delay in the viewing experience) > 400
RelativeOneWayAverage (Average amount of one-way latency. Relative one-way latency measures the delay between the client and the server) > 1.75
=over 8
=item B<--filter-counters>
Only display some counters (regexp can be used).
=item B<--timeframe>
Set the timeframe to query in seconds (Default: 900)
=item B<--warning-*>
Set warning thresholds.
Can be : 'spoiled-tile-prct-total-avg', 'rdp-tile-processing-latency-avg',
'relative-one-way-average'
=item B<--critical-*>
Set critical thresholds.
Can be : 'spoiled-tile-prct-total-avg', 'rdp-tile-processing-latency-avg',
'relative-one-way-average'
=back
=cut