Configuration

This section describes all Syslog Collector configuration settings.

settings – Syslog Collector settings

This is the main configuration file for Syslog Collector.

Options you must set

settings.SUBAGENT_BASE_OID

Root of the OID subtree for SNMP Agent.

Information exposed througout SNMP protocol can be retrieved by requesting SUBAGENT_BASE_OID + “.” + one of the following indexes + <index of regex in MSG_REGEX_LIST + 1>:

• 1 –> name as configured in MSG_REGEX_LIST
• 2 –> regex as configured in MSG_REGEX_LIST
• 3 –> exit_if_matched as configured in MSG_REGEX_LIST
• 4 –> last_matched
• 5 –> value (counter32: how many times regex matched)

settings.MSG_REGEX_LIST

List of tuples which represent regular expressions to be searched in syslog messages. When a regular expression matches the corresponding counter is incremented.

Each element in MSG_REGEX_LIST is a tuple with the following positional parameters:

• name: short string to indentify the regex to match
• regex: pythonic regex to compile and match
• exit_if_matched: stop matching of following regexes if matched. Set to 1 if you want to enable this behaviour. Default = 0.

Logging options

settings.LOG_FILE

Log file.

Default = ‘/tmp/my.log’

settings.LOG_LEVEL

Log level is one of ‘DEBUG’, ‘INFO’, ‘WARNING’, ‘ERROR’.

Default = “INFO”

Syslog listener options

settings.SYSLOG_BIND_PORT

Binding port to listen to syslog messages for syslog messages matcher.

Default = 5514

settings.SYSLOG_BIND_HOST

Hostname or ip addresss to bind for syslog messages matcher.

Default = 127.0.0.1

SNMP Agent options

settings.SUBAGENT_BIND_PORT

Binding port to listen for SNMP requests

Default = 1161

settings.SUBAGENT_BIND_HOST

Hostname or ip addresss to bind for SNMP (sub)agent

Default = 127.0.0.1

Next Step

Next step is study some Command Line Options to get all that you can get from syslog-agentX !