FUEGO LOGLEVELS
The environment variable FUEGO_LOGLEVELS
is used to control message
output (including debug messages) during execution of a Fuego test.
Introduction
The FUEGO_LOGLEVELS
variable specifies a string containing a list of
areas and log level combinations, separated by commas. The area and
loglevel are joined by a colon.
Here is an example:
export FUEGO_LOGLEVELS="deploy:verbose,criteria:debug"
Note that a sample of this line is provided in the Jenkins job for
every test. It is, by default, commented out. However, you can easily
turn on FUEGO_LOGLEVELS
by uncommenting this line. You can customize
the log level to use for different execution areas by changing the
value of the variable.
To change this line in a Jenkins job, select the job in the Jenkins interface, then select “Configure”, and edit the line in “Execute Shell - Command” box, in the “Build” section of the job configuration.
If the FUEGO_LOGLEVELS
variable is not set, the default logging level
for all areas of test execution is “info”.
Log levels
There are 5 logging levels available, and messages from Fuego are categorized into these 5 different levels:
error
warning
info
verbose
debug
Specifying a particular level means that all messages above that level will be output. Messages at level ‘error’ are always shown, no matter what log level is specified.
Execution areas
Area names correspond to phases, and to sub-phases of the test execution stepx. The following area names are supported:
pre_test
pre_check
build
makepkg
deploy
snapshot
run
post_test
processing
parser
criteria
charting
Output functions
With this feature, 5 new functions have been added to the Fuego core.
These functions may be used in your test shell script (fuego_test.sh
), so
that your output may be managed the same way that core output is managed.
The following functions are available:
dprint - print output if the message level is ‘debug’.
vprint - print output if the message level is ‘debug’ or ‘verbose’.
iprint - print output if the message level is ‘debug’, verbose’, or ‘info’.
wprint - print output if the message level is ‘debug’, ‘verbose’, ‘info’, or warning’.
eprint - print output always (message level ‘error’)
Deprecated FUEGO_DEBUG
FUEGO_LOGLEVELS
replaces the earlier FUEGO_DEBUG
variable for controlling debug output of Fuego. However, as of Fuego
version 1.4, FUEGO_DEBUG
is still supported for backwards
compatibility.