Configuration for the NSCAAgent

This page describes the configuration options for the NSCA module.

NSCA Agent Section

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

Ovreview

Options to configure the NSCA module.

Option	Default value	Description
interval	60	Time in seconds between each report back to the server (cant as of yet be set individually so this is for all "checks")
nsca_host	...	The NSCA/Nagios(?) server to report results to.
nsca_port	5667	The NSCA server port
encryption_method	1	Number corresponding to the various encryption algorithms (see below). Has to be the same as the server or it wont work at all.
password		The password to use. Again has to be the same as the server or it won't work at all.

Advanced options:

Option	Default value	Description
hostname		The host name of this host if set to blank (default) the windows name of the computer will be used.
debug_threads	1	DEBUGNumber of threads to run, no reason to change this really (unless you want to stress test something)

interval

Time in seconds between each report back to the server (cant as of yet be set individually so this is for all "checks")

Value

Any positive integer (time in seconds)

Default

60 (seconds)

nsca_host

The NSCA/Nagios(?) server to report results to.

Values

Hostname or IP address to submit back results to.

Default

Empty string (will in 3.7 and above mean don't submit results)

nsca_port

The NSCA server port

Values

Any positive integer (port number ought to be less then 65534)

Default

5667

encryption_method

Number corresponding to the various encryption algorithms (see below). Has to be the same as the server or it wont work at all.

Values

Supported encryption methods:

#	Algorithm
0	None (Do NOT use this option)
1	Simple XOR (No security, just obfuscation, but very fast)
2	DES
3	3DES (Triple DES)
4	CAST-128
6	xTEA
8	BLOWFISH
9	TWOFISH
11	RC2
14	RIJNDAEL-128 (AES)
20	SERPENT

Default

1 (I am note sure I thought default was 14?)

password

The password to use. Again has to be the same as the server or it won't work at all.

Values

Any string (should be the same as the one configured in nsca.conf

hostname

The host name of this host if set to blank (default) the windows name of the computer will be used.

Values

Any string (or auto)

Default

auto (means windows hostname will be used)

debug_threads

DEBUGNumber of threads to run, no reason to change this really (unless you want to stress test something)

Values

Any positive integer larger then or equal to 1

Default

1

NSCA Commands Section

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

Overview

A list of commands to run and submit each time we report back to the NSCA server. A command starting with host_ will be submitted as a host command. For an example see below: This will report back one service check (called my_cpu_check) and one host check (host checks have no service name).

[NSCA Commands]
my_cpu_check=checkCPU warn=80 crit=90 time=20m time=10s time=4
host_check=check_ok