The tungsten_merge_logs command is designed to aid troubleshooting by consolidating the various log files into one place ordered by time.
tungsten_merge_logs [ --after {TIMESTAMP} ] [ --before {TIMESTAMP} ] [ --connector, --C ] [ --debug, --d ] [ --extension, --X ] [ --help, -h ] [ --log-limit, --L ] [ --manager, --M ] [ --quiet, --q ] [ --replicator, --R ] [ --stdout, --O ] [ --verbose, -v ]
Where:
Table 9.71. tungsten_merge_logs Command-line Options
| Option | Description |
|---|---|
--after {TIMESTAMP} | Discard all lines prior to {TIMESTAMP} |
--before {TIMESTAMP} | Discard all lines after {TIMESTAMP} |
--connector, --C | Include the connector log files |
--debug, --d | |
--extension, --X | Specify the file extension (default: log) Do NOT include the period |
--help, -h | Show help text |
--log-limit, --L | Specify the quantity of log files to gather (default: unlimited). When the wrapper rotates log files, it appends a period and an integer to the end of the log file name, when .1 is the newest and .2 is older and .3 older than that, etc. This parameter will gather the base log file plus limit minus one rotated files. |
--manager, --M | Include the manager log files |
--quiet, --q | |
--replicator, --R | Include the replicator log files |
--stdout, --O | Send merged logs to STDOUT instead of a file |
--verbose, -v | Show verbose output |
With no options specified, the tungsten_merge_logs script will gather all log files in the current directory and below.
For example:
shell>cdshell>tpm diag --allshell>tar xvzf ungsten-diag-2021-11-15-16-37-33.tgzshell>cd tungsten-diag-2021-11-15-16-37-33shell>tungsten_merge_logs
Would result in something like the following:
New merged log file ./merged.log created!
All logs files are gathered by default.
If you specify any of --connector, --replicator or --manager,
then only the log files for the specifed components will be gathered.
Using multiple options will aggregate the logs from the specified components.
Use of the --log-limit option works as follows:
a loglimit of 1 means gather the base file only, i.e. trepsvc.log
a loglimit of 2 means gather the base file and the first backup file, i.e. trepsvc.log and trepsvc.log.1
a loglimit of 3 means gather the base file and the first two backup files, i.e. trepsvc.log, trepsvc.log.1 and trepsvc.log.2
The {TIMESTAMP} must be specified as a single argument wrapped in quotes, in the
format of 'yyyy/mm/dd hh:mm:ss', including a single space between the date and time.
Hours are in 24-hour time, and all values should be left-padded with zeros.
For example:
shell> tungsten_merge_logs --before '2021/09/27 21:58:02'