Skip to content

configuration client

Jump to bottom
Christian Stankowic edited this page Dec 21, 2016 · 4 revisions

This page gives an overview about the configuration possibilites of IcingaBusylightAgent. To open the dialog, right-click the tray icon and click Configure.

Icinga2 tab

The major input fields are:

  • Icinga2 URL: URL of your Icinga2 installation including protocal and port (e.g. https://myhost.localdomain.loc:5665/)
  • Username: API user (e.g. simone)
  • Password: appropriate password (e.g. giertz)
  • Timer: Time interval, the agent will check for changes in your environment (e.g. 5 minutes)

Clicking Validate after providing correct Icinga2 settings will give you the possibility to select one or multiple hostgroups. If selected, only hosts and services in these hostgroups will be evaluated. By checking Hosts and/or Services you can specify event types that should be reported.

Notification tab

The settings include:

  • Busylight sound - select one of the available Busylight sounds
  • Volume - select one of the Busylight volume levels:
    • Mute
    • Low
    • Middle
    • High
    • Max
  • Sound file - select a conventional WAV sound for reporting faults
  • Colors - specify colors per event state:
    • Up / Okay: Host up or service okay
    • Down / Critical: Host down or service critical
    • Unreachable / Warning: Host unreachable or service warning
    • Unknown: Service in unknown state
  • Balloon tips
    • Enable Balloon tips - balloon tips are displayed for hosts and/or services
    • Spam thresholds - will omit balloon tips if the defined threshold is exceeded

Specifying a sound file has no impact on pre-existing Busylight sound settings. It will be played additionally using your local sound device - it can't be played on the Busylight device.

Other tab

This tab mostly controls debugging. In case you're achieving errors and want to get help (see also this page) configure the following settings:

  • Log mode - method used for displaying/storing debug messages:
    • Console - messages are printed to Visual Studio console (for developers only, default)
    • File - creates a log file in the same directory the agent resides in
    • EventLog - reports messages to your system event log
  • Log level - verbosity level of messages:
    • Error: only displays errors
    • Info: displays errors and information
    • 50 stacks of trace: displays all the dirty debug messages, useful for bug reports

The following other options can be specified:

  • Enable Lync/SfB workaround - automatically restores the Busylight color appropriate to your Lync/SfB state after alarms
  • Show version during start - displays the version of IcingaBusylightAgent after startup
Clone this wiki locally