op5 Monitor (Download v0.3.0)

This is an Alfred 2 workflow for the commercial Nagios-based network monitoring solution op5 Monitor developed and sold by the swedish company (op5).

Requirements

1. Alfred App v. 2
2. Alfred Powerpack
3. op5 Monitor v. 7.0 or higher

Installing

1. Click the download buttons on the top of this page
2. Double-click to import into Alfred 2
3. Review the workflow to add custom Hotkeys

Updating

Unfortunately the Alleyoop Workflow that offered a great package manager for Alfred workflows seems to be discontinued. This workflow still follows the requirements to work with Alleyoop, but it will probably move over to Packal soon. You can find more information about Packal here.

About

Alfred App Workflow for op5 Monitor.

Query module

The query module contains the main functions of this workflow and can be called from the Alfred popup by typing the shortcut command "mon" by default.

Querying Shortcuts

The query module can query op5 Monitor for several object types by prefixing the query with one of the following options:

• h: for hosts,
• s: for services,
• g: for host groups,
• G: for service groups and
• f: or + for saved filters
• n: for notifications

You can add search queries to each of the above mentioned query prefixes. Text entered after the prefix is handled as search query. You can even use regular expressions.

• mon h:host-00[123]

This example will list hosts "host-001", "host-002", "host-003" if existing.

Additionally, you can add a ! before the search query to negate the search query:

• mon h:!host

This example will show all hosts that do not contain the word "host" in their names and aliases.

Last but not least, you can use the # suffix to any of the queries to ONLY list objects with PROBLEMS:

• mon g:#

This example will list all host groups (not filtering by name) that contain any non-OK services.

Querying with Listview-filters

By using the ' prefix you can directly enter a listview filter. Listview filters were introduced in the user interface of op5 Monitor in version 6.1. They are a great way to customize the view a list view provides. This Alfred workflow makes a lot of use of these listview filters. When entering a listview filter directly via the ' prefix, none of the above mentioned additional filter options auch as # and ! can be used. But, in any case, you can always change the filter syntax directly in Alfred's prompt.

Object navigation using the tab key

Most of the displayed objects (in fact, all except "services" as they are the most low-level objects in the chain) support two options: tab-completion to jump into the next lower-level element and enter action for object-related actions.

Tab-completion works as follows:

• hosts tab completion leads to a service overview for this specific host
• host group tab completion leads to an overview of all members of the host group including their corresponding states
• service group tab completion leads to an overview of all services in this specific service group, including their states
• saved filters tab completion leads to the actual result of the corresponding filter

Select-action for objects

On every displayed object such as hosts, services etc. you can hit the key and you will get directed to the op5 Monitor web user interface displaying the corresponding object. This way, pressing on a host object takes you to a list of all services of this host, and from a host group object it takes you to a list of all hosts within this host group, and so on.

Beside of the actions there also are some object-specific actions that you can call by hitting - when selecting any object from within the query module. This action will take you to a separate module of this workflow, the Actions module that offers additional object-specific actions.

The Actions module

This module offers several actions depending on the object type, the state and other metadata of the selected object:

• The first line will always contain the type and the name of the object. Hitting from here takes you to the object's details in your op5 Monitor web UI, the same that would happen pressing the key directly on an object from within the query module.
• Depending on if the specific object has performance graphs (only applicable to host and service objects), an option that takes you directly to the page with the performance graphs will be shown.
• Depending on the type and the state of the object and the objects belonging to it, options that allows you to ACKNOWLEDGE one or several host/service problems at the same time are displayed. The ACKNOWLEDGE will be executed after you supplied an acknowledgement comment. You can acknowledge a single host problem and all this host's service problems at the same time, or all service problems on OK hosts within a whole host group and much more.
• For all host, hostgroup, service and servicegroup object, a re-check option is displayed. This option allows you to send op5 Monitor a command to re-check objects immediately in order to update their state. There are options to re-check many objects at the same time, such as "all services belonging to a specific host" or "all hosts and their services belonging to a certain host group".
• For hosts and services, "Notifications" and eventually "Notifications for Host" options will be displayed. With these, you can directly jump into a list of all notifications for the specific object.

Configuration module

By calling the workflow with the monconf command you will be presented with the options to configure the following necessary values:

• hostname (op5 Monitor FQDN or IP address)
• username for op5 Monitor login
• password
• op5 Monitor "HTTP GET authentication"
• Filter notifications by contact name

HTTP GET authentication

op5 Monitor supports HTTP GET authentication so you can authenticate to your op5 Monitor Web UI without being presented a login prompt, just by submitting the username and password within the URL using GET parameters. Note: Authenticating using GET parameters can be a security risk, since the username and password will be part of the URL and therefore can be exposed in various places such as the address bar of the web browser, web server log files and saved bookmarks.

More information on this feature and an explanation on how to enable it in your op5 Monitor installation can be found (here) in the op5 Knowledge Base.

Filtering notifications by contact name

When displaying lists of notifications, the same notification may be displayed several times, because each contact that receives notifications for a certain object is listed as one separate notification. In order to not see duplicated notifications, you can specify to additionally filter the notifications displayed by contact name. This contact name may be the login name for the user that uses this workflow, but depending on your monitoring configuration you might also have a different contact name that you want to use for filtering.

Commands

• mon {query}
• monconf
• op5actions

Donate

This software is free and published under the MIT license. I have created this workflow mainly for myself and thought it could be useful for some others out there. If this workflow is as useful for you as it is for me, and you feel the need to drop me some cents or euros for it, I will not stop you from doing so. Use the following link to donate via PayPal or Flattr.

Follow

I seldom write something on Twitter, but I am there. You can find me with the username (@fibbsanton).