Common Reference

The tungsten_merge_logs Command

The tungsten_merge_logs command is designed to aid troubleshooting by consolidating the various log files into one place ordered by time.

Usage

tungsten_merge_logs [option]

Where:

Option	Description	Product
`--after`	Discard all lines prior to [TIMESTAMP]. 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: `tungsten_merge_logs --before '2025/09/27 21:58:02'` Default: `true`	CTTR
`--before [timestamp]`	Discard all lines after [TIMESTAMP]. 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: `tungsten_merge_logs --before '2025/09/27 21:58:02'` Default: `true`	CTTR
`--connector` Aliases: `-C`	Include the connector log files. Default: `true`	CT
`--debug` Aliases: `-d`		CTTR
`--extension` Aliases: `-X`	Specify the file extension. Do NOT include the period. Default: `log`	CTTR
`--help` Aliases: `-h`	Show help text.	CTTR
`--log-limit` Aliases: `-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. Default: `unlimited`	CTTR
`--manager` Aliases: `-M`	Include the manager log file. Default: `true`	CT
`--quiet` Aliases: `-q`		CTTR
`--replicator` Aliases: `-R`	Include the replicator log file. Default: `true`	CTTR
`--stdout` Aliases: `-O`	Send merged logs to STDOUT instead of a file. Default: `true`	CTTR
`--verbose` Aliases: `-v`	Show verbose output.	CTTR

With no options specified, the tungsten_merge_logs script will gather all log files in the current directory and below.

For example:

shell> cd    
shell> tpm diag --all    
shell> tar xvzf tungsten-diag-2021-11-15-16-37-33.tgz    
shell> cd tungsten-diag-2021-11-15-16-37-33    
shell> 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 specified 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 --log-limit of 1 means gather the base file only, i.e. trepsvc.log
a --log-limit of 2 means gather the base file and the first backup file, i.e. trepsvc.log and trepsvc.log.1
a --log-limit of 3 means gather the base file and the first two backup files, i.e. trepsvc.log, trepsvc.log.1 and trepsvc.log.2

When supplying the --before or --after options, 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'