"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "monit.1" between
monit-5.27.2.tar.gz and monit-5.28.0.tar.gz

About: Monit is a utility for managing and monitoring processes, files, directories and filesystems (with automatic error recovery).

monit.1  (monit-5.27.2):monit.1  (monit-5.28.0)
skipping to change at line 148 skipping to change at line 148
Once you have Monit running as a daemon process, you can call Monit with one of the following arguments. Once you have Monit running as a daemon process, you can call Monit with one of the following arguments.
Monit will then connect to the Monit daemon (on TCP port 127.0.0.1:2812 b y default) and ask the Monit Monit will then connect to the Monit daemon (on TCP port 127.0.0.1:2812 b y default) and ask the Monit
daemon to perform the requested action. In other words; calling monit wit hout arguments starts the Monit daemon to perform the requested action. In other words; calling monit wit hout arguments starts the Monit
daemon, and calling monit with arguments enables you to communicate with the Monit daemon process. daemon, and calling monit with arguments enables you to communicate with the Monit daemon process.
start all start all
Start all services listed in the control file and enable monitoring f or them. If the group option is Start all services listed in the control file and enable monitoring f or them. If the group option is
set (-g), only start and enable monitoring of services in the named g roup ("all" is not required in set (-g), only start and enable monitoring of services in the named g roup ("all" is not required in
this case). this case).
start <name> start <name|pattern>
Start the named service and enable monitoring for it. The name is a s ervice entry name from the Start the named service and enable monitoring for it. The name is a s ervice entry name from the
monitrc file. monitrc file.
stop all stop all
Stop all services listed in the control file and disable their monito ring. If the group option is set, Stop all services listed in the control file and disable their monito ring. If the group option is set,
only stop and disable monitoring of the services in the named group ( "all" is not required in this only stop and disable monitoring of the services in the named group ( "all" is not required in this
case). case).
stop <name> stop <name|pattern>
Stop the named service and disable its monitoring. The name is a serv ice entry name from the monitrc Stop the named service and disable its monitoring. The name is a serv ice entry name from the monitrc
file. file.
restart all restart all
Stop and start all services. If the group option is set, only restart the services in the named group Stop and start all services. If the group option is set, only restart the services in the named group
("all" is not required in this case). ("all" is not required in this case).
restart <name> restart <name|pattern>
Restart the named service. The name is a service entry name from the monitrc file. Restart the named service. The name is a service entry name from the monitrc file.
monitor all monitor all
Enable monitoring of all services listed in the control file. If the group option is set, only start Enable monitoring of all services listed in the control file. If the group option is set, only start
monitoring of services in the named group ("all" is not required in t his case). monitoring of services in the named group ("all" is not required in t his case).
monitor <name> monitor <name|pattern>
Enable monitoring of the named service. The name is a service entry n ame from the monitrc file. Monit Enable monitoring of the named service. The name is a service entry n ame from the monitrc file. Monit
will also enable monitoring of all services this service depends on. will also enable monitoring of all services this service depends on.
unmonitor all unmonitor all
Disable monitoring of all services listed in the control file. If the group option is set, only Disable monitoring of all services listed in the control file. If the group option is set, only
disable monitoring of services in the named group ("all" is not requi red in this case). disable monitoring of services in the named group ("all" is not requi red in this case).
unmonitor <name> unmonitor <name|pattern>
Disable monitoring of the named service. The name is a service entry name from the monitrc file. Monit Disable monitoring of the named service. The name is a service entry name from the monitrc file. Monit
will also disable monitoring of all services that depends on this ser vice. will also disable monitoring of all services that depends on this ser vice.
status [name] status [name|pattern]
Print service status information. Print service status information.
summary [name] summary [name|pattern]
Print a short status summary. Print a short status summary.
report [up | down | initialising | unmonitored | total] report [up | down | initialising | unmonitored | total]
Report services state. The output can easily be parsed by scripts. W ithout options, prints a short Report services state. The output can easily be parsed by scripts. W ithout options, prints a short
overview of the state of all services managed by Monit. The option, u p prints the number of all overview of the state of all services managed by Monit. The option, u p prints the number of all
services in this state, down likewise and so on. services in this state, down likewise and so on.
reload reload
Reinitialise a running Monit daemon, the daemon will reread its confi guration, close and reopen log Reinitialise a running Monit daemon, the daemon will reread its confi guration, close and reopen log
files. files.
skipping to change at line 855 skipping to change at line 855
o Timestamp test failed (e.g. file is older then expected) o Timestamp test failed (e.g. file is older then expected)
o Permission test failed (e.g. file mode doesn't match) o Permission test failed (e.g. file mode doesn't match)
o An UID test failed (e.g. file owned by different user) o An UID test failed (e.g. file owned by different user)
o A GID test failed (e.g. file owned by different group) o A GID test failed (e.g. file owned by different group)
o A process's PID changed out of Monit's control o A process's PID changed out of Monit's control
o A process's PPID changed out of Monit control o A process's PPID changed out of Monit control
o Too many service recovery attempts failed o Too many service recovery attempts failed
o A file content test found a match o A file content test found a match
o Filesystem flags changed o Filesystem flags changed
o A service action was performed by administrator o A service action was performed by administrator
o A network link failed o A network link down or up
o A network link capacity changed o A network link capacity changed
o A network link saturation failed o A network link saturation failed
o A network link upload/download rate failed o A network link upload/download rate failed
o Monit was started, stopped or reloaded o Monit was started, stopped or reloaded
To get an alert via e-mail, set the alert target using the global "set al ert" statement (for all services) To get an alert via e-mail, set the alert target using the global "set al ert" statement (for all services)
or the "alert" statement in the context of a service entry (for a single service). or the "alert" statement in the context of a service entry (for a single service).
Setting an alert recipient Setting an alert recipient
If an event occurs, Monit will send an alert. There are two kinds of aler t statement: global and local. If an event occurs, Monit will send an alert. There are two kinds of aler t statement: global and local.
skipping to change at line 1446 skipping to change at line 1446
| restartTimeout | timeout for service restart | 30 s | | restartTimeout | timeout for service restart | 30 s |
------------------------------------------------------------------------ ---------- ------------------------------------------------------------------------ ----------
GENERAL SYNTAX GENERAL SYNTAX
Monit offers several if-tests you can use in a 'check' statement to test various aspects of a service. Monit offers several if-tests you can use in a 'check' statement to test various aspects of a service.
You can test both for a predefined value or for a range and take actions if the value changes. You can test both for a predefined value or for a range and take actions if the value changes.
General syntax for testing a specific value or range: General syntax for testing a specific value or range:
IF <test> THEN <action> [ELSE IF SUCCEEDED THEN <action>] IF <test> THEN <action> [ELSE <action>]
The action is evaluated each time the <TEST> condition is true. Success a ction is optional and executed The action is evaluated each time the <TEST> condition is true. Success a ction is optional and executed
only when the state changes from failure to success. If success action is not set, Monit will send a only when the state changes from failure to success. If success action is not set, Monit will send a
recovery alert by default. recovery alert by default.
General syntax for a value change test: General syntax for a value change test:
IF CHANGED <test> THEN <action> IF CHANGED <test> THEN <action>
The action is executed each time the value changes. Monit will remember t he new value and will trigger The action is executed each time the value changes. Monit will remember t he new value and will trigger
skipping to change at line 2452 skipping to change at line 2452
Upload and download [bytes] Upload and download [bytes]
Upload and download [packets] Upload and download [packets]
Link status Link status
You can check the network link state. This test may only be used within a check network service entry in You can check the network link state. This test may only be used within a check network service entry in
the Monit control file. the Monit control file.
Syntax: Syntax:
IF FAILED LINK THEN action IF LINK <DOWN|UP> THEN action
action is a choice of "ALERT", "RESTART", "START", "STOP", "EXEC" or "UNM ONITOR". action is a choice of "ALERT", "RESTART", "START", "STOP", "EXEC" or "UNM ONITOR".
The test will fail if the link/interface is down or link errors were dete cted. The DOWN test will fail if the link/interface is down or link errors were detected.
Example: Mixing "link up" and "link down" in the same "check network" is not suppo
rted.
Examples:
check network eth0 with interface eth0 check network eth0 with interface eth0
if failed link then alert if link down then alert
check network eth5 with interface eth5
if link up then exec "/usr/bin/monit start backup"
In case a link failed you can add a start and stop program to automatical ly restart the interface which In case a link failed you can add a start and stop program to automatical ly restart the interface which
might help. (Substitute with the relevant network commands for your syste m) might help. (Substitute with the relevant network commands for your syste m)
check network eth0 with interface eth0 check network eth0 with interface eth0
start program = '/sbin/ipup eth0' start program = '/sbin/ipup eth0'
stop program = '/sbin/ipdown eth0' stop program = '/sbin/ipdown eth0'
if failed link then restart if link down then restart
Link capacity Link capacity
You can check the network link mode capacity for changes. This test may o nly be used within a check You can check the network link mode capacity for changes. This test may o nly be used within a check
network service entry in the Monit control file. network service entry in the Monit control file.
Syntax: Syntax:
IF CHANGED LINK [CAPACITY] THEN action IF CHANGED LINK [CAPACITY] THEN action
skipping to change at line 2600 skipping to change at line 2605
if total uploaded > 900000 packets in last hour then alert if total uploaded > 900000 packets in last hour then alert
NETWORK PING TEST NETWORK PING TEST
Monit can perform a network ping test by sending ICMP echo request datagr am packets to a host and wait for Monit can perform a network ping test by sending ICMP echo request datagr am packets to a host and wait for
the reply. This test can only be used within a check host statement. Moni t must also run as the root user the reply. This test can only be used within a check host statement. Moni t must also run as the root user
in order to be able to perform the ping test (because the ping test must use raw sockets which usually in order to be able to perform the ping test (because the ping test must use raw sockets which usually
only the super user is allowed to). only the super user is allowed to).
Syntax: Syntax:
IF FAILED PING[4|6] IF <FAILED|SUCCEEDED> PING[4|6]
[COUNT number] [COUNT number]
[SIZE number] [SIZE number]
[RESPONSETIME number <MILLISECONDS|SECONDS>]
[TIMEOUT number SECONDS] [TIMEOUT number SECONDS]
[ADDRESS string] [ADDRESS string]
THEN action THEN action
If a DNS host name was used in the check host statement and the host name resolve to several addresses If a DNS host name was used in the check host statement and the host name resolve to several addresses
(either IPv4 or IPv6), Monit will ping the first available address and co ntinue with the next address (either IPv4 or IPv6), Monit will ping the first available address and co ntinue with the next address
until one connection succeed or until there are no more addresses left to try. You can force Monit to only until one connection succeed or until there are no more addresses left to try. You can force Monit to only
ping IPv4 or IPv6 addresses by using the PING4 or the PING6 keyword inste ad of PING. ping IPv4 or IPv6 addresses by using the PING4 or the PING6 keyword inste ad of PING.
The COUNT parameter specifies how many consecutive ping requests will be sent to the host in one cycle at The COUNT parameter specifies how many consecutive ping requests will be sent to the host in one cycle at
maximum. The default value is 3. maximum. The default value is 3.
The SIZE parameter specifies the ping request payload size. Default is 64 bytes, minimum is 8 bytes, The SIZE parameter specifies the ping request payload size. Default is 64 bytes, minimum is 8 bytes,
maximum 1492 bytes. maximum 1492 bytes.
The RESPONSETIME parameter sets the response time limit.
If no reply arrive within TIMEOUT seconds, Monit reports an error. If at least one reply was received, If no reply arrive within TIMEOUT seconds, Monit reports an error. If at least one reply was received,
the ping test is considered a success. the ping test is considered a success.
The ADDRESS parameter specifies source IP address. The ADDRESS parameter specifies source IP address.
Monit will, by default, send up to three ping request packets in one cycl e to prevent false alarm (i.e. up Monit will, by default, send up to three ping request packets in one cycl e to prevent false alarm (i.e. up
to 66% packet loss is tolerated). You can set the COUNT option to a value between 1 and 20 to send more or to 66% packet loss is tolerated). You can set the COUNT option to a value between 1 and 20 to send more or
fewer packets. If you require 100% ping success, set the count to 1 (i.e. just one request will be sent, fewer packets. If you require 100% ping success, set the count to 1 (i.e. just one request will be sent,
and if the packet was lost an error will be reported). and if the packet was lost an error will be reported).
skipping to change at line 2653 skipping to change at line 2661
check host mmonit.com with address mmonit.com check host mmonit.com with address mmonit.com
if failed ping4 then alert # IPv4 only if failed ping4 then alert # IPv4 only
if failed ping6 then alert # IPv6 only if failed ping6 then alert # IPv6 only
or with all parameters; Send five 128 byte pings to mmonit.com and wait f or up to 10 seconds for a reply or with all parameters; Send five 128 byte pings to mmonit.com and wait f or up to 10 seconds for a reply
check host mmonit.com with address mmonit.com check host mmonit.com with address mmonit.com
if failed ping count 5 size 128 with timeout 10 seconds then aler t if failed ping count 5 size 128 with timeout 10 seconds then aler t
You can also watch host, that is supposed to be offline:
check host offlinehost with address 192.168.100.50
if succeeded ping then alert
CONNECTION TESTS CONNECTION TESTS
Monit can perform connection testing via network ports or via Unix socket s. A connection test may only be Monit can perform connection testing via network ports or via Unix socket s. A connection test may only be
used within a process or host service type context. used within a process or host service type context.
If a service listens on one or more sockets, Monit can connect to the por t (using TCP or UDP) and verify If a service listens on one or more sockets, Monit can connect to the por t (using TCP or UDP) and verify
that the service will accept a connection and that it is possible to writ e and read from the socket. If a that the service will accept a connection and that it is possible to writ e and read from the socket. If a
connection is not accepted or if there is a problem with socket I/O, Moni t will execute a specified connection is not accepted or if there is a problem with socket I/O, Moni t will execute a specified
action. action.
For TCP/UDP ports monit can alert on successful connection, e.g. when a s
ervice like mysql should not be
publicly available.
TCP/UDP port test syntax: TCP/UDP port test syntax:
IF FAILED IF <FAILED|SUCCEEDED>
[HOST string] [HOST string]
<PORT number> <PORT number>
[ADDRESS string] [ADDRESS string]
[IPV4 | IPV6] [IPV4 | IPV6]
[TYPE <TCP|UDP>] [TYPE <TCP|UDP>]
[<SSL|TLS> [with options {...}] [<SSL|TLS> [with options {...}]
[CERTIFICATE CHECKSUM [MD5|SHA1] string] [CERTIFICATE CHECKSUM [MD5|SHA1] string]
[CERTIFICATE VALID for number DAYS] [CERTIFICATE VALID for number DAYS]
[PROTOCOL protocol | <SEND|EXPECT> "string",...] [PROTOCOL protocol | <SEND|EXPECT> "string",...]
[RESPONSETIME number <MILLISECONDS|SECONDS>]
[TIMEOUT number SECONDS] [TIMEOUT number SECONDS]
[RETRY number] [RETRY number]
THEN action THEN action
Unix socket test syntax: Unix socket test syntax:
IF FAILED IF <FAILED|SUCCEEDED>
<UNIXSOCKET path> <UNIXSOCKET path>
[TYPE <TCP|UDP>] [TYPE <TCP|UDP>]
[PROTOCOL protocol | <SEND|EXPECT> "string",...] [PROTOCOL protocol | <SEND|EXPECT> "string",...]
[RESPONSETIME number <MILLISECONDS|SECONDS>]
[TIMEOUT number SECONDS] [TIMEOUT number SECONDS]
[RETRY number] [RETRY number]
THEN action THEN action
Examples: Examples:
if failed port 80 then alert if failed port 80 then alert
if failed port 53 type udp protocol dns then alert if failed port 53 type udp protocol dns then alert
if succeeded host example.org port 3306 type tcp protocol mysql then ale
rt
if failed unixsocket /var/run/sophie then alert if failed unixsocket /var/run/sophie then alert
Options: Options:
HOST hostname. Optionally specify the host to connect to. If the host is not given then localhost is HOST hostname. Optionally specify the host to connect to. If the host is not given then localhost is
assumed if this test is used inside a process entry. If this test is used inside a remote host entry then assumed if this test is used inside a process entry. If this test is used inside a remote host entry then
the entry's remote host is assumed. the entry's remote host is assumed.
PORT number. The port number to connect to PORT number. The port number to connect to
skipping to change at line 2790 skipping to change at line 2810
SMTP SMTP
SMTPS SMTPS
SPAMASSASSIN SPAMASSASSIN
SSH SSH
TNS TNS
WEBSOCKET WEBSOCKET
If the target server's protocol is not found in this list, simply do not specify the protocol and Monit If the target server's protocol is not found in this list, simply do not specify the protocol and Monit
will use a default connection test. will use a default connection test.
RESPONSETIME parameter sets the response time limit.
TIMEOUT number SECONDS. Optionally specifies the connect and read timeout for the connection. If Monit TIMEOUT number SECONDS. Optionally specifies the connect and read timeout for the connection. If Monit
cannot connect to the server within this time it will assume that the con nection failed and execute the cannot connect to the server within this time it will assume that the con nection failed and execute the
specified action. The default connect timeout is 5 seconds. specified action. The default connect timeout is 5 seconds.
RETRY number. Optionally specifies the number of consecutive retries with in the same testing cycle in the RETRY number. Optionally specifies the number of consecutive retries with in the same testing cycle in the
case that the connection failed. The default is fail on first error. case that the connection failed. The default is fail on first error.
action is a choice of "ALERT", "RESTART", "START", "STOP", "EXEC" or "UNM ONITOR". action is a choice of "ALERT", "RESTART", "START", "STOP", "EXEC" or "UNM ONITOR".
Specific protocol test options Specific protocol test options
skipping to change at line 3568 skipping to change at line 3590
NOTES NOTES
This is a very silent program. Use the -v switch if you want to see what Monit is doing, and tail -f the This is a very silent program. Use the -v switch if you want to see what Monit is doing, and tail -f the
log file. Optionally for testing purposes; you can start Monit with the - Iv switch. Monit will then print log file. Optionally for testing purposes; you can start Monit with the - Iv switch. Monit will then print
debug information to the console, to stop monit in this mode, simply pres s CTRL^C (i.e. SIGINT) in the debug information to the console, to stop monit in this mode, simply pres s CTRL^C (i.e. SIGINT) in the
same console. same console.
The syntax (and parser) of the control file was inspired by Eric S. Raymo nd et al.'s excellent fetchmail The syntax (and parser) of the control file was inspired by Eric S. Raymo nd et al.'s excellent fetchmail
program. Some portions of this man page also receive inspiration from the same authors. program. Some portions of this man page also receive inspiration from the same authors.
COPYRIGHT COPYRIGHT
Copyright (C) 2001-2020 by Tildeslash Ltd. All Rights Reserved. This pro duct is distributed in the hope Copyright (C) 2001-2021 by Tildeslash Ltd. All Rights Reserved. This pro duct is distributed in the hope
that it will be useful, but WITHOUT any warranty; without even the implie d warranty of MERCHANTABILITY or that it will be useful, but WITHOUT any warranty; without even the implie d warranty of MERCHANTABILITY or
FITNESS for a particular purpose. FITNESS for a particular purpose.
SEE ALSO SEE ALSO
GNU text utilities; md5sum(1); sha1sum(1); openssl(1); glob(7); regex(7); https://mmonit.com GNU text utilities; md5sum(1); sha1sum(1); openssl(1); glob(7); regex(7); https://mmonit.com
5.27.2 www.mmonit.com MONIT(1) 5.28.0 www.mmonit.com MONIT(1)
 End of changes. 27 change blocks. 
18 lines changed or deleted 43 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)