NRPE IMAP Profile
This profile monitors an IMAP Windows server using Nagios Remote Plugin Executor (NRPE). NRPE is used by the Nagios server to communicate with the Windows server.
Services Configuration
- Service - Definitions in Monarch are stored under this name.
- Command Line - Service command name with arguments to be passed to the plugin.
- Plugin Command Line - Plugin script called by Nagios for this Service.
- Extended Info - The Extended Service Info definition, typically used for generating graphs.
Command lines displayed below are intended to be single line commands. Service Command Line Plugin Command Line Extended Info IMAPS_Alive check_tcp_imaps $USER1$/check_tcp -H $HOSTADDRESS$ -p 993 number_graph IMAPS_Server check_imaps!4!6 $USER1$/check_imap -t 60 -H $HOSTADDRESS$ -w "$ARG1$" -c "$ARG2$" -p 993 -S number_graph IMAP_Alive check_tcp_imap $USER1$/check_tcp -H $HOSTADDRESS$ -p 143 number_graph IMAP_Server check_imap!3!4 $USER1$/check_imap -t 60 -H $HOSTADDRESS$ -w "$ARG1$" -c "$ARG2$" number_graph nrpe_cpu check_nrpe_cpu!80!90 $USER1$/check_nrpe -t 60 -H $HOSTADDRESS$ -c wmi_cpu -a "$HOSTADDRESS$" "$ARG1$" "$ARG2$"
nrpe_disk_C check_nrpe_disk!C:!80!90 $USER1$/check_nrpe -t 60 -H $HOSTADDRESS$ -c wmi_disk -a "$HOSTADDRESS$" "$ARG1$" "$ARG2$" "$ARG3$"
nrpe_mem check_nrpe_mem!80!90 $USER1$/check_nrpe -t 60 -H $HOSTADDRESS$ -c wmi_mem -a "$HOSTADDRESS$" "$ARG1$" "$ARG2$" percent_graph nrpe_process_Alerter check_nrpe_process_Alerter $USER1$/check_nrpe -H $HOSTADDRESS$ -t 60 -c "check_service2_vb" -a "$HOSTADDRESS$" "Alerter"
nrpe_process_Eventlog check_nrpe_process_Eventlog $USER1$/check_nrpe -H $HOSTADDRESS$ -t 60 -c "check_service2_vb" -a "$HOSTADDRESS$" "Eventlog"
nrpe_process_IMAP4Svc check_nrpe_process_IMAP4Svc $USER1$/check_nrpe -H $HOSTADDRESS$ -t 60 -c "check_service2_vb" -a "$HOSTADDRESS$" "IMAP4Svc"
nrpe_process_MSDTC check_nrpe_process_MSDTC $USER1$/check_nrpe -H $HOSTADDRESS$ -t 60 -c "check_service2_vb" -a "$HOSTADDRESS$" "MSDTC"
nrpe_process_TermService check_nrpe_process_TermService $USER1$/check_nrpe -H $HOSTADDRESS$ -t 60 -c "check_service2_vb" -a "$HOSTADDRESS$" "TermService"
Profile Package
This package includes the following files:
Profile Definitions
- service_profile_nrpe-imap.xml
- perfconfig_nrpe-imap.xml
Plugins Scripts
- check_nrpe
- check_tcp
- check_imap
NRPE Scripts (installed on the monitored Windows Server)
- nrpe_nt.zip
Performance Graphing Programs
- number_graph.cgi
- percent_graph.cgi
Installation
GroundWork Monitor includes many monitoring profiles for a variety of devices, systems and applications. Profiles already imported on a new GroundWork installation include Service Ping, SNMP Network, and SSH UNIX. The GroundWork Monitor Configuration tool is used to import updated Profiles and Profiles that require additional setup; the Profile XML file and its companion Performance Configuration definition file. Services can also be imported in addition to Service Profiles in the Profile Importer. The import process is documented under GROUNDWORK PROFILES > How to import profiles.
Implementation
Command Parameters
Command parameters are in the Configuration Services section with the following names and default values.
IMAPS_Alive
- Check for connect() TCP on port number 993 of $HOSTADDRESS$
IMAPS_Server
- Uses check_imap plugin with the --S (SSL) switch to connect to port 993 of $HOSTADDRESS$ and search for ‘[* OK]’ in the IMAP server output.
- Default warning threshold is a 4 second response time.
- $ARG1$ - Warning seconds
- Default critical threshold is a 6 second response time.
- $ARG2$ - Critical seconds
IMAP_Alive
- Check for connect() TCP on port number 143 of $HOSTADDRESS$
IMAP_Server
- Uses check_imap plugin to connect to port 143 of $HOSTADDRESS$ and search for ‘[* OK]’ in the IMAP server output.
- Default warning threshold is a 4 second response time.
- $ARG1$ - Warning seconds
- Default critical threshold is a 6 second response time.
- $ARG2$ - Critical seconds
nrpe_cpu
- Uses check_nrpe plugin to connect to NRPE on $HOSTADDRESS$ and execute the wmi_cpu command as defined in the nrpe.cfg.
- Default warning threshold is 80% CPU usage
- ARG1$ - Warning percentage
- Default critical threshold is 90% CPU usage
- $ARG2$ - Critical percentage
nrpe_disk_C
- Uses check_nrpe plugin to connect to NRPE on $HOSTADDRESS$ and execute the wmi_disk command as defined in the nrpe.cfg.
- Default drive is set for C: disk
- $ARG1$ - Drive letter
- Default warning threshold is 80% usage
- $ARG2$ - Warning percentage
- Default critical threshold is 90% usage
- $ARG3$ - Critical percentage
nrpe_mem
- Uses check_nrpe plugin to connect to NRPE on $HOSTADDRESS$ and execute the wmi_mem command as defined in the nrpe.cfg.
- Default warning threshold is greater than 80% of Memory usage
- $ARG1$ - Warning percentage
- Default critical threshold is greater than 90% of Memory usage
- $ARG2$ - Critical percentage
nrpe_process_<PROCESSNAME>
nrpe_process_Alerter
nrpe_process_Eventlog
nrpe_process_IMAP4Svc
nrpe_process_MSDTC
nrpe_process_TermService
- Where PROCESSNAME is equal to the name of a process which should be running on the NRPE host. Sometimes processes will have spaces in there names. In this case an underscore (_) is used in place of any spaces in the service name.
- Uses check_nrpe plugin to connect to NRPE on $HOSTADDRESS$ and execute the check_service2_vb command as defined in the nrpe.cfg.
- OK if service is running
- CRITICAL is service is stopped or not installed.
Performance Graphing Parameters
The following parameters are used to generate performance charts. These parameters are set using the Configuration>Performance tool in GroundWork Monitor.
IMAP_Alive
- Nagios service description must contain the string IMAP_Alive.
- The plugin must produce performance data: (Response time in seconds)
IMAP_Server
- Nagios service description must contain the string IMAP_Server.
- The plugin must produce performance data: (Response time in seconds)
IMAPS_Alive
- Nagios service description must contain the string IMAPS_Alive.
- The plugin must produce performance data: Response time in seconds
IMAPS_Server
- Nagios service description must contain the string IMAPS_Server.
- The plugin must produce performance data: Response time in seconds
Host_Alive
- Nagios service description must contain the string Host_Alive.
- The plugin must produce performance data: Response time in seconds
nrpe_cpu
- Nagios service description must contain the string “nrpe_cpu”
- The plugin must produce performance data: CPU utilization percentage
nrpe_disk_c
- Nagios service description must contain the string “nrpe_disk”
- The plugin must produce performance data: Disk utilization percentage
nrpe_mem
- Nagios service description must contain the string “nrpe_cpu”
- The plugin must produce performance data: Memory utilization percentage
Implementation Notes
The nrpe.cfg file on the Windows server maps commands issued by the GroundWork server to scripts in the c:\nrpe_nt directory. Commands issued by this profile are installed with this package. If new NRPE commands are added, this file must be modified. Go to the GroundWork Support Portal - GroundWork Connect at http://www.groundworkconnect.com and search for Installing GroundWork WMI NRPE.