documentation/specification/logging.txt

I-Scream Logging System - initial draft
=======================

tdb1, 29/11/2000

This document aims to cover the Logging System in the
i-Scream Central Monitoring System. Two areas will be 
covered, looking at the system from two angles.

  - Monitoring the System (user)
  
  - Utilising the Logging System (developer)


Monitoring the System
=====================

The Central Monitoring Systems provides a configurable 
logging system. A variety of loggers can easily be chosen 
betweeen by simply changing some settings in the system
configuration. The system also provides an extendable 
interface so further logging mechanisms can easily be added. 
This will be covered further later on.

How it works
------------

The system has one central point of logging for the server 
components (not the host or the clients). This functionality 
is provided over a CORBA system, but this is transparent to 
the end user. As each component is started up a request is 
made to the central naming service for the logging system, 
and then log messages can be sent straight to it.

Types of Logging Implementations
--------------------------------

The messages are passed over CORBA into the logging 
component. Here they are formatted with the date and time 
before being output to the final "destination". The system, 
as standard, provides a range of loggers, each with a 
different method of logging. At present this list stands at;

  - Screen Logger (ScreenLogger.class)
    A basic logger that outputs all messages to the console 
    on which the CORE was started up. This is the simplest 
    way of seeing what's happening.
  
  - File Logger (FileLogger.class)
    Similar to the screen logger, except all output is 
    written to a named file. This is better for ongoing 
    logging.
  
  - Multi Logger (MultiLogger.class)
    This logger, at present implements both of the above 
    loggers. It is intended to allow more versatility from 
    the system. It is planned to allow this logger to 
    support as many, or as few, or these loggers as is 
    required.
  
  - Simple GUI Logger (SimpleGUILogger.class)
    A basic GUI logger that just dumps the output to a 
    window on the console machine. Lacks many nice features, 
    such as the window scrolling.
  
  - Swing GUI Logger (SwingGUILogger.class)
    A more advanced version of the above logger, more 
    polished and much nicer to use. Can be made full screen 
    for use on a permanent logging station.

Choosing a Logger
-----------------

Choosing which logger you which to use is simple. In the 
CORE directory there should be a default.properties file. 
This file governs the initial bootstrapping of the server. 
The following two entries are required by the logging 
system.

  uk.ac.ukc.iscream.LoggerClass=ScreenLogger
  uk.ac.ukc.iscream.LoggerClassParam=

The "LoggerClass" entry specifies the name of the logger to 
use. For example, in the above case the ScreenLogger has 
been selected. Note that the .class extension is *not* 
added. This is all that is required to tell the system to 
utilise the ScreenLogger.

The second entry, "LoggerClassParam" is only required by the 
File Logger (and therfore the Multi Logger) to specify which 
file to write to. All the other loggers do not require this 
to be set. However, future loggers may use this, and 
additional parameters, to configure themselves.

Setting a Verbosity Level
-------------------------

The Logging system also provides a range of verbosity 
levels, so the output can be further tailored to suit the 
needs of the end user. The lower numbered levels give only 
the most important messages, whilst high numbers give a lot 
of information only really useful for debugging. These are 
specified as follows;

  FATAL   - (0) Fatal or Critical Errors
  ERROR   - (1) All Errors
  WARNING - (2) Warnings
  SYSMSG  - (3) System Component messages
  SYSINIT - (4) System Component initialisation
  DEBUG   - (5) All debugging messages

The required verbosity setting can be chosen in the 
default.properties configuration file - the same one in 
which the logger was specified above.

The following setting should be setting to one of the 
numbers above. In this case it has been set to maximum 
verbosity, the DEBUG level.

uk.ac.ukc.iscream.Verbosity= 5

What do the loggers not do ?
----------------------------

The loggers only monitor the state of the server. They do 
not monitor activity on either the host or clients, although 
they may well receive information from components intefacing 
with them.

They also do not log anything to do with the actual 
monitoring of hosts, but rather they monitoring the 
"monitoring system". The information provided by the loggers 
is purely for analysing the activity of the Central 
Monitoring System, and for identifying failures within the 
system.


Utilising the Logging System 
============================

To be added;

  - developing loggers
  - utilising a logger in the server


About
=====

This document was written by Tim Bishop [tdb1@ukc.ac.uk] for 
use by the team working on a 3rd year Computer Science 
project called "i-scream". More details can be found on the 
project website;

http://www.i-scream.org.uk
Revision:	1.1
Committed:	Wed Nov 29 01:28:31 2000 UTC (23 years, 11 months ago) by tdb
Content type:	text/plain
Branch:	MAIN
CVS Tags:	PROJECT_COMPLETION
Log Message:	Half of the document on the logging system.
#	Content
1	I-Scream Logging System - initial draft
2	=======================
3
4	tdb1, 29/11/2000
5
6	This document aims to cover the Logging System in the
7	i-Scream Central Monitoring System. Two areas will be
8	covered, looking at the system from two angles.
9
10	- Monitoring the System (user)
11
12	- Utilising the Logging System (developer)
13
14
15	Monitoring the System
16	=====================
17
18	The Central Monitoring Systems provides a configurable
19	logging system. A variety of loggers can easily be chosen
20	betweeen by simply changing some settings in the system
21	configuration. The system also provides an extendable
22	interface so further logging mechanisms can easily be added.
23	This will be covered further later on.
24
25	How it works
26	------------
27
28	The system has one central point of logging for the server
29	components (not the host or the clients). This functionality
30	is provided over a CORBA system, but this is transparent to
31	the end user. As each component is started up a request is
32	made to the central naming service for the logging system,
33	and then log messages can be sent straight to it.
34
35	Types of Logging Implementations
36	--------------------------------
37
38	The messages are passed over CORBA into the logging
39	component. Here they are formatted with the date and time
40	before being output to the final "destination". The system,
41	as standard, provides a range of loggers, each with a
42	different method of logging. At present this list stands at;
43
44	- Screen Logger (ScreenLogger.class)
45	A basic logger that outputs all messages to the console
46	on which the CORE was started up. This is the simplest
47	way of seeing what's happening.
48
49	- File Logger (FileLogger.class)
50	Similar to the screen logger, except all output is
51	written to a named file. This is better for ongoing
52	logging.
53
54	- Multi Logger (MultiLogger.class)
55	This logger, at present implements both of the above
56	loggers. It is intended to allow more versatility from
57	the system. It is planned to allow this logger to
58	support as many, or as few, or these loggers as is
59	required.
60
61	- Simple GUI Logger (SimpleGUILogger.class)
62	A basic GUI logger that just dumps the output to a
63	window on the console machine. Lacks many nice features,
64	such as the window scrolling.
65
66	- Swing GUI Logger (SwingGUILogger.class)
67	A more advanced version of the above logger, more
68	polished and much nicer to use. Can be made full screen
69	for use on a permanent logging station.
70
71	Choosing a Logger
72	-----------------
73
74	Choosing which logger you which to use is simple. In the
75	CORE directory there should be a default.properties file.
76	This file governs the initial bootstrapping of the server.
77	The following two entries are required by the logging
78	system.
79
80	uk.ac.ukc.iscream.LoggerClass=ScreenLogger
81	uk.ac.ukc.iscream.LoggerClassParam=
82
83	The "LoggerClass" entry specifies the name of the logger to
84	use. For example, in the above case the ScreenLogger has
85	been selected. Note that the .class extension is not
86	added. This is all that is required to tell the system to
87	utilise the ScreenLogger.
88
89	The second entry, "LoggerClassParam" is only required by the
90	File Logger (and therfore the Multi Logger) to specify which
91	file to write to. All the other loggers do not require this
92	to be set. However, future loggers may use this, and
93	additional parameters, to configure themselves.
94
95	Setting a Verbosity Level
96	-------------------------
97
98	The Logging system also provides a range of verbosity
99	levels, so the output can be further tailored to suit the
100	needs of the end user. The lower numbered levels give only
101	the most important messages, whilst high numbers give a lot
102	of information only really useful for debugging. These are
103	specified as follows;
104
105	FATAL - (0) Fatal or Critical Errors
106	ERROR - (1) All Errors
107	WARNING - (2) Warnings
108	SYSMSG - (3) System Component messages
109	SYSINIT - (4) System Component initialisation
110	DEBUG - (5) All debugging messages
111
112	The required verbosity setting can be chosen in the
113	default.properties configuration file - the same one in
114	which the logger was specified above.
115
116	The following setting should be setting to one of the
117	numbers above. In this case it has been set to maximum
118	verbosity, the DEBUG level.
119
120	uk.ac.ukc.iscream.Verbosity= 5
121
122	What do the loggers not do ?
123	----------------------------
124
125	The loggers only monitor the state of the server. They do
126	not monitor activity on either the host or clients, although
127	they may well receive information from components intefacing
128	with them.
129
130	They also do not log anything to do with the actual
131	monitoring of hosts, but rather they monitoring the
132	"monitoring system". The information provided by the loggers
133	is purely for analysing the activity of the Central
134	Monitoring System, and for identifying failures within the
135	system.
136
137
138	Utilising the Logging System
139	============================
140
141	To be added;
142
143	- developing loggers
144	- utilising a logger in the server
145
146
147	About
148	=====
149
150	This document was written by Tim Bishop [tdb1@ukc.ac.uk] for
151	use by the team working on a 3rd year Computer Science
152	project called "i-scream". More details can be found on the
153	project website;
154
155	http://www.i-scream.org.uk