Using the Bulk Statistics Formatter
The bulk statistics formatter allows you to set a remote filename dynamically and specify the format for the end of each line in the bulkstats file.
Setting Remote Filenames
The router supports the following special characters for remote filenames:
- %xAn integer in hexadecimal format (base 16)
- %sA character string
- %uAn unsigned integer in decimal (base 10)
- %dAn integer in decimal (base 10)
The % variables in the remote name are replaced at runtime with the sysName and sysUpTime parameters to produce variable filenames on the remote host.
See the bulkstats receiver remote-name command.
host1(config)#bulkstats receiver 1 remote-name "bulk%s%d.sts" sysName collectorSequenceGuidelines
The current capabilities and limitations of the bulk statistics formatter are:
- If you add %d or any numeric formatter for a string value (such as sysName), the attribute name will be used (for instance, sysName). The opposite is also true, except for sysUptime, which will use %s as a %u.
- You can use %% if you want a % character to be part of the parsed name.
- You can use the same attribute multiple times. For example, you may want a name that has %x and %u of collectorSequence.
- Currently, there is no control over sequence numbers, except for the guarantee that the formatter will:
- If you need the sequential number to restart, remove and then add the bulk statistics receiver again.
- You can use up to 128 characters for the remote file name. Anything beyond that is truncated when the filename is stored in nonvolatile memory, but this truncation is not visible until the next time the system reboots.
Specifying End of Line Format
By default, the bulk statistics application generates a DOS-compatible file that contains both a carriage return (CR) and line feed (LF) at the end of each line. The existence of a carriage return at the end of a line may cause formatting issues with some applications that do not ignore or remove carriage returns.
You can set up the system to remove the carriage return and leave only a line feed at the end of each line.
bulkstats file-format endOfLine-LF
host1(config)#bulkstats file-format endOfLine-LFUse the no version to return to the default, CR and LF.