Hey! These docs are for version 6.4, which is no longer officially supported. Click here for the latest version, 6.7!

## Overview

We use Monit to monitor Opsview Monitor processes and give you the ability to start and stop them.

For more general information on Monit go to: https://mmonit.com/monit/

We refer to our integration of Monit as Opsview Watchdog. You may check the current version of Monit being used by using the -V option

## How to use Opsview Watchdog

Watchdog contains a daemon, called `opsview-monit`, which must be started as the root user. This should be started automatically by the system.

However, the opsview user can get details from the daemon using the following script:

This command supports three arguments with various actions. First you can view the summary of each service handled by the watchdog by running:

The script can start, stop and reload individual Opsview Monitor processes:

The script can also act on all Opsview Monitor processes:

## Advanced

If more debugging is required, you can query Watchdog as the root user. This script is located at `/opt/opsview/watchdog/bin/opsview-monit` and offers the same functionality as above, with additional options being available:

**Note:** `opsview-monit` cannot be run as by the opsview user - use `opsview_watchdog` instead.

You can see process that are running and information about them by using either of the following commands:

The "status" option will give you a full list of information about each process, and "summary" will only show the current status of each process, much like opsview_watchdog.

The opsview-monit commands will also take process names as arguments if you need to check a single process. For example,​ if you wanted to see the status of opsview-web you can run:

**Note:** The order of the options is swapped compared to using opsview-watchdog!

When using opsview-monit some of the more advanced options look like this:

To view more usages of opsview-monit you can view the help document by running:

## Web Interface

You can also view the status of processes in the Opsview Monitor web interface. By navigating to "CONFIGURATION > MY SYSTEM" you can see similar information to the opsview-monit status command under the System Overview tab.

This page will show you all the service names, the process names, which hosts they reside on, as well as their status. This page will also provide more information such as uptime, CPU usage, memory usage and more.

## Troubleshooting

As an example, let's say that we have navigated to the web interface, but we are getting a 503 error. By using opsview_watchdog we can see if there are any processes that aren't running by using this command:

**Note:** The above output has been shortened for clarity

Looking at the output we see that the opsview-web process isn't running. Let's start the processes using this command:

We can then see that the process is being _Initialized_ since the status will change to 'Not monitored - start pending'.

After a few seconds, we re-run opsview_watchdog summary and will see opsview-web is back to 'Monitored' and we can now access the web interface.

This process can be used to fix issues with the other processes on your system by using either the start or restart command. Keep in mind that all processes that you have licenses for should be marked as 'Running' or 'Accessible'.