Monitoring - Revision history

Ltalaschus at 10:52, 29 January 2018

2018-01-29T10:52:55Z

Ltalaschus at 15:51, 24 January 2018

2018-01-24T15:51:18Z

Ltalaschus at 15:42, 24 January 2018

2018-01-24T15:42:18Z

Ltalaschus at 10:05, 22 January 2018

2018-01-22T10:05:05Z

Ltalaschus at 09:53, 22 January 2018

2018-01-22T09:53:06Z

Ltalaschus at 07:17, 20 April 2017

2017-04-20T07:17:49Z

Ltalaschus at 07:15, 20 April 2017

2017-04-20T07:15:22Z

Ltalaschus at 07:10, 19 April 2017

2017-04-19T07:10:56Z

Ltalaschus at 07:07, 19 April 2017

2017-04-19T07:07:40Z

Ltalaschus at 13:34, 10 May 2016

2016-05-10T13:34:27Z

@@ Line 79: / Line 79: @@
   --profile PROFILE
-Filters the results by archiving profile. The ID or the name of an archiving profile can be given.
+Filters the results by archiving profile. The ID of an archiving profile must be given. The ID of a profile can be retrieved with the API method [[Administration API - Function Reference#GetProfiles|GetProfiles]]. Alternatively you can select the profile in MailStore Client and press Ctrl+Shift+P to get the raw profile details.
   --status STATUS
@@ Line 114: / Line 114: @@
 Status is critical if more (--compare gt) than 5 (-c 5) profiles (--search profiles) have NOT ended successfully (--status "#succeeded") within the last day (-s "since:1d"). A warning is issued when more than 2 unsuccessful profiles have been found.
-  check_mailstore.py --host 192.168.0.1 --username admin --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 20 --search emails --profile "MailStore Proxy"
+  check_mailstore.py --host 192.168.0.1 --username admin --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 20 --search emails --profile 7
-Status is critical if less than 5 (-c 5) emails (--search emails) were archived within a day by the the profile "MailStore proxy" (--profile "MailStore proxy"). A warning is issued when less than 20 emails were archived.
+Status is critical if less than 5 (-c 5) emails (--search emails) were archived within a day by the the profile with the ID 7" (--profile 7). A warning is issued when less than 20 emails were archived.
 === Monitoring of licenced users ===

@@ Line 83: / Line 83: @@
   --status STATUS
-Filters the results by STATUS. Possible values are ''succeeded'', ''failed'', ''cancelled'', ''disconnected'', ''threadAbort'' and ''completedWithErrors''. The status can be negated by prepending a ''#''. Default is ''succeeded''. Use ''#all'', if you want the results of all profiles, regardless of the status.
+Filters the results by STATUS. Possible values are ''succeeded'', ''failed'', ''cancelled'', ''disconnected'', ''threadAbort'', ''completedWithWarnings'' and ''completedWithErrors''. The status can be negated by prepending a ''#''. Default is ''succeeded''. Use ''#all'', if you want the results of all profiles, regardless of the status.
   --search [profiles<nowiki>|</nowiki>emails]

@@ Line 42: / Line 42: @@
   --host HOST
-Hostname or IP address of the MailStore Server. The default is ''localhost''.
+Hostname or IP address of the MailStore Server.
   --port PORT
@@ Line 48: / Line 48: @@
 TCP port on which the MailStore Administration API accepts connections. Default is ''8463''.
-  --username USERNAME
+  --username USERNAME<nowiki>|</nowiki>--user USERNAME
-Username to log on to MailStore Server. This must be a MailStore administrator. By default, ''admin'' is used.
+Username to log on to MailStore Server. This must be a MailStore administrator.
-  --password PASSWORD
+  --password PASSWORD<nowiki>|</nowiki>--pass PASSWORD
 The user's password.
@@ Line 69: / Line 69: @@
 MailStore Server stores dates in UTC time. The output of the plugin can be adjusted with this parameter. By default, ''$local'' is used. This corresponds to the time zone setting of the operating system of MailStore Server. Using the API command [[Administration API - Function Reference#GetTimeZones|GetTimeZones]] the possible values can be shown. In most cases, this parameter is not required.
-  --machinename MACHINENAME<nowiki>|</nowiki>-m MACHINENAME
+  --machinename MACHINENAME
 Filters the results by ''MACHINENAME''. This is useful when the results of local profiles of different computers are monitored.
-  --user USERNAME
+  --filteruser USERNAME
 Filters the results by ''USERNAME''. This is useful when the results of profiles of different users are monitored.
-  --profile PROFILE<nowiki>|</nowiki>-p PROFILE
+  --profile PROFILE
 Filters the results by archiving profile. The ID or the name of an archiving profile can be given.
@@ Line 106: / Line 106: @@
 ==== Other examples ====
   check_mailstore.py --host 192.168.0.1 --username admin --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 2 --search profiles --status="#succeeded" --compare gt
-Status is critical if more than (--compare gt) 5 (-c 5) profiles (--search profiles) have NOT ended succesfully (--status "#succeeded") within the last day (-s "since:1d"). A warning is issued when more than 2 unsuccessful profiles have been found.
+Status is critical if more (--compare gt) than 5 (-c 5) profiles (--search profiles) have NOT ended successfully (--status "#succeeded") within the last day (-s "since:1d"). A warning is issued when more than 2 unsuccessful profiles have been found.
   check_mailstore.py --host 192.168.0.1 --username admin --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 20 --search emails --profile "MailStore Proxy"

@@ Line 17: / Line 17: @@
   define command {
          command_name check_mailstore
-         command_line /usr/local/lib/nagios/plugins/check_mailstore.py --host $ARG1$ --password $ARG2$ -s since:$ARG3$ --status $ARG4$ -c $ARG5$ -w $ARG6$ --search $ARG7$
+         command_line /usr/local/lib/nagios/plugins/check_mailstore.py --host $ARG1$ --username $ARG2$ --password $ARG3$ -s since:$ARG4$ --status $ARG5$ -c $ARG6$ -w $ARG7$ --search $ARG8$
+         }
@@ Line 25: / Line 25: @@
          host_name                       mailstoreserver
          service_description             MailStore Succeeded Profiles
-         check_command                   check_mailstore!mailstoreserver!sUp3rs3CcR6ET3!1H!succeeded!8!10!profiles
+         check_command                   check_mailstore!mailstoreserver!admin!sUp3rs3CcR6ET3!1H!succeeded!8!10!profiles
          use                             generic-service
+         }
 This test checks whether there were more then 10 tasks executed successfully (--status succeeded) during the last hour (-s since:1H).
 ==== Parameters ====
@@ Line 104: / Line 106: @@
 ==== Other examples ====
-  check_mailstore.py --host 192.168.0.1 --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 2 --search profiles --status="#succeeded" --compare gt
+  check_mailstore.py --host 192.168.0.1 --username admin --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 2 --search profiles --status="#succeeded" --compare gt
 Status is critical if more than (--compare gt) 5 (-c 5) profiles (--search profiles) have NOT ended succesfully (--status "#succeeded") within the last day (-s "since:1d"). A warning is issued when more than 2 unsuccessful profiles have been found.
-  check_mailstore.py --host 192.168.0.1 --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 20 --search emails --profile "MailStore Proxy"
+  check_mailstore.py --host 192.168.0.1 --username admin --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 20 --search emails --profile "MailStore Proxy"
 Status is critical if less than 5 (-c 5) emails (--search emails) were archived within a day by the the profile "MailStore proxy" (--profile "MailStore proxy"). A warning is issued when less than 20 emails were archived.

@@ Line 104: / Line 104: @@
 ==== Other examples ====
-  check_mailstore.py --host 192.168.0.1 --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 2 --search jobs --status="#succeeded" --compare gt
+  check_mailstore.py --host 192.168.0.1 --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 2 --search profiles --status="#succeeded" --compare gt
-Status is critical if more than (--compare gt) 5 (-c 5) jobs (--search jobs) have NOT ended succesfully (--status "#succeeded") within the last day (-s "since:1d"). A warning is issued when more than 2 unsuccessful jobs have been found.
+Status is critical if more than (--compare gt) 5 (-c 5) profiles (--search profiles) have NOT ended succesfully (--status "#succeeded") within the last day (-s "since:1d"). A warning is issued when more than 2 unsuccessful profiles have been found.
   check_mailstore.py --host 192.168.0.1 --password sUp3rs3CcR6ET3 -s "since:1d" -c 5 -w 20 --search emails --profile "MailStore Proxy"

← Older revision		Revision as of 07:17, 20 April 2017
Line 1:		Line 1:
		+	__NOTOC__
	MailStore only provides limited notification or monitoring features, but the status of the archiving processes can be monitored using external components.		MailStore only provides limited notification or monitoring features, but the status of the archiving processes can be monitored using external components.

@@ Line 138: / Line 138: @@
 The service check puts out a list of all scheduled tasks in the Windows task scheduler whose exit code is unequal to zero. If there is more than one event, the check status ''Critical'' is set. The return contains a list of all tasks with exit codes unequal to zero and their exit codes.
 [[de:Monitoring]]
 [[en:Monitoring]]

@@ Line 4: / Line 4: @@
 === MailStore Nagios/Icinga-Plugin ===
-The [[Media:Scripts.zip|Scripting-Package] includes the <tt>check_mailstore.py</tt> plugin. The plugin checks the number of profiles run or the number of archived emails in a given period of time. At least MailStore Server 8 is required. Unless stated otherwise, the scripts are released under the terms an conditions of the [[wikipedia:MIT_License|MIT License]].
+The [[Media:Scripts.zip|Scripting-Package]] includes the <tt>check_mailstore.py</tt> plugin. The plugin checks the number of profiles run or the number of archived emails in a given period of time. At least MailStore Server 8 is required. Unless stated otherwise, the scripts are released under the terms an conditions of the [[wikipedia:MIT_License|MIT License]].
 ==== Installation ====
@@ Line 112: / Line 112: @@
 === Monitoring of licenced users ===
-The ''check_mailstorelicence''-script from the [ftp://ftp.mailstore.com/pub/Scripts/Python/v9/scripts.zip scripting-pakage], can be used to monitor the existing users in MailStore with Nagios/Icinga. No external arguments can be used, all configuration has to be done inside the file. If you synchronize your users from an external source, and more users than free licences should be created in one step, this monitoring will not holler, because it checks the existing users only and not the users that shall be created.
+The ''check_mailstorelicence''-script from the [[Media:Scripts.zip|scripting-pakage]], can be used to monitor the existing users in MailStore with Nagios/Icinga. No external arguments can be used, all configuration has to be done inside the file. If you synchronize your users from an external source, and more users than free licences should be created in one step, this monitoring will not holler, because it checks the existing users only and not the users that shall be created.
 Command-Definition: