Dump SOW File
amps_sow_dump is a utility used to inspect the contents of a SOW topic store. Additionally, it can be used to gather summary statistics on a SOW file.
Options and Parameters
filename
(required)
Filename of the SOW file.
-n LIMIT
Maximum number of records to print per file.
-v, --verbose
Print record metadata for records and file summary.
--sizing-chart
Print memory sizing chart for efficiency comparison (experimental).
-d DELIMITER
Prints only the record data using the provided ASCII character value as the record delimiter [default: 10 for newline].
--version
Show the version number of the program and exit.
-h, --help
Show the help message and exit.
Usage
The following listing shows a simple sow dump of a json format topic. Each key which exists in the order.sow file is dumped out to stdout. This output can easily be redirected to a new file, or piped into another program for further analysis.
Verbose Output
The amps_sow_dump utility also provides for verbose output, which will display more information about the file and its structure in addition to the records contained in the file.
Sizing Chart
The example below shows the output from the --sizing-chart flag. This is feature can be useful in tuning AMPS memory usage and performance. The Record Size with the asterisk shows the current Record Size setting and allows an AMPS administrator to compare memory usage efficiency along with the potential for a multi-record penalty.
This feature is currently considered to be experimental, so changing AMPS record size configuration based on the results may not necessarily help performance, and could hurt performance in some cases.
Last updated