build/etc/system.conf

# This is the default system configuration file
# used by all components of the i-scream system
#
# ALL configuration that uses the centralised
# configuration system has this file as its 
# root of configuration
#
# This is a working sample configuration, which
# aims to provide a working "out of the box"
# setup, aswell as a some example configuration.
#
# $Author: tdb $
# $Id: system.conf,v 1.71 2003/02/24 20:18:45 tdb Exp $
#
# http://www.i-scream.org.uk/
#

############################################################
#### Configuration Files & Groups
############################################################

# All components, such as hosts, will take their configuration
# as given in this file. Unless, that is, they have an extra
# configuration file specified here, or they're in a group
# that has a configuration file. If this is the case the extra
# configuration will override what is given in this file.

# We can define an extra configuration file for any component
# of the system. This is done by specifying the following:
#
# config.component=someconfigfile.conf
#
# Component names will be defined in the documentation for
# the component. An example is that a host component is
# known by the name "Host.hostname" or "Host.ip".
# It is also possible to use the wildcard "*" in a
# hostname or IP address.

# This defines that server.example.com has some extra
# configuration in the file 'server.conf'.
config.Host.server.example.com=exserver.conf

# All webservers are placed in a group named 'www'.
group.www=Host.www1.example.com;Host.www2.example.com
# Then we define some extra config for them.
config.www=webservers.conf

# Our workstations are in their own subnet.
group.workstations=Host.192.168.10.*;
# They can have their own config too.
config.workstations=workstations.conf

# Any hosts not specified by now have the default
# config as given in this file.

# Another component of the system is the mySQL
# database part of the server call the DBInterface.
# This has it's own config so the passwords for the
# mySQL database can be kept seperate.
#config.mySQL=mySQL.conf


############################################################
#### Misc system-wide configuration
############################################################

# The ConfigurationProxy caches configuration for various
# parts of the server. This setting defines how often, in
# seconds, the proxy will check if the data it contains
# is still valid.
ConfigurationProxy.updateTime=60

# The internal Queue's can be monitored. This specifies
# the interval, in seconds, at which their state should
# be monitored.
Queue.MonitorInterval=15
# The maximum size a Queue can be before items are
# dropped when new ones arrive.
Queue.SizeLimit=1000
# And which items we should drop when the queue is full
# and new items arrive. Choices are:
# RANDOM - drop a random item from the queue
# FIRST  - drop the first item from the queue
# LAST   - drop the last item from the queue
# DROP   - drop the new item from the queue
Queue.RemoveAlgorithm=FIRST

# The XMLCache caches data passing through the system.
# This setting specifies the time, in seconds, at which
# the caches contents will be rotated. In real terms
# this means the minimum age at which an XMLPacket can
# be before it is up for deletion from the cache.
XMLCache.cleanupPeriod=30


############################################################
#### FilterManager configuration
############################################################

# The FilterManager accepts connections from hosts
# upon startup. It provides them with configuration
# and details of which filter to talk to. This setting
# specifies which port (TCP) it listens on.
FilterManager.listenPort=4567

# An Access Control List for the FilterManager. One
# might consider something like this:
#
# FilterManager.ACL=DEFAULT:DENY;*.example.com:ALLOW
FilterManager.ACL=DEFAULT:ALLOW


############################################################
#### Filter configuration
############################################################

# A Filter accepts data from hosts on a UDP port. It is
# specified here.
Filter.UDPListenPort=4589

# Filters contain plugins for checking the data passing
# through them. This plugins do the job of "filtering".
# This setting specifies the java package they're
# contained in.
Filter.PluginsPackage=uk.org.iscream.cms.server.filter.plugins
# And the names of the plugins to be loaded.
Filter.Plugins=TypeChecker;EnforceEssentialData;SourceChecker

# The special filter known as the "Root Filter" needs
# a name within the system.
RootFilter.name=root

# Every Filter, except the root, needs a parent to
# send their data to. This is usually the root filter,
# although in more complex setups it might be another
# filter - giving a tree structure.
Filter.parentFilter=root

# A Filter can accept data through UDP, or from
# an upstream Filter (CORBA). These methods can be
# individually turned of on a filter. The default
# is to have them all on.
# (comment or set to 0 to disable)
Filter.ActivateUDPReader=1
Filter.ActivateCORBAReader=1

# We can also specify Access Control Lists for the
# UDP input of the Filters. One might want something
# restrictive like this:
#
# Filter.UDPACL=DEFAULT:DENY;*.example.com:ALLOW
Filter.UDPACL=DEFAULT:ALLOW

# A Filter plugin called the SourceChecker verifies
# that packets come from permitted hosts. It is
# given an ACL to check the hosts against. A possible
# ACL might be:
#
# Filter.SourceCheckerPluginACL=DEFAULT:DENY;*.example.com:ALLOW
Filter.SourceCheckerPluginACL=DEFAULT:ALLOW


############################################################
#### Root filter interfaces configuration
############################################################

# The Root FIlter can send data to various upstream
# data processors. There are two of these at present
# in the server - the DBInterface and the ClientInterface.
# Their component names are given here as defined below.
# (the DBInterface is switched off - commented - by default)
#RootFilter.dbInterfaceName=database
RootFilter.realtimeInterfaceName=realtimeclients


############################################################
#### Client interface configuration
############################################################

# The client interface listens for connections from clients
# on a TCP port. It is specified here.
ClientInterface.listenPort=4510
# The component name for the Client Interface. This should
# match the name specified to the Root Filter above.
ClientInterface.name=realtimeclients

# The Client Interface has two channels, control and data.
# Each of these can have an ACL for allowing connections.
# As per previous examples in this configuration file they
# could be set restrictively, but we'll leave them open
# by default
ClientInterface.TCPControlChannelACL=DEFAULT:ALLOW
ClientInterface.TCPDataChannelACL=DEFAULT:ALLOW


############################################################
#### Database interface configuration
############################################################

# The name for the Database Interface. This should match
# the name given to the Root Filter.
DBInterface.name=database


############################################################
#### Host Configuration
############################################################

# A host can use any filter. We'll set the default filter
# for all hosts to be 'filter1'. This can be a list.
Host.filter=filter1;

# Hosts send data every UDPUpdateTime, in seconds.
Host.UDPUpdateTime=60

# How long a hosts config is valid for (a TTL effectively)
# after this time, in seconds, has passed a host should
# consider it's configuration invalid and check for a new
# configuration as soon as it can.
Host.ConfigTTL=3600

# We can run service checks on a host. The java package
# which contains them is specified here.
Host.serviceChecksPackage=uk.org.iscream.cms.server.filter.plugins


############################################################
#### Monitor Configuration
############################################################

# Monitors allow data to be watched for possible problems.
# This setting specifies which java package they're in.
Monitor.PluginsPackage=uk.org.iscream.cms.server.client.monitors
# And which ones should be loaded.
Monitor.Plugins=CPU;Load;Process;Disk;Memory;Swap;Services;\
                Heartbeat;Queue;UserCount;WebFeeder;

# Alerts timeout after a given time in seconds and go up
# to the next level. These can be overridden for monitors
# on an individual basis.
Monitor.alertTimeout.NOTICE=60
Monitor.alertTimeout.WARNING=900
Monitor.alertTimeout.CAUTION=1800
Monitor.alertTimeout.CRITICAL=3600

## Threshold values
#
# Here we specify the threshold for each monitor. When
# a threshold is broken an alert is raised. If the
# UPPER threshold is broken the alertTimeout values
# given above are halved to make the alert escalate
# quicker.

# CPU monitor threshold values
Monitor.CPU.threshold.LOWER=90
Monitor.CPU.threshold.UPPER=95

# Load monitor threshold values
Monitor.Load.threshold.LOWER=10.0
Monitor.Load.threshold.UPPER=20.0

# Process Count threshold values
Monitor.Process.threshold.LOWER=500
Monitor.Process.threshold.UPPER=1000

# Memory monitor threshold values
Monitor.Memory.threshold.LOWER=80
Monitor.Memory.threshold.UPPER=90
# Whether to include 'cache' in the 'free' value
# (1 is true, anything else is false)
Monitor.Memory.useCacheAsFree=1

# Swap monitor threshold values
Monitor.Swap.threshold.LOWER=80
Monitor.Swap.threshold.UPPER=90

# UserCount monitor threshold values
Monitor.UserCount.threshold.LOWER=100
Monitor.UserCount.threshold.UPPER=200

# Disk monitor threshold values
Monitor.Disk.threshold.LOWER=90
Monitor.Disk.threshold.UPPER=95
# Thresholds given are PERCENTAGE or VALUE
# where PERCENTAGE is a percentage of disk in use
# and VALUE is an absolute value of space free
Monitor.Disk.thresholdMeasure=PERCENTAGE

# Queue monitor threshold values
Monitor.Queue.threshold.LOWER=50
Monitor.Queue.threshold.UPPER=80
# Thresholds given are PERCENTAGE or VALUE
# where PERCENTAGE is a percentage of the queue in use
# and VALUE is an absolute value of free space
Monitor.Queue.thresholdMeasure=PERCENTAGE

# Services monitor threshold values
# 
# THE SERVICES MONITOR USES A HACK
# WHEREBY IT USES THE SERVICE STATUS
# AS THE THRESHOLD LEVEL. THIS SHOULD
# BE LOOKED AT!
#
# how many times we should be at the highest level before
# we go to a FINAL alert
Monitor.Services.reachFINALcount=5

# Heartbeat threshold values
# these are values in seconds from when the heartbeat
# was *expected* to arrive (ie. last + hearbeat period)
Monitor.Heartbeat.threshold.LOWER=180
Monitor.Heartbeat.threshold.UPPER=300
# this is how often we will run a "check" of heartbeats
Monitor.Heartbeat.checkPeriod=50
# how many times we should be at the highest level before
# we go to a FINAL alert
Monitor.Heartbeat.reachFINALcount=5
# list of hosts we expect to have at startup
# this ensures we notice hosts that aren't running, not
# just those that have gone down recently.
#Monitor.Heartbeat.initialHosts=importantserver.example.com;myserver.example.com


############################################################
#### Alerter Configuration
############################################################
# The following variables are understood by ALL alerters
# for messages. They will be substituted for their
# appropriate value.
#
# %level%               - the alert level (eg, WARNING)
# %threshold%           - the threshold broken (eg, LOWER)
# %source%              - the source of the alert (eg, raptor.ukc.ac.uk)
# %value%               - the value reached (eg, 95)
# %thresholdValue%      - the value of the threshold broken (eg, 90)
# %attributeName%       - the attribute that has caused the alert (eg, CPU User)
# %timeTillNextAlert%   - the time the next alert will be sent out
# %timeSinceFirstAlert% - the time elapsed since the first alert for this problem
# %timeOfFirstAlert%    - the time the first alert was sent
#

# The java package containing the alerters
Alerter.PluginsPackage=uk.org.iscream.cms.server.client.alerters
# And the names of the ones to activate
# You might want to turn them all on, but we only activate
# two basic ones by default.
# Alerter.Plugins=EMail;IRC;WebFeeder;Logging;
Alerter.Plugins=WebFeeder;Logging;

# Configuration for the EMail alerter
# The level alerts have to bypass to be e-mailed out
Alerter.EMail.level = WARNING
# A list of people to send alerts to
Alerter.EMail.destList = me@example.com
# The sender of the e-mail
Alerter.EMail.sender = me@example.com
# The SMTP server to send alerts to
Alerter.EMail.smtpServer = smtp.example.com
# The subject line of the e-mail
Alerter.EMail.subject = i-scream alert: %level% alert on %source% for %attributeName%
# The message in the e-mail
Alerter.EMail.message = The i-scream distributed central monitoring system has\nraised a %level% alert for the host %source%.\n\nThe value for %attributeName% of %value% has exceeded the\n%threshold% threshold value of %thresholdValue%.\n\nThis alert was originally raised at %timeOfFirstAlert%,\nwhich was %timeSinceFirstAlert% ago.\n\nThe next alert (should one occur) will be sent in %timeTillNextAlert%.

# Configuration for the IRC alerter
# The level alerts have to bypass to be sent
Alerter.IRC.level = OK
# The IRC server name
Alerter.IRC.IRCServer = irc.example.com
# and it's port
Alerter.IRC.IRCPort = 6667
# A list of nicks to try and be
Alerter.IRC.nickList = iscreamBot;_iscreamBot;i-screamBot
# Username to be
Alerter.IRC.user = i-scream
# Responses to CTCP prods
Alerter.IRC.comment = i-scream alerting bot (based on PircBot)
Alerter.IRC.finger = i-scream alerting bot (based on PircBot)
# Channel to join
Alerter.IRC.channel = #i-scream
# Message to use when sending an alert
Alerter.IRC.message = %level%: %attributeName% on %source% has passed %threshold%(%thresholdValue%) threshold with %value% - time till next alert (should one occur), %timeTillNextAlert%
# How long to wait before reconnecting
Alerter.IRC.reconnectDelay = 30
# Notice to send when starting up
Alerter.IRC.startupNotice = i-scream alerting bot activated 
# Commands the bot will recognise
Alerter.IRC.stopCommand = stop alerts
Alerter.IRC.startCommand = start alerts
Alerter.IRC.lastAlertCommand = last alert
Alerter.IRC.joinCommand = join
Alerter.IRC.nickChangeCommand = nick
Alerter.IRC.statCommand = statistics
Alerter.IRC.uptimeCommand = uptime
Alerter.IRC.timeSinceLastAlertCommand = time since last alert
Alerter.IRC.versionCommand = version
Alerter.IRC.helpCommand = help
# Message to send when the bot is addressed and
# doesn't understand the command
Alerter.IRC.rejectMessage = sorry, I don't understand your request

# Configuration for the Logging Alerter
# This alerter writes alerts to the i-scream logfile.
# The level alerts have to bypass to be logged
Alerter.Logging.level = WARNING
# The message to use when logging the alert
Alerter.Logging.message = %level%: %attributeName% on %source% has passed %threshold%(%thresholdValue%) threshold with %value%


############################################################
#### WebFeeder Configuration
############################################################

# The WebFeeder drops alerts and latest data in to a
# directory for the web interface to use. It is essentially
# the link between the web interface and the server.

# Set these to something to tell the WebFeeder to drop
# latest data, alerts, or both. Comment themt o disable.
WebFeeder.latestActive = true
WebFeeder.alertActive = true

# We can make the WebFeeder only drop alerts that go
# past a certain level. The default is "OK", which makes
# all alerts get passed on.
Alerter.WebFeeder.level = OK

# The WebFeeder cleans out old and stale alerts when it
# performs a check. This setting is the period, in seconds,
# at which a check happens.
WebFeeder.checkPeriod = 120

# Delete alerts older than this, in seconds.
WebFeeder.alertDeleteOlderThan = 300

# Data will be dropped to a subdirectory (specified
# below) of this directory.
WebFeeder.rootPath = /web/i-scream

# SubDir is the directory below rootPath which latest
# data will be placed in. Below that a directory will
# be created with the machine name, and a file named
# FileName (specified here) will be created containg
# the data.
WebFeeder.latestSubDir = latest
WebFeeder.latestFileName = latest_data

# As above, but for the alerts.
WebFeeder.alertSubDir = alert
WebFeeder.alertFileName = alert_data


############################################################
Revision:	1.72
Committed:	Thu Feb 27 22:08:03 2003 UTC (21 years, 8 months ago) by tdb
Branch:	MAIN
Changes since 1.71:	+8 -2 lines
Log Message:	Changed the host UDPUpdateTime from 10 seconds to 60 seconds! Also added ConfigTTL for the host, which defaults to an hour. This setting defines the time a configuration is considered valid for. After this time the host should make an effort to check if the config is still valid. And, thus the loop continues ;)
#	User	Rev	Content
1	tdb	1.2	# This is the default system configuration file
2			# used by all components of the i-scream system
3			#
4			# ALL configuration that uses the centralised
5			# configuration system has this file as its
6			# root of configuration
7			#
8	tdb	1.70	# This is a working sample configuration, which
9			# aims to provide a working "out of the box"
10			# setup, aswell as a some example configuration.
11			#
12	tdb	1.59	# $Author: tdb $
13	tdb	1.72	# $Id: system.conf,v 1.71 2003/02/24 20:18:45 tdb Exp $
14	tdb	1.70	#
15			# http://www.i-scream.org.uk/
16	ajm	1.14	#
17	tdb	1.70
18	ajm	1.14	############################################################
19			#### Configuration Files & Groups
20			############################################################
21
22	tdb	1.70	# All components, such as hosts, will take their configuration
23			# as given in this file. Unless, that is, they have an extra
24			# configuration file specified here, or they're in a group
25			# that has a configuration file. If this is the case the extra
26			# configuration will override what is given in this file.
27
28			# We can define an extra configuration file for any component
29			# of the system. This is done by specifying the following:
30			#
31			# config.component=someconfigfile.conf
32			#
33			# Component names will be defined in the documentation for
34			# the component. An example is that a host component is
35			# known by the name "Host.hostname" or "Host.ip".
36			# It is also possible to use the wildcard "*" in a
37			# hostname or IP address.
38
39			# This defines that server.example.com has some extra
40			# configuration in the file 'server.conf'.
41			config.Host.server.example.com=exserver.conf
42
43			# All webservers are placed in a group named 'www'.
44			group.www=Host.www1.example.com;Host.www2.example.com
45			# Then we define some extra config for them.
46			config.www=webservers.conf
47
48			# Our workstations are in their own subnet.
49			group.workstations=Host.192.168.10.*;
50			# They can have their own config too.
51			config.workstations=workstations.conf
52
53			# Any hosts not specified by now have the default
54			# config as given in this file.
55
56			# Another component of the system is the mySQL
57			# database part of the server call the DBInterface.
58			# This has it's own config so the passwords for the
59			# mySQL database can be kept seperate.
60			#config.mySQL=mySQL.conf
61	tdb	1.15
62	ajm	1.14
63	ajm	1.16	############################################################
64			#### Misc system-wide configuration
65			############################################################
66
67	tdb	1.70	# The ConfigurationProxy caches configuration for various
68			# parts of the server. This setting defines how often, in
69			# seconds, the proxy will check if the data it contains
70			# is still valid.
71	ajm	1.16	ConfigurationProxy.updateTime=60
72
73	tdb	1.70	# The internal Queue's can be monitored. This specifies
74			# the interval, in seconds, at which their state should
75			# be monitored.
76	ajm	1.16	Queue.MonitorInterval=15
77	tdb	1.70	# The maximum size a Queue can be before items are
78			# dropped when new ones arrive.
79	tdb	1.40	Queue.SizeLimit=1000
80	tdb	1.70	# And which items we should drop when the queue is full
81			# and new items arrive. Choices are:
82			# RANDOM - drop a random item from the queue
83			# FIRST - drop the first item from the queue
84			# LAST - drop the last item from the queue
85			# DROP - drop the new item from the queue
86	tdb	1.40	Queue.RemoveAlgorithm=FIRST
87	tdb	1.2
88	tdb	1.70	# The XMLCache caches data passing through the system.
89			# This setting specifies the time, in seconds, at which
90			# the caches contents will be rotated. In real terms
91			# this means the minimum age at which an XMLPacket can
92			# be before it is up for deletion from the cache.
93	tdb	1.68	XMLCache.cleanupPeriod=30
94	ajm	1.14
95	tdb	1.70
96	ajm	1.14	############################################################
97			#### FilterManager configuration
98			############################################################
99	tdb	1.2
100	tdb	1.70	# The FilterManager accepts connections from hosts
101			# upon startup. It provides them with configuration
102			# and details of which filter to talk to. This setting
103			# specifies which port (TCP) it listens on.
104	tdb	1.2	FilterManager.listenPort=4567
105
106	tdb	1.70	# An Access Control List for the FilterManager. One
107			# might consider something like this:
108			#
109			# FilterManager.ACL=DEFAULT:DENY;*.example.com:ALLOW
110			FilterManager.ACL=DEFAULT:ALLOW
111	ajm	1.14
112
113			############################################################
114			#### Filter configuration
115			############################################################
116
117	tdb	1.71	# A Filter accepts data from hosts on a UDP port. It is
118			# specified here.
119	tdb	1.2	Filter.UDPListenPort=4589
120
121	tdb	1.70	# Filters contain plugins for checking the data passing
122			# through them. This plugins do the job of "filtering".
123			# This setting specifies the java package they're
124			# contained in.
125	tdb	1.55	Filter.PluginsPackage=uk.org.iscream.cms.server.filter.plugins
126	tdb	1.70	# And the names of the plugins to be loaded.
127	tdb	1.71	Filter.Plugins=TypeChecker;EnforceEssentialData;SourceChecker
128	ajm	1.14
129	tdb	1.70	# The special filter known as the "Root Filter" needs
130			# a name within the system.
131	tdb	1.2	RootFilter.name=root
132	ajm	1.14
133	tdb	1.70	# Every Filter, except the root, needs a parent to
134			# send their data to. This is usually the root filter,
135			# although in more complex setups it might be another
136			# filter - giving a tree structure.
137	ajm	1.14	Filter.parentFilter=root
138
139	tdb	1.71	# A Filter can accept data through UDP, or from
140	tdb	1.70	# an upstream Filter (CORBA). These methods can be
141			# individually turned of on a filter. The default
142			# is to have them all on.
143	tdb	1.61	# (comment or set to 0 to disable)
144			Filter.ActivateUDPReader=1
145			Filter.ActivateCORBAReader=1
146	tdb	1.62
147	tdb	1.70	# We can also specify Access Control Lists for the
148	tdb	1.71	# UDP input of the Filters. One might want something
149			# restrictive like this:
150	tdb	1.70	#
151			# Filter.UDPACL=DEFAULT:DENY;*.example.com:ALLOW
152			Filter.UDPACL=DEFAULT:ALLOW
153
154			# A Filter plugin called the SourceChecker verifies
155			# that packets come from permitted hosts. It is
156			# given an ACL to check the hosts against. A possible
157			# ACL might be:
158			#
159			# Filter.SourceCheckerPluginACL=DEFAULT:DENY;*.example.com:ALLOW
160			Filter.SourceCheckerPluginACL=DEFAULT:ALLOW
161	tdb	1.65
162	ajm	1.14
163			############################################################
164			#### Root filter interfaces configuration
165			############################################################
166
167	tdb	1.70	# The Root FIlter can send data to various upstream
168			# data processors. There are two of these at present
169			# in the server - the DBInterface and the ClientInterface.
170			# Their component names are given here as defined below.
171			# (the DBInterface is switched off - commented - by default)
172			#RootFilter.dbInterfaceName=database
173	tdb	1.2	RootFilter.realtimeInterfaceName=realtimeclients
174	ajm	1.14
175
176			############################################################
177			#### Client interface configuration
178			############################################################
179
180	tdb	1.70	# The client interface listens for connections from clients
181			# on a TCP port. It is specified here.
182	tdb	1.2	ClientInterface.listenPort=4510
183	tdb	1.70	# The component name for the Client Interface. This should
184			# match the name specified to the Root Filter above.
185	tdb	1.52	ClientInterface.name=realtimeclients
186	tdb	1.63
187	tdb	1.70	# The Client Interface has two channels, control and data.
188			# Each of these can have an ACL for allowing connections.
189			# As per previous examples in this configuration file they
190			# could be set restrictively, but we'll leave them open
191			# by default
192			ClientInterface.TCPControlChannelACL=DEFAULT:ALLOW
193			ClientInterface.TCPDataChannelACL=DEFAULT:ALLOW
194	tdb	1.52
195
196			############################################################
197			#### Database interface configuration
198			############################################################
199
200	tdb	1.70	# The name for the Database Interface. This should match
201			# the name given to the Root Filter.
202	tdb	1.52	DBInterface.name=database
203	tdb	1.2
204	ajm	1.14
205			############################################################
206			#### Host Configuration
207			############################################################
208	tdb	1.2
209	tdb	1.70	# A host can use any filter. We'll set the default filter
210			# for all hosts to be 'filter1'. This can be a list.
211			Host.filter=filter1;
212	tdb	1.13
213	tdb	1.71	# Hosts send data every UDPUpdateTime, in seconds.
214	tdb	1.72	Host.UDPUpdateTime=60
215
216			# How long a hosts config is valid for (a TTL effectively)
217			# after this time, in seconds, has passed a host should
218			# consider it's configuration invalid and check for a new
219			# configuration as soon as it can.
220			Host.ConfigTTL=3600
221	tdb	1.2
222	tdb	1.70	# We can run service checks on a host. The java package
223			# which contains them is specified here.
224	tdb	1.55	Host.serviceChecksPackage=uk.org.iscream.cms.server.filter.plugins
225	tdb	1.2
226	ajm	1.14
227			############################################################
228			#### Monitor Configuration
229			############################################################
230
231	tdb	1.70	# Monitors allow data to be watched for possible problems.
232			# This setting specifies which java package they're in.
233	tdb	1.55	Monitor.PluginsPackage=uk.org.iscream.cms.server.client.monitors
234	tdb	1.70	# And which ones should be loaded.
235	tdb	1.51	Monitor.Plugins=CPU;Load;Process;Disk;Memory;Swap;Services;\
236			Heartbeat;Queue;UserCount;WebFeeder;
237	tdb	1.24
238	tdb	1.70	# Alerts timeout after a given time in seconds and go up
239			# to the next level. These can be overridden for monitors
240			# on an individual basis.
241	tdb	1.47	Monitor.alertTimeout.NOTICE=60
242			Monitor.alertTimeout.WARNING=900
243			Monitor.alertTimeout.CAUTION=1800
244			Monitor.alertTimeout.CRITICAL=3600
245	ajm	1.14
246	tdb	1.47	## Threshold values
247			#
248	tdb	1.70	# Here we specify the threshold for each monitor. When
249			# a threshold is broken an alert is raised. If the
250			# UPPER threshold is broken the alertTimeout values
251			# given above are halved to make the alert escalate
252			# quicker.
253	tdb	1.47
254			# CPU monitor threshold values
255	ajm	1.16	Monitor.CPU.threshold.LOWER=90
256	tdb	1.70	Monitor.CPU.threshold.UPPER=95
257	tdb	1.44
258	tdb	1.47	# Load monitor threshold values
259	tdb	1.44	Monitor.Load.threshold.LOWER=10.0
260			Monitor.Load.threshold.UPPER=20.0
261
262	tdb	1.47	# Process Count threshold values
263	tdb	1.70	Monitor.Process.threshold.LOWER=500
264			Monitor.Process.threshold.UPPER=1000
265	tdb	1.24
266	tdb	1.47	# Memory monitor threshold values
267	tdb	1.24	Monitor.Memory.threshold.LOWER=80
268			Monitor.Memory.threshold.UPPER=90
269	tdb	1.67	# Whether to include 'cache' in the 'free' value
270			# (1 is true, anything else is false)
271			Monitor.Memory.useCacheAsFree=1
272	tdb	1.24
273	tdb	1.47	# Swap monitor threshold values
274	tdb	1.24	Monitor.Swap.threshold.LOWER=80
275			Monitor.Swap.threshold.UPPER=90
276	tdb	1.50
277			# UserCount monitor threshold values
278			Monitor.UserCount.threshold.LOWER=100
279			Monitor.UserCount.threshold.UPPER=200
280	tdb	1.24
281	tdb	1.47	# Disk monitor threshold values
282	tdb	1.42	Monitor.Disk.threshold.LOWER=90
283			Monitor.Disk.threshold.UPPER=95
284	tdb	1.47	# Thresholds given are PERCENTAGE or VALUE
285			# where PERCENTAGE is a percentage of disk in use
286			# and VALUE is an absolute value of space free
287	tdb	1.46	Monitor.Disk.thresholdMeasure=PERCENTAGE
288	ajm	1.33
289	tdb	1.56	# Queue monitor threshold values
290	tdb	1.49	Monitor.Queue.threshold.LOWER=50
291			Monitor.Queue.threshold.UPPER=80
292	tdb	1.47	# Thresholds given are PERCENTAGE or VALUE
293	tdb	1.70	# where PERCENTAGE is a percentage of the queue in use
294			# and VALUE is an absolute value of free space
295	tdb	1.46	Monitor.Queue.thresholdMeasure=PERCENTAGE
296
297	tdb	1.47	# Services monitor threshold values
298	ajm	1.34	#
299			# THE SERVICES MONITOR USES A HACK
300			# WHEREBY IT USES THE SERVICE STATUS
301	tdb	1.70	# AS THE THRESHOLD LEVEL. THIS SHOULD
302	ajm	1.34	# BE LOOKED AT!
303			#
304	tdb	1.47	# how many times we should be at the highest level before
305			# we go to a FINAL alert
306	tdb	1.38	Monitor.Services.reachFINALcount=5
307
308	tdb	1.47	# Heartbeat threshold values
309	tdb	1.25	# these are values in seconds from when the heartbeat
310			# was expected to arrive (ie. last + hearbeat period)
311	tdb	1.48	Monitor.Heartbeat.threshold.LOWER=180
312	tdb	1.38	Monitor.Heartbeat.threshold.UPPER=300
313	tdb	1.47	# this is how often we will run a "check" of heartbeats
314	tdb	1.48	Monitor.Heartbeat.checkPeriod=50
315	tdb	1.47	# how many times we should be at the highest level before
316			# we go to a FINAL alert
317			Monitor.Heartbeat.reachFINALcount=5
318	tdb	1.58	# list of hosts we expect to have at startup
319			# this ensures we notice hosts that aren't running, not
320			# just those that have gone down recently.
321	tdb	1.70	#Monitor.Heartbeat.initialHosts=importantserver.example.com;myserver.example.com
322	ajm	1.14
323	ajm	1.23
324	ajm	1.14	############################################################
325			#### Alerter Configuration
326			############################################################
327	tdb	1.70	# The following variables are understood by ALL alerters
328			# for messages. They will be substituted for their
329			# appropriate value.
330	ajm	1.23	#
331			# %level% - the alert level (eg, WARNING)
332			# %threshold% - the threshold broken (eg, LOWER)
333			# %source% - the source of the alert (eg, raptor.ukc.ac.uk)
334			# %value% - the value reached (eg, 95)
335			# %thresholdValue% - the value of the threshold broken (eg, 90)
336			# %attributeName% - the attribute that has caused the alert (eg, CPU User)
337			# %timeTillNextAlert% - the time the next alert will be sent out
338			# %timeSinceFirstAlert% - the time elapsed since the first alert for this problem
339			# %timeOfFirstAlert% - the time the first alert was sent
340			#
341	ajm	1.14
342	tdb	1.70	# The java package containing the alerters
343	tdb	1.55	Alerter.PluginsPackage=uk.org.iscream.cms.server.client.alerters
344	tdb	1.70	# And the names of the ones to activate
345			# You might want to turn them all on, but we only activate
346			# two basic ones by default.
347			# Alerter.Plugins=EMail;IRC;WebFeeder;Logging;
348			Alerter.Plugins=WebFeeder;Logging;
349	tdb	1.47
350	tdb	1.70	# Configuration for the EMail alerter
351			# The level alerts have to bypass to be e-mailed out
352	tdb	1.38	Alerter.EMail.level = WARNING
353	tdb	1.70	# A list of people to send alerts to
354			Alerter.EMail.destList = me@example.com
355			# The sender of the e-mail
356			Alerter.EMail.sender = me@example.com
357			# The SMTP server to send alerts to
358			Alerter.EMail.smtpServer = smtp.example.com
359			# The subject line of the e-mail
360	ajm	1.16	Alerter.EMail.subject = i-scream alert: %level% alert on %source% for %attributeName%
361	tdb	1.70	# The message in the e-mail
362	tdb	1.38	Alerter.EMail.message = The i-scream distributed central monitoring system has\nraised a %level% alert for the host %source%.\n\nThe value for %attributeName% of %value% has exceeded the\n%threshold% threshold value of %thresholdValue%.\n\nThis alert was originally raised at %timeOfFirstAlert%,\nwhich was %timeSinceFirstAlert% ago.\n\nThe next alert (should one occur) will be sent in %timeTillNextAlert%.
363
364	tdb	1.70	# Configuration for the IRC alerter
365			# The level alerts have to bypass to be sent
366	ajm	1.16	Alerter.IRC.level = OK
367	tdb	1.70	# The IRC server name
368			Alerter.IRC.IRCServer = irc.example.com
369			# and it's port
370	ajm	1.14	Alerter.IRC.IRCPort = 6667
371	tdb	1.70	# A list of nicks to try and be
372	tdb	1.19	Alerter.IRC.nickList = iscreamBot;_iscreamBot;i-screamBot
373	tdb	1.70	# Username to be
374	tdb	1.17	Alerter.IRC.user = i-scream
375	tdb	1.70	# Responses to CTCP prods
376	tdb	1.59	Alerter.IRC.comment = i-scream alerting bot (based on PircBot)
377			Alerter.IRC.finger = i-scream alerting bot (based on PircBot)
378	tdb	1.70	# Channel to join
379	ajm	1.14	Alerter.IRC.channel = #i-scream
380	tdb	1.70	# Message to use when sending an alert
381	ajm	1.16	Alerter.IRC.message = %level%: %attributeName% on %source% has passed %threshold%(%thresholdValue%) threshold with %value% - time till next alert (should one occur), %timeTillNextAlert%
382	tdb	1.70	# How long to wait before reconnecting
383	tdb	1.17	Alerter.IRC.reconnectDelay = 30
384	tdb	1.70	# Notice to send when starting up
385	tdb	1.17	Alerter.IRC.startupNotice = i-scream alerting bot activated
386	tdb	1.70	# Commands the bot will recognise
387	tdb	1.17	Alerter.IRC.stopCommand = stop alerts
388			Alerter.IRC.startCommand = start alerts
389			Alerter.IRC.lastAlertCommand = last alert
390			Alerter.IRC.joinCommand = join
391	tdb	1.18	Alerter.IRC.nickChangeCommand = nick
392			Alerter.IRC.statCommand = statistics
393			Alerter.IRC.uptimeCommand = uptime
394			Alerter.IRC.timeSinceLastAlertCommand = time since last alert
395	tdb	1.19	Alerter.IRC.versionCommand = version
396	tdb	1.17	Alerter.IRC.helpCommand = help
397	tdb	1.70	# Message to send when the bot is addressed and
398			# doesn't understand the command
399	tdb	1.17	Alerter.IRC.rejectMessage = sorry, I don't understand your request
400	tdb	1.54
401	tdb	1.70	# Configuration for the Logging Alerter
402			# This alerter writes alerts to the i-scream logfile.
403			# The level alerts have to bypass to be logged
404	tdb	1.54	Alerter.Logging.level = WARNING
405	tdb	1.70	# The message to use when logging the alert
406	tdb	1.57	Alerter.Logging.message = %level%: %attributeName% on %source% has passed %threshold%(%thresholdValue%) threshold with %value%
407	tdb	1.29
408	tdb	1.47
409	tdb	1.29	############################################################
410			#### WebFeeder Configuration
411			############################################################
412
413	tdb	1.70	# The WebFeeder drops alerts and latest data in to a
414			# directory for the web interface to use. It is essentially
415			# the link between the web interface and the server.
416
417			# Set these to something to tell the WebFeeder to drop
418			# latest data, alerts, or both. Comment themt o disable.
419	tdb	1.32	WebFeeder.latestActive = true
420			WebFeeder.alertActive = true
421	tdb	1.43
422	tdb	1.70	# We can make the WebFeeder only drop alerts that go
423			# past a certain level. The default is "OK", which makes
424			# all alerts get passed on.
425	tdb	1.53	Alerter.WebFeeder.level = OK
426	tdb	1.37
427	tdb	1.70	# The WebFeeder cleans out old and stale alerts when it
428			# performs a check. This setting is the period, in seconds,
429			# at which a check happens.
430	tdb	1.42	WebFeeder.checkPeriod = 120
431	tdb	1.37
432			# Delete alerts older than this, in seconds.
433	tdb	1.42	WebFeeder.alertDeleteOlderThan = 300
434	tdb	1.32
435	tdb	1.70	# Data will be dropped to a subdirectory (specified
436			# below) of this directory.
437			WebFeeder.rootPath = /web/i-scream
438
439			# SubDir is the directory below rootPath which latest
440			# data will be placed in. Below that a directory will
441			# be created with the machine name, and a file named
442			# FileName (specified here) will be created containg
443			# the data.
444	tdb	1.29	WebFeeder.latestSubDir = latest
445	tdb	1.31	WebFeeder.latestFileName = latest_data
446	tdb	1.32
447	tdb	1.70	# As above, but for the alerts.
448	tdb	1.32	WebFeeder.alertSubDir = alert
449			WebFeeder.alertFileName = alert_data
450	ajm	1.16
451	tdb	1.47
452	tdb	1.17	############################################################