Appliance Logging and Debugging

logging <syslog IPv4 address/hostname> [trap {<log-level> | override class <class> priority <log-level>}]
no logging <syslog IPv4 address/hostname> [trap {<log-level> | override class <class> priority <log-level>}]

Enables (by setting the syslog IPv4 address/hostname) sending logging messages, with ability to filter the logging messages according to their classes.
The no form of the command stops sending messages to the remote syslog server.

Syntax Description

syslog IPv4 address/hostname

syslog IPv4 address/hostname of the remote syslog server
Hostname is limited to 64 characters

log-level

• none—disables the logging locally and remotely

• 0—emerg—system is unusable (emergency)

• 1—alert—alert notification, action must be taken immediately

• 2—crit—critical condition

• 3—err—error condition

• 4—warning—warning condition

• 5—notice—normal, but significant condition

• 6—info—informational condition

• 7—debug—debug level messages

class

Sets or removes a per-class override on the logging level. All classes which do not have an override set will use the global logging level set with “logging local <log level>”. Classes that do have an override will do as the override specifies. If “none” is specified for the log level, the software will not log anything from this class. Classes available:

• mgmt-back—system management back-end

• mgmt-core—system management core

• mgmt-front—system management front-end

Default

Remote logging is disabled

Configuration Mode

config

History

8.0.0100

Example

gateway (config) # logging local info

Related Commands

show logging
logging local override
logging <syslog IPv4 address/hostname> port

Notes

logging files rotation {criteria {frequency <freq> | size <size-mb>| size-pct <size-percentage>} | force | max-number <number-of-files>}
no logging files rotation criteria

Sets the rotation criteria of the logging files.
The no form of the command removes the rotation criteria configuration.

Syntax Description

freq

Sets rotation criteria according to time. Possible options are:

• Daily

• Weekly

• Monthly

size-mb

Sets rotation criteria according to size in megabytes
Range: 1-9999
Default: 20MB

size-percentage

Sets rotation criteria according to size in percentage of the partition where the logging files are kept in. The percentage given is truncated to three decimal points (thousandths of a percent).

force

Forces an immediate rotation of the log files. This does not affect the schedule of auto-rotation if it was done based on time: the next automatic rotation will still occur at the same time for which it was previously scheduled. Naturally, if the auto-rotation was based on size, this will delay it somewhat as it reduces the size of the active log file to zero.

number-of-files

The number of log files will be kept. If the number of log files ever exceeds this number (either at rotation time, or when this setting is lowered), the system will delete as many files as necessary to bring it down to this number, starting with the oldest.

Default

10 files are kept by default with rotation criteria of 5% of the log partition size

Configuration Mode

config

History

8.0.0100

Example

gateway (config) # logging files rotation criteria size-pct 6

Related Commands

show logging
show log files

Notes

logging level {cli commands <log-level> | audit mgmt <log-level>}

Sets the severity level at which CLI commands or the management audit message that the user executes are logged. This includes auditing of both configuration changes and actions.

Syntax Description

cli commands

Sets the severity level at which CLI commands which the user executes are logged.

audit mgmt

Sets the severity level at which all network management audit messages are logged.

log-level

• none—disables the logging locally and remotely

• 0—emerg—system is unusable (emergency)

• 1—alert—alert notification, action must be taken immediately

• 2—crit—critical condition

• 3—err—error condition

• 4—warning—warning condition

• 5—notice—normal, but significant condition

• 6—info—informational condition

• 7—debug—debug level messages

Default

CLI commands and audit message are set to notice logging level

Configuration Mode

config

History

8.0.0100

Example

gateway (config) # logging level cli commands info

Related Commands

show logging

Notes

logging local override [class <class> priority <log-level>]
no logging local override [class <class> priority <log-level>]

Enables class-specific overrides to the local log level.
The no form of the command disables all class-specific overrides to the local log level without deleting them from the configuration, but disables them so that the logging level for all classes is determined solely by the global setting.

Syntax Description

override

Enables class-specific overrides to the local log level.

class

Sets or removes a per-class override on the logging level. All classes which do not have an override set will use the global logging level set with “logging local <log level>”. Classes that do have an override will do as the override specifies. If “none” is specified for the log level, the software will not log anything from this class.

Classes available:

• mgmt-back—system management back-end components

• mgmt-core—system management core

• mgmt-front—system management front-end components

log-level

• none—disables the logging locally and remotely

• 0—emerg—system is unusable (emergency)

• 1—alert—alert notification, action must be taken immediately

• 2—crit—critical condition

• 3—err—error condition

• 4—warning—warning condition

• 5—notice—normal, but significant condition

• 6—info—informational condition

• 7—debug—debug level messages

Default

Override is disabled

Configuration Mode

config

History

8.0.0100

Example

gateway (config) # logging local override class mgmt-front priority warning

Related Commands

show logging
logging local

Notes

logging receive
no logging receive

Enables receiving logging messages from a remote host.
The no form of the command disables the option of receiving logging messages from a remote host.

Syntax Description

N/A

Default

Receiving logging is disabled

Configuration Mode

config

History

8.0.0100

Example

gateway (config) # logging receive

Related Commands

show logging
logging local
logging local override

Notes

• This does not log to the console TTY port

• In-band management should be enabled in order to open a channel from the host to the CPU

• If enabled, only log messages matching or exceeding the minimum severity specified with the “logging local” command will be logged, regardless of what is sent from the remote host

show log [continuous | files [<file-number>]] [[not] matching <reg-exp>]

Displays the log file with optional filter criteria.

Syntax Description

continues

Displays the last few lines of the current log file and then continues to display new lines as they come in until the user hits Ctrl+C, similar to LINUX “tail” utility.

files

Displays the list of log files.

<file-number>

Displays an archived log file, where the number may range from 1 up to the number of archived log files available.

[not] matching <reg-exp>

The file is piped through a LINUX “grep” utility to only include lines either matching, or not matching, the provided regular expression.

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

gateway (config) # show log matching "Executing|Action"

Jul 31 16:11:23 M2100-aj cli[26502]: [cli.NOTICE]: user : Executing command: enable
Jul 31 16:11:24 M2100-aj cli[26507]: [cli.NOTICE]: user : Executing command: enable
Jul 31 16:11:29 M2100-aj cli[26514]: [cli.NOTICE]: user : Executing command: enable
Jul 31 16:11:29 M2100-aj cli[26514]: [cli.NOTICE]: user : Executing command: show license
Jul 31 16:11:41 M2100-aj cli[26548]: [cli.NOTICE]: user : Executing command: enable
Jul 31 16:11:42 M2100-aj cli[26553]: [cli.NOTICE]: user : Executing command: enable
Jul 31 16:11:42 M2100-aj cli[26553]: [cli.NOTICE]: user : Executing command: conf termina

Related Commands

logging fields
logging files rotation
logging level
logging local
logging receive
show logging

Notes

• When using a regular expression containing | (OR), the expression should be surrounded by quotes (“<expression>”), otherwise it is parsed as filter (PIPE) command

• The command’s output has many of the options as the Linux “less” command. These options allow navigating the log file and perform searches. To see help for different option press “h” after running the “show log” command.

show logging

Displays the logging configurations.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

gateway (config) # show logging

Local logging level                       : notice
Override for class debug-module           : notice
Default remote logging level              : notice
Allow receiving of messages from remote hosts: no
Number of archived log files to keep      : 10
Log rotation size threshold               : 19.07 megabytes
Log rotation (debug) size threshold       : 19.07 megabytes
Log format                                : standard
Subsecond timestamp field                 : disabled
MAC address masking                       : enabled

Levels at which messages are logged:
  CLI commands  : notice
  Audit messages: notice

Remote syslog servers:
  1.1.1.1:
    log level             : notice
    Remote port           : 514
    Filter [include] regex: err

  1.2.2.3:
    log level  : notice
    Remote port: 33

Related Commands

logging fields
logging files rotation
logging level
logging local
logging receive
logging <syslog IPv4 address/hostname>

Notes

show log debug [continuous | files | matching | not]

Displays current event debug-log file in a scrollable pager.

Syntax Description

continuous

Displays new event log messages as they arrive

files

Displays archived debug log files

matching

Displays event debug logs that match a given regular expression

not

Displays event debug logs that do not meet certain criteria

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

gateway (config) # show log debug

May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: cli_parse_one_level: word=show, 70 children, 0 cmds, unavail=0
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: cli_match_one_word: err=0 word=show unavail=0 num_cmds=2722
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: cli_parse_one_level: word=log, 43 children, 2722 cmds, unavail=0
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: cli_match_one_word: err=0 word=log unavail=0 num_cmds=2722
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: cli_match_one_word: err=0 word=log unavail=0 num_cmds=2722
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: cli_parse_one_level: word=debug, 6 children, 2722 cmds, unavail=0
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: cli_match_one_word: err=0 word=debug unavail=0 num_cmds=2722
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: pipe() returned read fd 9 and write fd 10 for llc_failure_pipe
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: libevent: in lew_event_delete(0x260f150)
May 26 12:17:21 gateway cli[14941]: [cli.DEBUG]: user admin: libevent: dooming event 0x260f150

Related Commands

Notes