• Nagroid
• Notification Bar
• Screens
• Problems
• Configuration
• Log
• Author
• Known Bugs
• ChangeLog
Nagroid
Nagroid is an unofficial nagios client for android devices.
At the moment there is only basic viewing support implemented - future version will improve.
Notification Bar
The Nagroid icon in the notification bar indicates different information through its color scheme.
The icon can be seperated into three parts: head, left arm and right arm
His head indicates if the last poll was successfull. A fail can be a wrong nagios url, missing or wrong password, SSL problems, nagios failure or simple network timeouts.
His left arm indicates host problems.
(Ok, Down/Unreachable, Pending, Local Error)
His right arm indicates service problems.
(Ok, Warning, Critical, Pending, Unknown, Local Error)
This icon indicates that an update for Nagroid is available in the android market.
Screens
Problems
The Problems screen shows all problems reported by nagios (depending on the "Unhandled Only" option).
All hosts with problems and hosts where at least one services has a problem are listed.
Configuration
• Url
The Url pointing to your nagios instance. Please specify the cgi-bin directory!
Eg: http://example.org/cgi-bin/nagios2/
• Self Signed Certificate
If your nagios uses https and is signed by a trusted certificate authority you can leave this unchecked. But if you want to use a self signed certificate, you have to enable this option.
But be aware: You turn off all certificate checks! No hostname check, no fingerprint matching, nothing! Your connection will still be encrypted, but anybody can try a man-in-the-middle attack on your account!
• Http Basic Auth
If your nagios instance needs a password to login, you can enable this option.
• Interval
Its the interval, amazing isnt it?
• Unhandled Only
Show all or unhandled (notification enabled, not acknowledged, etc) problems only.
• Vibrate
On every poll it is checked if there is at least one host or service which has a non OK state. Hosts and services vibrate differently, where a host problems are more important than service problems.
• Hide If Ok
Hide Nagroid icon in the notification bar if everything is ok.
• Autostart
Autostart nagroid after android is rebooted.
• Nagroid Updates
Check if there are updates for nagroid available.
Log
A simple log screen. It will help you sorting out problems with nagios configuration.
Author
Simon Schoar
email: android@schoar.de
twitter: https://twitter.com/kiu112
blog: http://blog.schoar.de
project: http://code.google.com/p/nagroid/
Waiting for your bugreports, donations, flamewars, rickrolls, ...
Known Bugs
• To reduce bandwidth usage, the nagios WML interface is used for polling. This interface does not provide hosts and services which are fine.
• Application state is sometimes wrong - ProblemsActivityScreen is empty after sleep
ChangeLog
• v0.0.7
- Regression fixed: configuration gets lost (i am stupid)
• v0.0.6
- Fixed: Reenabling bug - Sorry for the inconvenience!
- Removed vibration on local errors
• v0.0.5
- Fixed: Annoying vibration bug on v1.5 firmware devices. Runs in endless loop
- New: Play sound alarams on problems
• v0.0.4
- Fixed: configuration gets lost (google implementation is not thread safe)
- Fixed: Updater polled too often, remembers last poll time now
- Fixed: Icon sometimes didnt update, vibrates were ignored
• v0.0.3
- Polling requests (scheduled or manual) are ignored, if polling is already running
- Added shorter polling intervals
- Application state fixed: Last successfull poll on ProblemsActivityScreen is correct now
- Application state fixed: Logs are persisted now
- On polling interval changes the system reschedules correctly now
- Polling service can be enabled/disabled. (This is a kind of exit button some users asked for)
- Modified ProblemsActivityScreen a bit
- Added option to hide icon if everything is ok
• v0.0.2
- Reuse elements of BaseAdapter for ProblemsActivity (speedup, lower memory footprint)
- Added menus
- Added minimal support for logging
• v0.0.1
- Initial release, yeah!