logging files

Description

Use the logging files command to configure settings for local log files.

Syntax

logging files rotation criteria frequency {daily | weekly | monthly}

logging files rotation criteria size <size in megabytes>

logging files rotation criteria size-pct <percentage>

logging files rotation force

logging files rotation max-num <number of files>

logging files upload <filename> <URL or scp://username:password@hostname/path/filename>

logging files upload cancel

Arguments

rotation criteria frequency	Rotates log files on a fixed, time-based schedule: • daily = once per day at midnight • weekly = once per week • monthly = on the first day of every month
rotation criteria size <megabytes>	Rotates log files when they surpass a size threshold, in megabytes.
rotation criteria size-pct <percentage>	Rotates log files when they surpass a specified percentage of /var partition size per log file.
rotation force	Forces an immediate rotation of the log files.
rotation max-num <number of files>	Specifies the maximum amount of log files to keep. The value must be between 0 and 4294967295.
upload <filename>	Specifies which log file to upload to a remote host.
upload <URL or scp://username:password@hostname/path/filename>	Determines the path for a remote host. Optionally, you can specify a new destination filename.
upload cancel	Cancels the current asynchronous file upload.

Defaults

None.

Command Mode

Privileged EXEC Mode

Global Configuration Mode

See Also

See the following related commands:

n

“logging”

n	“logging local”

n	“logging trap”

n	“show logging”

Usage Guidelines

None.

Examples

To delete the four oldest local log files:

(config) # logging files delete oldest 4

To keep the most recent 350 local log files:

(config) # logging files rotation max-num 350

To upload the log file, “messages” to an account at the remote SCP host, “ocean”, and rename the file to “messages_April2007”:

(config) # logging files upload messages scp://root:seminole@ocean/tmp/messagee_April2007

To upload the log file, “messages.2.gz” to the URL, www.catchall.com/tmp/, and keep the original file name:

(config) # logging files upload messages.2.gz www.catchall.com/tmp/

To rotate the log files when the /var partition surpasses 85% per log file:

(config) # logging files rotation criteria size-pct 85

Please send comments or suggestions regarding user documentation to techpubs@silver-peak.com.