adding-appenders.md

Adding Appenders

The first thing you need to do in your config object is add appenders. Each appender is added via the appender() method.

public void appender( string name, string class, [struct properties={},] [string layout,] [levelMin=0,] [levelMax=4] )

Parameters:

Name	Description
name	A unique name for the appender to register. Only unique names can be registered per instance.
class	The appender's class to register. We will create, init it and register it for you.
properties	The structure of properties to configure this appender with. (OPTIONAL)
layout	The layout class path to use in this appender for custom message rendering. (OPTIONAL)
levelMin	The numerical or English word of the minimal logging level (OPTIONAL, defaults to 0 [FATAL].)
levelMax	The numerical or English word of the maximum logging level (OPTIONAL, defaults to 4 [DEBUG].)

Examples

config.appender(
    name="CFConsole",
    class="coldbox.system.logging.appenders.ConsoleAppender"
);

config.appender(
    name="MyCF",
    class="coldbox.system.logging.appenders.CFAppender"
);

config.appender(
    name="SocketBaby",
    class="coldbox.system.logging.appenders.SocketAppender",
    properties={ host="localhost", port="444", timeout="3", persistConnection=false }
);

config.appender(
    name='Fileapp',
    class="coldbox.system.logging.appenders.FileAppender",
    properties={ filePath="/logs", fileName="Test" },
    layout="model.logging.MyFileLayout"
);