The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The Logging to Local Nonvolatile Storage feature enables system logging messages to be saved on an advanced technology attachment flash disk. Messages saved on bootflash or a harddisk persist after a device is rebooted.
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Before the Logging to Local Nonvolatile Storage feature can be enabled with the logging persistent command, you must enable the logging of messages to an internal buffer with the logging buffered command. For additional information, see the "Writing Logging Messages to Bootflash or a Harddisk" section.
The amount of bootflash or harddisk space allocated to system logging messages constrains the number of logging files that can be stored. When the allocation threshold is passed, the oldest log file in the directory is deleted to make room for new system logging messages. To permanently store system logging messages, you must archive them to an external device. For more information, see “Copying Logging Messages to an External Disk” section.
Note | Logging to local nonvolatile storage can use up to 2 GB of storage space. |
System logging messages include error and debug messages generated by application programming interfaces (APIs) on the device. Typically, logging messages are stored in a device’s memory buffer; when the buffer is full, older messages are overwritten by new messages. All logging messages are erased from the memory buffer when the device reboots.
Perform this task to enable the Logging to Local Nonvolatile Storage feature and write logging messages to bootflash or a harddisk.
1.
enable
2.
configure
terminal
3.
logging
buffered
[buffer-size |
severity-level]
4.
logging
persistent
[url
harddisk:/directory] [size
filesystem-size] [filesize
logging-file-size]
Perform this task to copy logging messages from the bootflash or a harddisk to an external disk.
1.
enable
2.
copy
source-url
destination-url
Command or Action | Purpose |
---|
The following example shows how to write up to 134217728 bytes (128 MB) of logging messages to the syslog directory of disk 0, specifying a file size of 16384 bytes:
Device(config)# logging buffered Device(config)# logging persistent url harddisk:/syslog size 134217728 filesize 16384
The following example shows how to copy logging messages from the device’s bootflash or harddisk to an external disk:
Device# copy harddisk:/syslog ftp://myuser/mypass@192.168.1.129/syslog
Related Topic |
Document Title |
---|---|
copy command |
|
Network management commands (including logging commands): complete command syntax, defaults, command mode, command history, usage guidelines, and examples |
MIBs |
MIBs Link |
---|---|
To locate and download MIBs for selected platforms, Cisco IOS XE releases, and feature sets, use Cisco MIB Locator found at the following URL: |
Description |
Link |
---|---|
The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Feature Name |
Releases |
Feature Information |
---|---|---|
Logging to Local Nonvolatile Storage |
Cisco IOS XE Release 2.1 |
The Logging to Local Nonvolatile Storage feature enables system logging messages to be saved on an advanced technology attachment flash disk. Messages saved on bootflash or a harddisk persist after a device is rebooted. The following command was introduced or modified: logging persistent. |