Version 13 (modified by mickem, 4 years ago) (diff)

--

TracNav

CheckSystem.dll

A module to check various system related things. A list of the modules and there potential use is listed below here.

Command Line

To simplify debug and setup there is two commandline options that list and test all avalible PDH counters.

Configuration Sections

CheckSystem Section

This is a wrapper page the actual data is on the following page CheckSystem/config

TracNav

  1. Configuration for CheckSystem module
      1. Collection Strategy
      1. CACHE ALLOWED HOSTS
      2. SSL CERTIFICATE
      3. CERTIFICATE FORMAT
      4. DH KEY
      5. SSL CERTIFICATE
      6. VERIFY MODE
      7. CA
      8. BIND TO ADDRESS
      9. ALLOWED HOSTS
      10. THREAD POOL
      11. ALLOWED CIPHERS
      12. INBOX
      13. TIMEOUT
      14. LISTEN QUEUE
      15. PASSWORD
      16. ENABLE SSL ENCRYPTION
      17. Register modern aliases for built-in commands
    3. SERVICE MAPPING SECTION
      1. SERVICE_DELAYED
      2. SERVICE_DISABLED
      3. SERVICE_DEMAND_START
      4. SERVICE_AUTO_START
      5. SERVICE_SYSTEM_START
      6. SERVICE_BOOT_START
    4. PDH COUNTER INFORMATION
    5. WINDOWS CHECK SYSTEM
      1. DEFAULT LENGTH
      2. PDH SUBSYSTEM
      3. DEFAULT INTERVALL
      4. Register modern aliases for built-in commands
    6. PDH COUNTERS
      1. memory commit bytes
      2. memory commit limit
      3. cpu
      4. uptime

Configuration for CheckSystem module

Section with configuration keys for the CheckSystem module

Path / Section Key Default value Description
/settings/system/windows/pdh/counters/cpucollection strategy round robin Collection Strategy
/settings/defaultcache allowed hosts 1 CACHE ALLOWED HOSTS
/settings/defaultcertificate SSL CERTIFICATE
/settings/defaultverify mode none VERIFY MODE
/settings/defaultallowed hosts 127.0.0.1 ALLOWED HOSTS
/settings/defaultallowed ciphers ADH ALLOWED CIPHERS
/settings/defaultinbox inbox INBOX
/settings/defaulttimeout 30 TIMEOUT
/settings/defaultpassword PASSWORD
/settings/defaultuse ssl 1 ENABLE SSL ENCRYPTION
/settings/system/windows/pdh PDH COUNTER INFORMATION
/settings/system/windowsdefault buffer length 1h DEFAULT LENGTH
/settings/system/windows/pdh/countersmemory commit bytes \4\26 memory commit bytes
/settings/system/windows/pdh/countersmemory commit limit \4\30 memory commit limit
/settings/system/windows/pdh/counterscpu \238(_total)\6 cpu
/settings/system/windows/pdh/countersuptime \2\674 uptime
/settings/defaultcertificate key SSL CERTIFICATE
/settings/defaultcertificate format PEM CERTIFICATE FORMAT
/settings/defaultdh ${certificate-path}/nrpe_dh_512.pem DH KEY
/settings/defaultca ${certificate-path}/ca.pem CA
/settings/defaultbind to BIND TO ADDRESS
/settings/defaultthread pool 10 THREAD POOL
/settings/defaultsocket queue size 0 LISTEN QUEUE
/settings/defaultmodern commands 1 Register modern aliases for built-in commands
mapping /settings/system/windows/service mappingDELAYED ignored SERVICE_DELAYED
mapping /settings/system/windows/service mappingDISABLED stopped SERVICE_DISABLED
mapping /settings/system/windows/service mappingDEMAND_START ignored SERVICE_DEMAND_START
mapping /settings/system/windows/service mappingAUTO_START started SERVICE_AUTO_START
mapping /settings/system/windows/service mappingSYSTEM_START ignored SERVICE_SYSTEM_START
mapping /settings/system/windows/service mappingBOOT_START ignored SERVICE_BOOT_START
/settings/system/windowssubsystem default PDH SUBSYSTEM
/settings/system/windowsdefault intervall 1 DEFAULT INTERVALL
/settings/system/windowsmodern commands 1 Register modern aliases for built-in commands

Section: /settings/system/windows/pdh/counters/cpu

Keys:

Key Default Title Description
collection strategyround robin Collection Strategy Collection strategy for CPU is usually round robin, for others static.

Sample: 

# 
# 
[/settings/system/windows/pdh/counters/cpu]
# Collection Strategy
# Collection strategy for CPU is usually round robin, for others static.
collection strategy=round robin

Collection Strategy

Description: Collection strategy for CPU is usually round robin, for others static.

Key: collection strategy

Default value: round robin

Used by: CheckSystem

Sample: 

# Collection Strategy
# Collection strategy for CPU is usually round robin, for others static.
[/settings/system/windows/pdh/counters/cpu]
collection strategy=round robin

Section: /settings/default

Keys:

Key Default Title Description
cache allowed hosts1 CACHE ALLOWED HOSTS If hostnames should be cached, improves speed and security somewhat but wont allow you to have dynamic IPs for your nagios server.
certificate SSL CERTIFICATE TODO
verify modenone VERIFY MODE TODO
allowed hosts127.0.0.1 ALLOWED HOSTS A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges.
allowed ciphersADH ALLOWED CIPHERS A better value is: ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH
inboxinbox INBOX The default channel to post incoming messages on
timeout30 TIMEOUT Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out.
password PASSWORD Password used to authenticate againast server
use ssl1 ENABLE SSL ENCRYPTION This option controls if SSL should be enabled.

Advanced Keys:

Key Default Title Description
certificate key SSL CERTIFICATE TODO
certificate formatPEM CERTIFICATE FORMAT TODO
dh${certificate-path}/nrpe_dh_512.pem DH KEY TODO
ca${certificate-path}/ca.pem CA TODO
bind to BIND TO ADDRESS Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses.
thread pool10 THREAD POOL TODO
socket queue size0 LISTEN QUEUE Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts.
modern commands1 Register modern aliases for built-in commands Register moden alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++

Sample: 

# 
# 
[/settings/default]
# CACHE ALLOWED HOSTS
# If hostnames should be cached, improves speed and security somewhat but wont allow you to have dynamic IPs for your nagios server.
cache allowed hosts=1
# SSL CERTIFICATE
# 
certificate key=
# CERTIFICATE FORMAT
# 
certificate format=PEM
# DH KEY
# 
dh=${certificate-path}/nrpe_dh_512.pem
# SSL CERTIFICATE
# 
certificate=
# VERIFY MODE
# 
verify mode=none
# CA
# 
ca=${certificate-path}/ca.pem
# BIND TO ADDRESS
# Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses.
bind to=
# ALLOWED HOSTS
# A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges.
allowed hosts=127.0.0.1
# THREAD POOL
# 
thread pool=10
# ALLOWED CIPHERS
# A better value is: ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH
allowed ciphers=ADH
# INBOX
# The default channel to post incoming messages on
inbox=inbox
# TIMEOUT
# Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out.
timeout=30
# LISTEN QUEUE
# Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts.
socket queue size=0
# PASSWORD
# Password used to authenticate againast server
password=
# ENABLE SSL ENCRYPTION
# This option controls if SSL should be enabled.
use ssl=1
# Register modern aliases for built-in commands
# Register moden alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++
modern commands=1

CACHE ALLOWED HOSTS

Description: If hostnames should be cached, improves speed and security somewhat but wont allow you to have dynamic IPs for your nagios server.

Key: cache allowed hosts

Default value: 1

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# CACHE ALLOWED HOSTS
# If hostnames should be cached, improves speed and security somewhat but wont allow you to have dynamic IPs for your nagios server.
[/settings/default]
cache allowed hosts=1

SSL CERTIFICATE

Description:

Advanced: (means it is not commonly used)

Key: certificate key

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# SSL CERTIFICATE
# 
[/settings/default]
certificate key=

CERTIFICATE FORMAT

Description:

Advanced: (means it is not commonly used)

Key: certificate format

Default value: PEM

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# CERTIFICATE FORMAT
# 
[/settings/default]
certificate format=PEM

DH KEY

Description:

Advanced: (means it is not commonly used)

Key: dh

Default value: ${certificate-path}/nrpe_dh_512.pem

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# DH KEY
# 
[/settings/default]
dh=${certificate-path}/nrpe_dh_512.pem

SSL CERTIFICATE

Description:

Key: certificate

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# SSL CERTIFICATE
# 
[/settings/default]
certificate=

VERIFY MODE

Description:

Key: verify mode

Default value: none

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# VERIFY MODE
# 
[/settings/default]
verify mode=none

CA

Description:

Advanced: (means it is not commonly used)

Key: ca

Default value: ${certificate-path}/ca.pem

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# CA
# 
[/settings/default]
ca=${certificate-path}/ca.pem

BIND TO ADDRESS

Description: Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses.

Advanced: (means it is not commonly used)

Key: bind to

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# BIND TO ADDRESS
# Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses.
[/settings/default]
bind to=

ALLOWED HOSTS

Description: A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges.

Key: allowed hosts

Default value: 127.0.0.1

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# ALLOWED HOSTS
# A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges.
[/settings/default]
allowed hosts=127.0.0.1

THREAD POOL

Description:

Advanced: (means it is not commonly used)

Key: thread pool

Default value: 10

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# THREAD POOL
# 
[/settings/default]
thread pool=10

ALLOWED CIPHERS

Description: A better value is: ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH

Key: allowed ciphers

Default value: ADH

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# ALLOWED CIPHERS
# A better value is: ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH
[/settings/default]
allowed ciphers=ADH

INBOX

Description: The default channel to post incoming messages on

Key: inbox

Default value: inbox

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# INBOX
# The default channel to post incoming messages on
[/settings/default]
inbox=inbox

TIMEOUT

Description: Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out.

Key: timeout

Default value: 30

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# TIMEOUT
# Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out.
[/settings/default]
timeout=30

LISTEN QUEUE

Description: Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts.

Advanced: (means it is not commonly used)

Key: socket queue size

Default value: 0

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# LISTEN QUEUE
# Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts.
[/settings/default]
socket queue size=0

PASSWORD

Description: Password used to authenticate againast server

Key: password

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# PASSWORD
# Password used to authenticate againast server
[/settings/default]
password=

ENABLE SSL ENCRYPTION

Description: This option controls if SSL should be enabled.

Key: use ssl

Default value: 1

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# ENABLE SSL ENCRYPTION
# This option controls if SSL should be enabled.
[/settings/default]
use ssl=1

Register modern aliases for built-in commands

Description: Register moden alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++

Advanced: (means it is not commonly used)

Key: modern commands

Default value: 1

Used by: NRPEServer, CheckMKServer, CheckSystem, NSCAServer, NSClientServer, NSCPServer

Sample: 

# Register modern aliases for built-in commands
# Register moden alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++
[/settings/default]
modern commands=1

SERVICE MAPPING SECTION

Confiure which services has to be in which state

Section: /settings/system/windows/service mapping

Advanced Keys:

Key Default Title Description
DELAYEDignored SERVICE_DELAYED TODO
DISABLEDstopped SERVICE_DISABLED TODO
DEMAND_STARTignored SERVICE_DEMAND_START TODO
AUTO_STARTstarted SERVICE_AUTO_START TODO
SYSTEM_STARTignored SERVICE_SYSTEM_START TODO
BOOT_STARTignored SERVICE_BOOT_START TODO

Sample: 

# SERVICE MAPPING SECTION
# Confiure which services has to be in which state
[/settings/system/windows/service mapping]
# SERVICE_DELAYED
# TODO
DELAYED=ignored
# SERVICE_DISABLED
# TODO
DISABLED=stopped
# SERVICE_DEMAND_START
# TODO
DEMAND_START=ignored
# SERVICE_AUTO_START
# TODO
AUTO_START=started
# SERVICE_SYSTEM_START
# TODO
SYSTEM_START=ignored
# SERVICE_BOOT_START
# TODO
BOOT_START=ignored

SERVICE_DELAYED

Description: TODO

Advanced: (means it is not commonly used)

Key: DELAYED

Default value: ignored

Used by: CheckSystem

Sample: 

# SERVICE_DELAYED
# TODO
[/settings/system/windows/service mapping]
DELAYED=ignored

SERVICE_DISABLED

Description: TODO

Advanced: (means it is not commonly used)

Key: DISABLED

Default value: stopped

Used by: CheckSystem

Sample: 

# SERVICE_DISABLED
# TODO
[/settings/system/windows/service mapping]
DISABLED=stopped

SERVICE_DEMAND_START

Description: TODO

Advanced: (means it is not commonly used)

Key: DEMAND_START

Default value: ignored

Used by: CheckSystem

Sample: 

# SERVICE_DEMAND_START
# TODO
[/settings/system/windows/service mapping]
DEMAND_START=ignored

SERVICE_AUTO_START

Description: TODO

Advanced: (means it is not commonly used)

Key: AUTO_START

Default value: started

Used by: CheckSystem

Sample: 

# SERVICE_AUTO_START
# TODO
[/settings/system/windows/service mapping]
AUTO_START=started

SERVICE_SYSTEM_START

Description: TODO

Advanced: (means it is not commonly used)

Key: SYSTEM_START

Default value: ignored

Used by: CheckSystem

Sample: 

# SERVICE_SYSTEM_START
# TODO
[/settings/system/windows/service mapping]
SYSTEM_START=ignored

SERVICE_BOOT_START

Description: TODO

Advanced: (means it is not commonly used)

Key: BOOT_START

Default value: ignored

Used by: CheckSystem

Sample: 

# SERVICE_BOOT_START
# TODO
[/settings/system/windows/service mapping]
BOOT_START=ignored

PDH COUNTER INFORMATION

Section: /settings/system/windows/pdh

Sample: 

# PDH COUNTER INFORMATION
# 
[/settings/system/windows/pdh]

WINDOWS CHECK SYSTEM

Section for system checks and system settings

Section: /settings/system/windows

Keys:

Key Default Title Description
default buffer length1h DEFAULT LENGTH Used to define the default intervall for range buffer checks (ie. CPU).

Advanced Keys:

Key Default Title Description
subsystemdefault PDH SUBSYSTEM Set which pdh subsystem to use.
default intervall1 DEFAULT INTERVALL Used to define the default intervall for range buffer checks (ie. CPU).
modern commands1 Register modern aliases for built-in commands Register moden alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++ parent for this key is found under: /settings/default this is marked as advanced in favour of the parent.

Sample: 

# WINDOWS CHECK SYSTEM
# Section for system checks and system settings
[/settings/system/windows]
# DEFAULT LENGTH
# Used to define the default intervall for range buffer checks (ie. CPU).
default buffer length=1h
# PDH SUBSYSTEM
# Set which pdh subsystem to use.
subsystem=default
# DEFAULT INTERVALL
# Used to define the default intervall for range buffer checks (ie. CPU).
default intervall=1
# Register modern aliases for built-in commands
# Register moden alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++ parent for this key is found under: /settings/default this is marked as advanced in favour of the parent.
modern commands=1

DEFAULT LENGTH

Description: Used to define the default intervall for range buffer checks (ie. CPU).

Key: default buffer length

Default value: 1h

Used by: CheckSystem

Sample: 

# DEFAULT LENGTH
# Used to define the default intervall for range buffer checks (ie. CPU).
[/settings/system/windows]
default buffer length=1h

PDH SUBSYSTEM

Description: Set which pdh subsystem to use.

Advanced: (means it is not commonly used)

Key: subsystem

Default value: default

Used by: CheckSystem

Sample: 

# PDH SUBSYSTEM
# Set which pdh subsystem to use.
[/settings/system/windows]
subsystem=default

DEFAULT INTERVALL

Description: Used to define the default intervall for range buffer checks (ie. CPU).

Advanced: (means it is not commonly used)

Key: default intervall

Default value: 1

Used by: CheckSystem

Sample: 

# DEFAULT INTERVALL
# Used to define the default intervall for range buffer checks (ie. CPU).
[/settings/system/windows]
default intervall=1

Register modern aliases for built-in commands

Description: Register moden alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++ parent for this key is found under: /settings/default this is marked as advanced in favour of the parent.

Advanced: (means it is not commonly used)

Key: modern commands

Default value: 1

Used by: CheckSystem

Sample: 

# Register modern aliases for built-in commands
# Register moden alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++ parent for this key is found under: /settings/default this is marked as advanced in favour of the parent.
[/settings/system/windows]
modern commands=1

PDH COUNTERS

Define various PDH counters to check.

Section: /settings/system/windows/pdh/counters

Keys:

Key Default Title Description
memory commit bytes\4\26 memory commit bytes System counter for check_xx commands..
memory commit limit\4\30 memory commit limit System counter for check_xx commands..
cpu\238(_total)\6 cpu System counter for check_xx commands..
uptime\2\674 uptime System counter for check_xx commands..

Sample: 

# PDH COUNTERS
# Define various PDH counters to check.
[/settings/system/windows/pdh/counters]
# memory commit bytes
# System counter for check_xx commands..
memory commit bytes=\4\26
# memory commit limit
# System counter for check_xx commands..
memory commit limit=\4\30
# cpu
# System counter for check_xx commands..
cpu=\238(_total)\6
# uptime
# System counter for check_xx commands..
uptime=\2\674

memory commit bytes

Description: System counter for check_xx commands..

Key: memory commit bytes

Default value: \4\26

Used by: CheckSystem

Sample: 

# memory commit bytes
# System counter for check_xx commands..
[/settings/system/windows/pdh/counters]
memory commit bytes=\4\26

memory commit limit

Description: System counter for check_xx commands..

Key: memory commit limit

Default value: \4\30

Used by: CheckSystem

Sample: 

# memory commit limit
# System counter for check_xx commands..
[/settings/system/windows/pdh/counters]
memory commit limit=\4\30

cpu

Description: System counter for check_xx commands..

Key: cpu

Default value: \238(_total)\6

Used by: CheckSystem

Sample: 

# cpu
# System counter for check_xx commands..
[/settings/system/windows/pdh/counters]
cpu=\238(_total)\6

uptime

Description: System counter for check_xx commands..

Key: uptime

Default value: \2\674

Used by: CheckSystem

Sample: 

# uptime
# System counter for check_xx commands..
[/settings/system/windows/pdh/counters]
uptime=\2\674