stdevel / icingabusylightagent

Icinga2 notification agent for Kuando Busylights

IcingaBusylightAgent

Icinga Busylight Agent is - how unsual - an Icinga2 notification agent for Plenom Kuando Busylights. It will connect to your Icinga2 instance and check for host and service events. Faulty hosts and services will generate audible and visible events - you can configure colors and ringtones.

Currently, the software is at a very early stage. Some features are missing, see the issues tab for bugs and upcoming functions.

Demonstration

Check out the following video for a demonstration:

Additional screenshots can be found on my blog.

Requirements

To use this tool, you will need:

• .NET Framework 4.x
• Plenom Kuando Busylight (I tried Omega, but Alpha should work as well)
• A valid Icinga2 API user

Configuration

To configure the agent, you need to specify the following settings:

• Icinga2 URL, e.g. https://myhost.localdomain.loc:5665/
• API username
• API password

A configure dialog is started by right-clicking the trayicon and clicking Configure. This dialog also gives you additional possibilities for customization (e.g. sounds, colors, hostgroup filters,...). See the wiki for more details.

icingabusylightagent's Issues

Previous state overridden after agent start

When used along with Skype for Business, the color is overridden once the agent starts and the Busylight SDK is initialized. As a result, it is necessary to manually restore the Skype for Business state (available, away, etc.).
It would be handy if the tool automatically restores the previous color.

Changing settings requires restarting the Agent

Currently, changing the settings requires restarting the Agent

Implement localization

Currently the application is english-only.

Validate Icinga2 settings before storing changes

The settings dialog could verify settings before storing changes.

Implement logging

Currently, debugging is only possible within Visual Studio. It would be handy to have a log file engine.

Dynamic hostgroup filter

A dynamic hostgroup filter is not implemented, yet - only a prepared setting..

Implement systray tooltips

Currently the busylight flashes/rings, there is no information about the appropriate host or service name. It would be great to have systray tooltips.
It would also be great to have the possibility to acknowledge data from the tooltip to avoid further popups.

Frontend frozen when background thread is blocked

When the background thread is blocked (e.g. running an update on a new configured client without credentials), the frontend is frozen until the block is released (e.g. error message shown).

API connection fragile

Sometimes API requests over lazy network connections will just fail forcing annoying message boxes to be shown:

• disable message boxes (use tray icon instead?)
• fix reconnection

Possibility to import SSL certificate

Currently SSL certification errors are simply ignored. It would be handy to have the possibility to check and import the certificate.

Evaluate host events

Currently, only service events are evaluated. It would be good to also include host events (host down, host unreachable,...).

Implement hostgroup filter

It would be great to have the possibility to filter on specific hostgroups. The configuration dialog could show a list of available hostgroups.

Play conventional sounds

Some users might want to specify a sound that is played on the computer instead of having the Busylight play sounds.

About dialog empty

Currently the about dialog is just empty.

Implement manual update / timer countdown

It would be great to be able to manually update data from the systray context menu or see when the next update will be triggered, e.g. Update data (23:40)

• manual update (done in commit c08dff6)
• timer countdown

Relocate notification routines into Program

Currently, the Icinga2Client class implements controlling the Busylight. I'd like to separate this as Icinga2Client should only implement data handling. As the Program class also controls tooltips, it also should control the notifications.

Implement filter on API level

Currently, the API call filters for hosts/services that are not okay. Filtering for non-acknowledged entries is implemented on application level as it is not possible to supply multiple filters using HTTP GET.
In accordance with the Icinga2 API documentation this can be implemented with POST.
So, it is required to replace:

GET: https://myhost:5665/v1/objects/hosts?filter=host.state!=0&attrs=name&attrs=state&attrs=acknowledgement
GET: https://myhost:5665/v1/objects/services?filter=service.state!=0&attrs=name&attrs=state&attrs=acknowledgement

With a application/json formatted POST like this:

{ "type": "Host", "filter": "host.state!=0 && host.acknowledgement!=0" }
{ "type": "Service", "filter": "service.state!=0 && service.acknowledgement!=0" }

DND / Presentation mode

It would be great to have a feature disabling notifications when being in DND (check SfB?) or presentation mode (check Windows 8.1+ settings?)