Module: check_mk
Branch: master
Commit: ccde1fda1f93c8476f43cd36eed93f35388b5971
URL:
http://git.mathias-kettner.de/git/?p=check_mk.git;a=commit;h=ccde1fda1f93c8…
Author: Mathias Kettner <mk(a)mathias-kettner.de>
Date: Mon Jul 8 10:22:04 2013 +0200
Internal notes in manpage drafts
---
checkman/mysql.connections | 19 +++++++++--------
checkman/win_netstat | 49 ++++++++++++++++++++++++--------------------
2 files changed, 38 insertions(+), 30 deletions(-)
diff --git a/checkman/mysql.connections b/checkman/mysql.connections
index 34f87af..d17d78e 100644
--- a/checkman/mysql.connections
+++ b/checkman/mysql.connections
@@ -6,23 +6,26 @@ license: GPL
distribution: check_mk
description:
This check allows tracking of connection usage for a MySQL database.
- Therefor it queries
- the maximum number of connections that have been in use simultaneously since the server
started
- and
+ Therefore it queries the maximum number of connections that have been
+ in use simultaneously since the server started and
the maximum number of possible parallel connections.
From these both it calculates the
maximum usage level of these connections in percent
and matches the given warning and critical thresholds against it.
-inventory:
- The check generates one item for the connection usage.
+ This check needs the agent plugin {mk_mysql} to be installed.
+ Further details about this plugin and monitoring of MySQL can be
+ found in the Check_MK online documentation in the article
+ "Monitoring MySQL with Check_MK".
+
+inventory:
+ On each host where the agent plugin {mk_mysql} is being installed
+ and the MySQL daemon is running one service is being generated.
[parameters]
+dictionary..., wenn perc_used nicht enthalten, ist der Chec immer OK.
warning (float): The maximum connection usage (in percent) that triggers
a warning state.
critical (float): The maximum connection usage (in percent) that triggers
a critical state.
-[configuration]
-perc_used (float, float): The default levels for {warning} and {critical}
- preset to {(None, None)}
diff --git a/checkman/win_netstat b/checkman/win_netstat
index da772bd..5054aaf 100644
--- a/checkman/win_netstat
+++ b/checkman/win_netstat
@@ -9,35 +9,34 @@ description:
and checks if there are established connections or listeners
matching the given criteria.
- Returns {OK} state if there are some and {CRITICAL} if not
+ Returns {OK} state if the specified connection/listener is present,
+ and {CRIT} if not.
item:
- Give the parameters to match against connection or listeners.
- See {Examples} and {Parameters} for details.
+ A user defined identifier of the connection.
examples:
- If you want to make sure some machine on 192.168.0.1 has an established
- TCP connection to the monitored machine (192.168.0.2) on port 445 you
- would define:
+ # If you want to make sure some machine on 192.168.0.1 has an established
+ # TCP connection to the monitored machine (192.168.0.2) on port 445 you
+ # would define:
- static_checks['tcp_connections'] = [
- ( ('win_netstat', 'My Test Connection',
- {
- 'local_ip' : '192.168.0.2',
- 'local_port': 445,
- 'remote_ip' : '192.168.0.1',
- 'state' : 'ESTABLISHED',
- 'proto' : 'TCP'
- }),
- [], ['winsrv1'] ),
+ # Make sure that a ...
+ checks += [
+ ( 'winsrv1', 'win_netstat', 'My Test Connection',
+ {
+ 'local_ip' : '192.168.0.2',
+ 'local_port': 445,
+ 'remote_ip' : '192.168.0.1',
+ 'state' : 'ESTABLISHED',
+ 'proto' : 'TCP'
+ }
+ ),
]
- Or if you want to check if there is an HTTP listener available
-
- static_checks['tcp_connections'] = [
+ # Check if TCP port 80 is listening
+ checkstatic_checks['tcp_connections'] = [
( ('win_netstat', 'HTTP Listener',
{
- 'local_ip' : '192.168.0.2',
'local_port': 80,
'state' : 'LISTEN',
'proto' : 'TCP'
@@ -46,12 +45,18 @@ examples:
]
[parameters]
-local_ip(string): the local IP address
+parameters (dict): A dictionary with the following keys, all of which are
+ optional.
+
+ {"local_ip"} The local IP address of the connection. For listeners
+ this is the IP address the process listens on. Applications that
+ listen on all IP address use an asterisk {*} here. If you omit
+ this parameter then the local address is being ignored.
local_port(int): the local Port
remote_ip(string): the remote IP address
remote_port(int): the remote Port
proto(string): TCP or UDP are possible values:
The protocol used for the connection or the listener
-state(string): ESTABLISHED, LISTEN, TIME_WAIT, SYN_SENT, SYN_RECV,
+state(string): {ESTABLISHED}, LISTEN, TIME_WAIT, SYN_SENT, SYN_RECV,
LAST_ACK, CLOSE_WAIT, TIME_WAIT, CLOSED, CLOSING, FIN_WAIT1, FIN_WAIT2,
BOUND: The state of the connection or listener