add office 365 teams service
This commit is contained in:
Colin Gagnaire
parent
8c7bb12cf4
commit
62d0bbda3b
|
|
@ -195,6 +195,8 @@ sub request_api_json {
|
|||
|
||||
$self->settings();
|
||||
|
||||
$self->{output}->output_add(long_msg => "URL: '" . $options{full_url} . "'", debug => 1);
|
||||
|
||||
my $content = $self->{http}->request(%options);
|
||||
|
||||
my $decoded;
|
||||
|
|
@ -224,6 +226,8 @@ sub request_api_csv {
|
|||
|
||||
$self->settings();
|
||||
|
||||
$self->{output}->output_add(long_msg => "URL: '" . $options{full_url} . "'", debug => 1);
|
||||
|
||||
my $content = $self->{http}->request(%options);
|
||||
my $response = $self->{http}->get_response();
|
||||
|
||||
|
|
@ -358,6 +362,23 @@ sub office_get_exchange_mailbox_usage {
|
|||
return $response;
|
||||
}
|
||||
|
||||
sub office_get_teams_activity_set_url {
|
||||
my ($self, %options) = @_;
|
||||
|
||||
my $url = $self->{graph_endpoint} . "/v1.0/reports/getTeamsUserActivityUserDetail(period='D7')";
|
||||
|
||||
return $url;
|
||||
}
|
||||
|
||||
sub office_get_teams_activity {
|
||||
my ($self, %options) = @_;
|
||||
|
||||
my $full_url = $self->office_get_teams_activity_set_url(%options);
|
||||
my $response = $self->request_api_csv(method => 'GET', full_url => $full_url, hostname => '');
|
||||
|
||||
return $response;
|
||||
}
|
||||
|
||||
1;
|
||||
|
||||
__END__
|
||||
|
|
|
|||
|
|
@ -0,0 +1,231 @@
|
|||
#
|
||||
# Copyright 2019 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::microsoft::office365::teams::mode::usersactivity;
|
||||
|
||||
use base qw(centreon::plugins::templates::counter);
|
||||
|
||||
use strict;
|
||||
use warnings;
|
||||
|
||||
sub prefix_global_output {
|
||||
my ($self, %options) = @_;
|
||||
|
||||
return "Total ";
|
||||
}
|
||||
|
||||
sub prefix_user_output {
|
||||
my ($self, %options) = @_;
|
||||
|
||||
return "User '" . $options{instance_value}->{name} . "' ";
|
||||
}
|
||||
|
||||
sub set_counters {
|
||||
my ($self, %options) = @_;
|
||||
|
||||
$self->{maps_counters_type} = [
|
||||
{ name => 'global', type => 0, cb_prefix_output => 'prefix_global_output' },
|
||||
{ name => 'users', type => 1, cb_prefix_output => 'prefix_user_output', message_multiple => 'All users activity are ok' },
|
||||
];
|
||||
|
||||
$self->{maps_counters}->{global} = [
|
||||
{ label => 'total-team-chat', set => {
|
||||
key_values => [ { name => 'team_chat' } ],
|
||||
output_template => 'Team Chat Message Count: %d',
|
||||
perfdatas => [
|
||||
{ label => 'total_team_chat', value => 'team_chat_absolute', template => '%d',
|
||||
min => 0 },
|
||||
],
|
||||
}
|
||||
},
|
||||
{ label => 'total-private-chat', set => {
|
||||
key_values => [ { name => 'private_chat' } ],
|
||||
output_template => 'Private Chat Message Count: %d',
|
||||
perfdatas => [
|
||||
{ label => 'total_private_chat', value => 'private_chat_absolute', template => '%d',
|
||||
min => 0 },
|
||||
],
|
||||
}
|
||||
},
|
||||
{ label => 'total-call', set => {
|
||||
key_values => [ { name => 'call' } ],
|
||||
output_template => 'Call Count: %d',
|
||||
perfdatas => [
|
||||
{ label => 'total_call', value => 'call_absolute', template => '%d',
|
||||
min => 0 },
|
||||
],
|
||||
}
|
||||
},
|
||||
{ label => 'total-meeting', set => {
|
||||
key_values => [ { name => 'meeting' } ],
|
||||
output_template => 'Meeting Count: %d',
|
||||
perfdatas => [
|
||||
{ label => 'total_meeting', value => 'meeting_absolute', template => '%d',
|
||||
min => 0 },
|
||||
],
|
||||
}
|
||||
},
|
||||
];
|
||||
$self->{maps_counters}->{users} = [
|
||||
{ label => 'team-chat', set => {
|
||||
key_values => [ { name => 'team_chat' }, { name => 'name' } ],
|
||||
output_template => 'Team Chat Message Count: %d',
|
||||
perfdatas => [
|
||||
{ label => 'team_chat', value => 'team_chat_absolute', template => '%d',
|
||||
min => 0, label_extra_instance => 1, instance_use => 'name_absolute' },
|
||||
],
|
||||
}
|
||||
},
|
||||
{ label => 'private-chat', set => {
|
||||
key_values => [ { name => 'private_chat' }, { name => 'name' } ],
|
||||
output_template => 'Private Chat Message Count: %d',
|
||||
perfdatas => [
|
||||
{ label => 'private_chat', value => 'private_chat_absolute', template => '%d',
|
||||
min => 0, label_extra_instance => 1, instance_use => 'name_absolute' },
|
||||
],
|
||||
}
|
||||
},
|
||||
{ label => 'call', set => {
|
||||
key_values => [ { name => 'call' }, { name => 'name' } ],
|
||||
output_template => 'Call Count: %d',
|
||||
perfdatas => [
|
||||
{ label => 'call', value => 'call_absolute', template => '%d',
|
||||
min => 0, label_extra_instance => 1, instance_use => 'name_absolute' },
|
||||
],
|
||||
}
|
||||
},
|
||||
{ label => 'meeting', set => {
|
||||
key_values => [ { name => 'meeting' }, { name => 'name' } ],
|
||||
output_template => 'Meeting Count: %d',
|
||||
perfdatas => [
|
||||
{ label => 'meeting', value => 'meeting_absolute', template => '%d',
|
||||
min => 0, label_extra_instance => 1, instance_use => 'name_absolute' },
|
||||
],
|
||||
}
|
||||
},
|
||||
{ label => 'last-activity', threshold => 0, set => {
|
||||
key_values => [ { name => 'last_activity_date' }, { name => 'name' } ],
|
||||
output_template => 'Last Activity: %s',
|
||||
}
|
||||
},
|
||||
];
|
||||
}
|
||||
|
||||
sub new {
|
||||
my ($class, %options) = @_;
|
||||
my $self = $class->SUPER::new(package => __PACKAGE__, %options);
|
||||
bless $self, $class;
|
||||
|
||||
$self->{version} = '1.0';
|
||||
$options{options}->add_options(arguments =>
|
||||
{
|
||||
"filter-counters:s" => { name => 'filter_counters' },
|
||||
"filter-user:s" => { name => 'filter_user' },
|
||||
"active-only" => { name => 'active_only' },
|
||||
});
|
||||
|
||||
return $self;
|
||||
}
|
||||
|
||||
sub check_options {
|
||||
my ($self, %options) = @_;
|
||||
$self->SUPER::check_options(%options);
|
||||
}
|
||||
|
||||
sub manage_selection {
|
||||
my ($self, %options) = @_;
|
||||
|
||||
$self->{users} = {};
|
||||
|
||||
my $results = $options{custom}->office_get_teams_activity();
|
||||
|
||||
$self->{global} = { team_chat => 0, private_chat => 0, call => 0, meeting => 0 };
|
||||
|
||||
foreach my $user (@{$results}) {
|
||||
if (defined($self->{option_results}->{filter_user}) && $self->{option_results}->{filter_user} ne '' &&
|
||||
$user->{'User Principal Name'} !~ /$self->{option_results}->{filter_user}/) {
|
||||
$self->{output}->output_add(long_msg => "skipping '" . $user->{'User Principal Name'} . "': no matching filter name.", debug => 1);
|
||||
next;
|
||||
}
|
||||
if ($self->{option_results}->{active_only} && defined($user->{'Last Activity Date'}) && $user->{'Last Activity Date'} eq '') {
|
||||
$self->{output}->output_add(long_msg => "skipping '" . $user->{'User Principal Name'} . "': no activity.", debug => 1);
|
||||
next;
|
||||
}
|
||||
|
||||
$self->{users}->{$user->{'User Principal Name'}}->{name} = $user->{'User Principal Name'};
|
||||
$self->{users}->{$user->{'User Principal Name'}}->{team_chat} = $user->{'Team Chat Message Count'};
|
||||
$self->{users}->{$user->{'User Principal Name'}}->{private_chat} = $user->{'Private Chat Message Count'};
|
||||
$self->{users}->{$user->{'User Principal Name'}}->{call} = $user->{'Call Count'};
|
||||
$self->{users}->{$user->{'User Principal Name'}}->{meeting} = $user->{'Meeting Count'};
|
||||
$self->{users}->{$user->{'User Principal Name'}}->{last_activity_date} = $user->{'Last Activity Date'};
|
||||
|
||||
$self->{global}->{team_chat} += $user->{'Team Chat Message Count'};
|
||||
$self->{global}->{private_chat} += $user->{'Private Chat Message Count'};
|
||||
$self->{global}->{call} += $user->{'Call Count'};
|
||||
$self->{global}->{meeting} += $user->{'Meeting Count'};
|
||||
}
|
||||
|
||||
if (scalar(keys %{$self->{users}}) <= 0) {
|
||||
$self->{output}->add_option_msg(short_msg => "No entry found.");
|
||||
$self->{output}->option_exit();
|
||||
}
|
||||
}
|
||||
|
||||
1;
|
||||
|
||||
__END__
|
||||
|
||||
=head1 MODE
|
||||
|
||||
Check users activity (reporting period over the last 7 days).
|
||||
|
||||
(See link for details about metrics :
|
||||
https://docs.microsoft.com/en-us/office365/admin/activity-reports/microsoft-teams-user-activity?view=o365-worldwide)
|
||||
|
||||
=over 8
|
||||
|
||||
=item B<--filter-user>
|
||||
|
||||
Filter users.
|
||||
|
||||
=item B<--warning-*>
|
||||
|
||||
Threshold warning.
|
||||
Can be: 'total-team-chat', 'total-private-chat', 'total-call',
|
||||
'total-meeting', 'team-chat', 'private-chat', 'call', 'meeting'.
|
||||
|
||||
=item B<--critical-*>
|
||||
|
||||
Threshold critical.
|
||||
Can be: 'total-team-chat', 'total-private-chat', 'total-call',
|
||||
'total-meeting', 'team-chat', 'private-chat', 'call', 'meeting'.
|
||||
|
||||
=item B<--active-only>
|
||||
|
||||
Filter only active entries ('Last Activity' set).
|
||||
|
||||
=item B<--filter-counters>
|
||||
|
||||
Only display some counters (regexp can be used).
|
||||
Example to hide per user counters: --filter-counters='total'
|
||||
|
||||
=back
|
||||
|
||||
=cut
|
||||
|
|
@ -0,0 +1,49 @@
|
|||
#
|
||||
# Copyright 2019 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::microsoft::office365::teams::plugin;
|
||||
|
||||
use strict;
|
||||
use warnings;
|
||||
use base qw(centreon::plugins::script_custom);
|
||||
|
||||
sub new {
|
||||
my ( $class, %options ) = @_;
|
||||
my $self = $class->SUPER::new( package => __PACKAGE__, %options );
|
||||
bless $self, $class;
|
||||
|
||||
$self->{version} = '0.1';
|
||||
%{ $self->{modes} } = (
|
||||
'users-activity' => 'cloud::microsoft::office365::teams::mode::usersactivity',
|
||||
);
|
||||
|
||||
$self->{custom_modes}{graphapi} = 'cloud::microsoft::office365::custom::graphapi';
|
||||
return $self;
|
||||
}
|
||||
|
||||
1;
|
||||
|
||||
__END__
|
||||
|
||||
=head1 PLUGIN DESCRIPTION
|
||||
|
||||
Check Microsoft Office 365 Teams.
|
||||
|
||||
=cut
|
||||
Loading…
Reference in New Issue