forked from rk-it-at/check_rhv
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
172 lines (135 loc) · 5.56 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
#*********************************************************#
# #
# README for check_rhv plugin for Icinga/Nagios #
# #
#*********************************************************#
What is check_rhv?
====================
This plugin for Icinga/Nagios is used to monitor a variety of
an RHEV or oVirt environement including datacenters, clusters, hosts,
vms, vm pools and storage domains.
Contributions / Help
====================
Send email to rkoch@rk-it.at if you have questions regarding use
of this software. Please include the following information in your email:
* OS type and version
* Perl version
To submit patches or suggest improvements, send email to rkoch@rk-it.at or create
a pull request on Github. Thanks.
Installation
============
The check_rhv installation can be used by following the standard autotools
installation process, documented in the INSTALL file. As a quick start you can do
$ ./configure
$ make all
# make install
This will install check_rhv to /usr/local/nagios/libexec and the PNP template
to /usr/local/pnp4nagios/share/templates.
To change these paths use the following options:
--prefix=<path_to_nagios_plugins>
--with-pnp-dir=<path_to_pnp_share_folder>
If you don't use PNP you can disable installing the PNP template with:
--disable-pnp-template
To change the user and group ownership of these files use:
--with-nagios-user=<user>
--with-nagios-group=<group>
The 'nagios-plugins-rhv.spec' file demonstrates how to distribute check_rhv
as an RPM package.
Also make sure that the following requirements are met:
Perl
Perl-Modules:
LWP::UserAgent
perl-Crypt-SSLeay
HTTP::Request
Getopt::Long
XML:Simple
For Fedora 19 (and newer) install the following packages:
# yum install perl-libwww-perl perl-LWP-Protocol-https perl-HTTP-Message \
perl-XML-Simple
For RHEL 6 install the following packages:
# yum install perl-Crypt-SSLeay perl-libwww-perl perl-XML-Simple
For Debian Squeeze install the following packages:
# apt-get install libwww-perl libcrypt-ssleay-perl libxml-simple-perl
Documentation
=============
Short documentation on how to use this plugin.
Detailed documentation can be found on the project website
https://github.com/rk-it-at/check_rhv.
The following checks can be performed by this plugin:
Datacenter
----------
check_rhv -H rhevm -a admin@internal:password -D default
check_rhv -H rhevm -a admin@internal:password -D default -l status
check_rhv -H rhevm -a admin@internal:password -D default -l version
check_rhv -H rhevm -a admin@internal:password -D default -l storage
check_rhv -H rhevm -a admin@internal:password -D default -l storage -s status
check_rhv -H rhevm -a admin@internal:password -D default -l storage -s usage
check_rhv -H rhevm -a admin@internal:password -D default -l storage -s overall-usage
Cluster
-------
check_rhv -H rhevm -a admin@internal:password -C default
check_rhv -H rhevm -a admin@internal:password -C default -l hosts
check_rhv -H rhevm -a admin@internal:password -C default -l vms
check_rhv -H rhevm -a admin@internal:password -C default -l networks
check_rhv -H rhevm -a admin@internal:password -C default -l glustervolumes
check_rhv -H rhevm -a admin@internal:password -C default -l glusterbricks
Hosts
-----
check_rhv -H rhevm -a admin@internal:password -R rhevh
check_rhv -H rhevm -a admin@internal:password -R rhevh -l status
check_rhv -H rhevm -a admin@internal:password -R rhevh -l load
check_rhv -H rhevm -a admin@internal:password -R rhevh -l cpu
check_rhv -H rhevm -a admin@internal:password -R rhevh -l cpu -s usage
check_rhv -H rhevm -a admin@internal:password -R rhevh -l ksm
check_rhv -H rhevm -a admin@internal:password -R rhevh -l memory
check_rhv -H rhevm -a admin@internal:password -R rhevh -l memory -s mem
check_rhv -H rhevm -a admin@internal:password -R rhevh -l memory -s swap
check_rhv -H rhevm -a admin@internal:password -R rhevh -l network
check_rhv -H rhevm -a admin@internal:password -R rhevh -l network -s status
check_rhv -H rhevm -a admin@internal:password -R rhevh -l network -s traffic
check_rhv -H rhevm -a admin@internal:password -R rhevh -l network -s errors
check_rhv -H rhevm -a admin@internal:password -R rhevh -l updates
Storage
-------
check_rhv -H rhevm -a admin@internal:password -S storage
check_rhv -H rhevm -a admin@internal:password -S storage -l usage
VMs
---
check_rhv -H rhevm -a admin@internal:password -M vm
check_rhv -H rhevm -a admin@internal:password -M vm -l status
check_rhv -H rhevm -a admin@internal:password -M vm -l cpu
check_rhv -H rhevm -a admin@internal:password -M vm -l memory
check_rhv -H rhevm -a admin@internal:password -M vm -l network
check_rhv -H rhevm -a admin@internal:password -M vm -l network -s traffic
check_rhv -H rhevm -a admin@internal:password -M vm -l network -s errors
VM Pools
--------
check_rhv -H rhevm -a admin@internal:password -P pool
check_rhv -H rhevm -a admin@internal:password -P pool -l usage
Sample Icinga/Nagios definitions
--------------------------------
Detailed information can be found on the project website
https://github.com/ovido/check_rhv
Command
-------
define command{
command_name check_rhv
command_line $USER1$/check_rhv -H $_RHEVM$ -a $ARG1$ $ARG2$
}
Host
----
define host{
use linux-server
host_name rhevh
alias RHEV Hypervisor
address 192.168.1.2
_rhevm 192.168.1.1
}
Service
-------
define service{
use generic-service
host_name rhevh
service_description RHEV CPU Check
check_command check_rhv!admin@internal:password!-R $HOSTNAME$ -l cpu
}