Welcome to docs.opsview.com

Running Opsview Diagnostics

From Opsview 3.5 a script called opsview_diag has been included within the /usr/local/nagios/bin directory to gather system information to aid with troubleshooting.

The latest version is always available from the Opsview repository.

Although included with Opsview 3.5, the script should be runnable Opsview 2.14 and newer.

From Opsview 4.6.2 the Opsview Diagnostics can be run from the about page by clicking the Download Opsview Diagnostics button. This will run the opsview_diag all:3 -z -f /tmp/opsview-diag-{$times_stamped}.log command in the background and offer it to download once the file has been created. Users can download this file and view it on a system other than opsview.

NOTE: This tool is still very much “work in progress”

Gathering diagnostics

Data can be gathered by running the tool either as root (to ensure access to messages and syslog files) or as the nagios user:

opsview_diag [-e <email address>[,<email address>...] <category>:<level> [<category>:<level>] ...

Output is printed on screen by default, but can be emailed to the given addresses

Categories

The diagnostics script can gather information about various parts of the system.

system
opsview
odw
smsgateway
all

As this tool is in development with new categories being regularly added, a more up to date list can be obtained by running

opsview_diag -l

Levels

There are 3 levels of data gathering

1. Versions, revisions and statistics
2. Selected configuration, files and directory listings
3. More in depth data gathering, directory contents and log files

Example

opsview_diag -e support@opsview.com opsview:2 system:1 odw:1 
Navigation
Print/export
Toolbox