- Repository
- Munin (contrib)
- Last change
- 2018-03-09
- Graph Categories
- Family
- auto
- Capabilities
- Keywords
- Language
- Perl
- Authors
djabberd_
Sadly there is no documentation for this plugin.
#!/usr/bin/perl -w
#
# Copyright (C) 2012 Dominik Schulz <dominik.schulz@gauner.org>
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; version 2 dated June,
# 1991.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
#
# Script to monitor DJabberd servers.
# Mostly an adaptation of Guillaume Blairon's mogliefsd_activity script.
#
# Usage:
# ln -s /usr/share/munin/plugins/djabberd_ \
# /etc/munin/plugins/djabberd_{connections,memory,latency,counters}
#
# Configuration variables:
#
# host (default: '127.0.0.1')
# port (default: '5200')
#
# Parameters:
#
# config (required)
# autoconf (optional - only used by munin-config)
#
#%# family=auto
#%# capabilities=autoconf
use strict;
use warnings;
use IO::Socket;
my $djabberd_host = $ENV{host} || "127.0.0.1";
my $djabberd_port = $ENV{port} || 5200;
my $mode = undef;
my $mode_name = undef;
# mapping mode to command from which we get the information
my $mode_ref = {
'connections' => {
'cmd' => 'stats',
'title' => 'DJabberd Connections',
'vlabel' => 'connections',
'fields' => {
'connections' => {
'key' => 'connections',
'label' => 'Connections',
'description' => 'Number of current connections',
'draw' => 'LINE1',
'type' => 'GAUGE',
},
'users' => {
'key' => 'users',
'label' => 'Users',
'description' => 'Number of connected users',
'draw' => 'LINE1',
'type' => 'GAUGE',
},
},
},
'memory' => {
'cmd' => 'stats',
'title' => 'DJabberd Memory Statistics',
'vlabel' => 'Bytes',
'fields' => {
'mem_total' => {
'key' => 'mem_total',
'label' => '',
'description' => 'Total memory used by DJabberd',
'draw' => 'LINE1',
'type' => 'GAUGE',
'filter' => \&kb2bytes,
},
'mem_connections' => {
'key' => 'mem_connections',
'label' => '',
'description' => 'Memory used for handling connections',
'draw' => 'LINE1',
'type' => 'GAUGE',
'filter' => \&kb2bytes,
},
'mem_per_connection' => {
'key' => 'mem_per_connection',
'label' => '',
'description' => 'Memory used per connection',
'draw' => 'LINE1',
'type' => 'GAUGE',
'filter' => \&kb2bytes,
},
}
},
'latency' => {
'cmd' => 'latency',
'title' => 'DJabberd Latency Statistics',
'vlabel' => 'reqs.',
'fields' => {
'dotzerozerozerofive' => {
'key' => '-0.0005',
'label' => 'lt. 0.0005',
'description' => 'Requests handled in lt. 0.0005s',
'draw' => 'AREA',
'type' => 'COUNTER',
},
'dotzerozeroone' => {
'key' => '-0.001',
'label' => 'lt. 0.001',
'description' => 'Requests handled int lt. 0.001s',
'draw' => 'STACK',
'type' => 'COUNTER',
},
'dotzerozerotwo' => {
'key' => '-0.002',
'label' => 'lt. 0.002',
'description' => 'Requests handled int lt. 0.002s',
'draw' => 'STACK',
'type' => 'COUNTER',
},
'dotzerozerofive' => {
'key' => '-0.005',
'label' => 'lt. 0.005',
'description' => 'Requests handled int lt. 0.005s',
'draw' => 'STACK',
'type' => 'COUNTER',
},
'dotzeroone' => {
'key' => '-0.01',
'label' => 'lt. 0.01',
'description' => 'Requests handled int lt. 0.01s',
'draw' => 'STACK',
'type' => 'COUNTER',
},
'dotzerotwo' => {
'key' => '-0.02',
'label' => 'lt. 0.02',
'description' => 'Requests handled int lt. 0.02s',
'draw' => 'STACK',
'type' => 'COUNTER',
},
}
},
'counters' => {
'cmd' => 'counters',
'title' => 'DJabberd Counters',
'vlabel' => 'msgs.',
'fields' => {
'clientin_djabberd_iq' => { 'key' => 'ClientIn:DJabberd::IQ', 'type' => 'COUNTER', },
'clientin_djabberd_message' => { 'key' => 'ClientIn:DJabberd::Message', 'type' => 'COUNTER', },
'clientin_djabberd_presence' => { 'key' => 'ClientIn:DJabberd::Presence', 'type' => 'COUNTER', },
'clientin_djabberd_stanza_sasl' => { 'key' => 'ClientIn:DJabberd::Stanza::SASL', 'type' => 'COUNTER', },
'clientin_djabberd_stanza_starttls' => { 'key' => 'ClientIn:DJabberd::Stanza::StartTLS', 'type' => 'COUNTER', },
'iniq_get_info_query' => { 'key' => 'InIQ:get-{http://jabber.org/protocol/disco#info}query', 'type' => 'COUNTER', },
'iniq_get_items_query' => { 'key' => 'InIQ:get-{http://jabber.org/protocol/disco#items}query', 'type' => 'COUNTER', },
'iniq_get_roster_query' => { 'key' => 'InIQ:get-{jabber:iq:roster}query', 'type' => 'COUNTER', },
'iniq_get_bind' => { 'key' => 'InIQ:set-{urn:ietf:params:xml:ns:xmpp-bind}bind', 'type' => 'COUNTER', },
'iniq_get_session' => { 'key' => 'InIQ:set-{urn:ietf:params:xml:ns:xmpp-session}session', 'type' => 'COUNTER', },
'serverin_djabberd_stanza_dialback_result' => { 'key' => 'ServerIn:DJabberd::Stanza::DialbackResult', 'type' => 'COUNTER', },
'serverin_djabberd_stanza_dialback_verify' => { 'key' => 'ServerIn:DJabberd::Stanza::DialbackVerify', 'type' => 'COUNTER', },
'auth_success' => { 'key' => 'auth_success', 'type' => 'COUNTER', },
'c2s_message' => { 'key' => 'c2s-Message', 'type' => 'COUNTER', },
'c2s_presence' => { 'key' => 'c2s-Presence', 'type' => 'COUNTER', },
'connect' => { 'key' => 'connect', 'type' => 'COUNTER', },
'deliver_local' => { 'key' => 'deliver_local', 'type' => 'COUNTER', },
'deliver_s2s' => { 'key' => 'deliver_s2s', 'type' => 'COUNTER', },
'disconnect' => { 'key' => 'disconnect', 'type' => 'COUNTER', },
},
},
};
if ( $0 =~ m/djabberd_(.*)$/ && $mode_ref->{$1} ) {
$mode_name = $1;
$mode = $mode_ref->{$mode_name};
}
else {
print STDERR "ERROR: Unknown mode '$mode'. Exiting.\n";
exit -1;
}
if ( $ARGV[0] && $ARGV[0] eq 'suggest' ) {
print join( "\n", keys %$mode_ref );
exit 0;
}
elsif ( $ARGV[0] && $ARGV[0] eq "autoconf" ) {
my $result_ref = &query_djabberd( $djabberd_host, $djabberd_port, $mode );
if ($result_ref) {
print "yes\n";
}
else {
print "no\n";
}
exit 0;
}
elsif ( $ARGV[0] and $ARGV[0] eq "config" ) {
print "graph_title " . $mode->{'title'} . "\n";
print "graph_vlabel " . $mode->{'vlabel'} . "\n";
print "graph_args -l 0\n";
print "graph_category chat\n";
foreach my $field_name ( keys %{ $mode->{'fields'} } ) {
my $label = $mode->{'fields'}->{$field_name}->{'label'} || $field_name;
my $desc = $mode->{'fields'}->{$field_name}->{'description'} || $mode->{'fields'}->{$field_name}->{'key'};
my $draw = $mode->{'fields'}->{$field_name}->{'draw'} || 'LINE1';
my $type = $mode->{'fields'}->{$field_name}->{'type'} || 'COUNTER';
print $field_name. '.label ' . $label . "\n";
print $field_name. '.description ' . $desc . "\n";
print $field_name. '.draw ' . $draw . "\n";
print $field_name. '.type ' . $type . "\n";
}
exit 0;
}
else {
my $result_ref = &query_djabberd( $djabberd_host, $djabberd_port, $mode );
foreach my $field_name ( keys %{ $mode->{'fields'} } ) {
my $key = $mode->{'fields'}->{$field_name}->{'key'};
if ( defined( $result_ref->{$key} ) ) { # check for definedness, may well be zero (false for perl)
my $value = $result_ref->{$key};
# if there is a filter defined for this key apply it now
if ( exists( $mode->{'fields'}->{$field_name}->{'filter'} ) && ref( $mode->{'fields'}->{$field_name}->{'filter'} ) eq 'CODE' ) {
$value = &{ $mode->{'fields'}->{$field_name}->{'filter'} }($value);
}
print $field_name. ".value " . $value . "\n";
}
}
}
sub query_djabberd {
my ( $host, $port, $mode ) = @_;
my $conn = IO::Socket::INET::->new(
PeerAddr => $host,
PeerPort => $port,
Proto => 'tcp',
Timeout => 5,
) or die($!);
my $request = $mode->{'cmd'} . "\n";
$conn->syswrite( $request, length($request) );
my @lines = ();
while ( my $line = $conn->getline() ) {
if ( $line =~ /^\./ ) {
last;
}
push( @lines, $line );
}
close($conn);
my $result_ref = {};
foreach my $line (@lines) {
my ( $key, $value, $unit ) = split /\s+/, $line;
if ( $key && $value ) {
$result_ref->{$key} = $value;
}
}
return $result_ref;
}
# transform kb => bytes
sub kb2bytes {
my $num = shift;
if ( $num && $num =~ m/^\d+$/ ) {
$num *= 1024;
}
return $num;
}