Filter Out Entries From the Debug Log
During system runtime, you can query the debug log for a particular string of text, including words, characters, and patterns of characters, and have all logical log entries containing that expression written to a specified output file. This is useful when the debug log is large and you must isolate a specific area of functionality to understand and resolve issues.
About this task
Perform this task on the engine containing the mtx_debug.log file.
For more information about the MATRIXX environment variables, see the discussion about installation directories, navigation shortcuts, and environment variables in MATRIXX Installation and Upgrade.
Procedure
-
Go to the system log directory:
cd ${MTX_LOG_DIR}
-
Run one of the following commands,
based on whether the debug log is on the local or a remote server, where:
- input_file is the name of the log file to filter. By default, the input log is the mtx_debug.log file in the current directory.
- output_file is the name of the file in which to save the filter results, for example, debug_txn.log. Specify the full path of the output file if you do not want to write it to the local directory. You must have write permissions for the output directory.
- string is the expression to filter.
- bladeId (remote file) with the ID of the server where the core file is located.
Option Command Local server split_mtx_debug_log.py -i input_file -o output_file -p string Remote server in the cluster run_cmd_on_blade.py -b bladeId "split_mtx_debug_log.py -i input_file -o output_file -p string For information about these scripts, see the discussions about split_mtx_debug_log.py and run_cmd_on_blade.py.