Use Nagios with Mobile Admin

This section provides information about how to use the Mobile Admin Client to manage Nagios.

If the address of your Nagios Web Console is not in the format "http://[nagioshostname]/nagios", you must set the address on the Host Properties screen (see setting the Nagios web console address below).

With the exception of setting up the Nagios Web Console Address, the first step in managing Nagios with Mobile Admin is to access the Nagios application. This can be done by selecting the Nagios icon from a view of the Mobile Admin Manage Services screen or from a view of a server reached from the Mobile Admin Manage Hosts screen. Next, enter your Nagios Web Console credentials and select Save.

Detection

Nagios is been detected if a http GET action on http://[nagioshostname]/nagios returns a 401 unauthorized message.

Authentication

Mobile Admin will prompt you for your Nagios credentials.

Communication method

HTML over HTTP is used for managing Nagios.

Troubleshooting

Use a browser on your Mobile Admin server to ensure that you can connect to your Nagios server.

Ensure that Mobile Admin is configured with the correct url for your Nagios server.

Manage the Nagios application

With Mobile Admin, you can view information for hosts and services being monitored.

Set the Nagios web console address

1. Log in to Mobile Admin.
2. Select the server you want to access through the Manage Hosts screen.
3. Select Host Properties on the menu.
4. In the Nagios Web Console Address field, enter the url used to connect to the Nagios web console.
5. Select Save.

The Nagios Web Console Address can also be set when initially adding a Nagios service to the Manage Services screen.

Search for a host

1. From the Nagios home screen, select Search for Host on the menu.
2. Enter the name of the host you are looking for in the Host field, then select Search.

The * wildcard is supported.

Change the Nagios credentials

From the Nagios home screen, select Change Credentials. Immediately upon selecting the Change Credentials option, previous credentials are removed from Mobile Admin.

Enter the desired Nagios Web Console credentials in the User name and Password fields, then select Save.

Set the date format preference

1. From the Nagios home screen, select the Preferences menu option.
2. Enter your desired date format, referring to the example provided on the Preferences screen.
3. Select Save.

View service details and service state information

From the Nagios home screen, select the Service Detail menu option.

To view service state information, select the service for which you want to view state information.

Manage the host machine

From any service state information screen, you can select Manage Host on the menu to immediately jump to that Host's Services screen.

View comments on a service

Follow the procedure to view service state information and select the service for which you would like to view comments.

Select Comments on the menu.

Add and remove a comment about a service

1. Follow the procedure to view comments on the service.
2. To add a new comment:
   1. Select Add New Service Comment on the menu.
   2. If you want this comment to persist through Nagios shutdowns, check the 'persistent' option. Otherwise, the comment will automatically be deleted the next time Nagios is restarted.
   3. Enter your comment in the Comment field.
   4. Select Commit.
3. To remove a comment, select the comment you would like to delete, and then select Delete Comment.

Set a scheduling service downtime

1. Follow the procedure to view service state information and select the service for which you want to set a scheduled service downtime.
2. Select Schedule Service Downtime on the menu.
3. Enter/select the relevant information in the text fields/drop-down menus
4. Select Commit.

Delete a scheduled service downtime occurrence

1. From the Nagios home screen, select Downtime on the menu.
2. Select Scheduled Service Downtime on the menu.
3. Select the scheduled service downtime occurrence you want to delete.
4. Select Delete on the menu.

Sort service details by status or service

From the Service Status details screen, you will have the following options for sorting:

To sort by status, select Sort By Status on the menu.

To soft by service, select Sort By Service on the menu.

View service problems and unhandled service problems

From the Nagios home screen, select Service Problems on the menu.

Select Unhandled Service Problems on the menu.

Acknowledge or remove acknowledgment for a service problem

Follow the procedure for viewing service problems and select the service problem that you want to acknowledge or remove acknowledgment for.

To acknowledge the service problem, select Acknowledge Problem on the menu.

To remove acknowledgment for the problem, select Remove Problem Acknowledgement on the menu.

View the host state information

1. From the Nagios home screen, select Host Detail on the menu.
2. Select the host for which you would like to view state information.

Manage the host machine

1. Follow the procedure to view host state information.
2. Select Manage Host on the menu.

View and add comments on the host machine

1. Follow the procedure to view host state information and select the host for which you want to view or add comments.
2. Select Comments on the menu. All comments for this host will be displayed.

To view details of an existing comment, select that comment from the list.

To add a comment:

1. select Add New Host Comment on the menu.
2. Edit the text field as desired, and select Commit.

Schedule host downtime

1. Follow the procedure to view host state information and select the host for which you want to schedule downtime.
2. Select Schedule Service Downtime on the menu.
3. Enter the relevant information in the text/drop-down fields.
4. Select Commit.

Sort host details by status

1. The Host Status Details list allows the following option for sorting:
2. To sort by status, select Sort By Status on the menu.

View host problems and unhandled host problems

From the Nagios home screen, select Host Problems on the menu.

To view unhandled host problems, select Unhandled Host Problems on the menu.

Acknowledge or remove acknowledgment for a host problem

1. From a view of host problems, select the host problem that you want to acknowledge or remove acknowledgment for.
2. To acknowledge the host problem, select Acknowledge Problem on the menu.
3. To remove acknowledgment for the host problem, select Remove Problem Acknowledgement on the menu.

View service detail information

1. From the Nagios home screen, select Host Details on the menu.
2. Select the host for which you wish to view service detail information.
3. Select Show Service Detail on the menu.

Notifications

Nagios can be set up to send you notifications of a variety of changes in your host and service states (E.g. if a problem occurs, a recovery takes place, or of changes in scheduled downtimes).

The notifications you receive from Nagios concerning your hosts and services are independent of notifications you receive from Mobile Admin. Subscribing to the Nagios feed will allow you to receive and review any Nagios notifications conveniently on your Mobile Admin Dashboard, where all the other Mobile Admin notifications are listed. When Mobile Admin receives a notification from the Nagios feed, your mobile device will be sent a push-notification and details of the notification will be automatically available to you on your Mobile Admin Dashboard.

If you do not subscribe to the Nagios feed you will continue to receive Nagios notifications, but they will appear separate from your other Mobile Admin notifications and will not be posted on your Mobile Admin Dashboard.

View notifications

1. From the Nagios home screen, select Notifications on the menu.
2. Select the level for which you want to view notifications.

If available, select Earlier Archives on the menu to view additional notifications.

Subscribe to a Nagios feed with Mobile Admin

Subscribing to the Nagios feed will make receiving and reviewing any notifications from Nagios more convenient and will aid with the overall organization of your received notifications and subscribed feed information.

To subscribe to a Nagios feed:

1. From the Nagios home screen, select Notifications from the menu.
2. Select the type of Nagios notification that you would like Mobile Admin to track. If you want Mobile Admin to organize all Nagios notifications, select All Notifications.
3. Select Subscribe to this feed.
4. Enter a name for the feed and a contact phone number and url if desired.
5. Click Subscribe on the menu or on the Subscribe to a new feed screen.