https://github.com/liske/najabo
NaJaBo (Nagios Jabber Bot) provides a nagios status summary as a XMPP JID.
https://github.com/liske/najabo
Last synced: 2 months ago
JSON representation
NaJaBo (Nagios Jabber Bot) provides a nagios status summary as a XMPP JID.
- Host: GitHub
- URL: https://github.com/liske/najabo
- Owner: liske
- License: gpl-2.0
- Created: 2011-01-04T01:34:11.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2018-01-03T22:53:07.000Z (over 7 years ago)
- Last Synced: 2025-01-19T17:24:31.301Z (4 months ago)
- Language: Perl
- Homepage:
- Size: 85.9 KB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: COPYING
Awesome Lists containing this project
README
najabod
=======
About
-----
najabod is a Nagios Jabber Bot. najabod connects to a XMPP server as a
XMPP client. It reads the nagios status log and shows an overview of the
current states of the monitored nodes. Further version will allow you
to query detailed informations, acknowledge problems and schedule
downtimes etc.
The current version has no ACL and did not support precense
subscription, yet. You will need to do the presence subscription with
your favorite XMPP client or use a XMPP server with shared roster
support like ejabberd.
Status flags
------------
- `D` - host/service is down
- `C` - host/service is critical
- `W` - host/service is warning
- `F` - host/service state is flapping
Interactive commands
--------------------
User commands:
- `lh [host]`
list hosts
- `hd `
host details
- `ls [host] [service]`
list services
- `sd `
service details
- `lp`
list problems
- `help`
show command list
Admin commands:
- `ack `
acknowledge problem
- `dt `
schedule downtime
Implemented XEPs
----------------
najabod has the following XEPs implemented:
- XEP-0012: Last Activity
- XEP-0030: Service Discovery
- XEP-0054: vcard-temp
- XEP-0092: Software Version
- XEP-0199: XMPP Ping
- XEP-0202: Entity Time
SRV lookup support in Net::XMPP
-------------------------------
Net::XMPP did not support SRV records to get the XMPP server of the
users JID. XMPP requires the client to lookup the server by SRV records
in the DNS. See also the following bug reports including a fix:
- http://rt.cpan.org/Public/Bug/Display.html?id=18539#txn-249050
- http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=325658
To get SRV lookup work, you must have at least
- Net::XMPP >= 1.02_02
- XML::Stream >= 1.23_04
installed and enable the following lines in your najabo.conf:
```perl
$xmpp_conf{'componentname'} = $xmpp_conf{'hostname'};
$xmpp_conf{'srv'} = 1;
```