View System Logs

You can view several MATRIXX log files to gather information about runtime processing, including mtx_debug.log, diameter_error_mdc.log, mdc_gateway_error_mdc.log, mtx_cmd.log, and storage_commands.log.

About this task

The mtx_debug.log has information about operations performed during runtime, operational issues, and configuration settings. The diameter_error_mdc.log and mdc_gateway_error_mdc.log files have information about error results returned to the Diameter Gateway and MDC Gateway, respectively. The mtx_cmd.log file has commands called by topology-based Python scripts, and the storage_commands.log file on the publishing server has all storage commands that are called when the publishing server starts.

For information about viewing SNMP statistics that are also valuable for debugging, see the discussion about capture_diagstats_tofile.py.

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

To view operational errors in the mtx_debug.log file:
1. Go to the system log directory:
  cd ${MTX_LOG_DIR} or cd_log_dir
2. Open the mtx.log or mtx_debug.log file with a text editor.
To view MATRIXX Data Container (MDC) error result logs for the Diameter Gateway and MDC Gateway:
1. Go to the error MDC log directory:
  cd ${MTX_ERROR_MDC_LOG_DIR} or cd_mtx_error_log_dir
2. Run the following command to list the contents of the folder, where error_log is the name of the log file type to view: Diameter or MDC. The ls -ltr command lists the long format of the files, sorted by time in reverse order:
  ls -ltr error_log
  
  Example:
  
  ls -ltr diameter_error_mdc*
3. Decide which file you are interested in and run the print_data_container_file.py script to view the its contents. The logs are in MDC format, so to view the contents in XML output, run the following command, where logname is the name of the MDC log:
  
  print_data_container_file.py -X -f logname
  
  Example:
  
  print_data_container_file.py -X -f diameter_error_mdc_1_1_1_2013_11_09_22_17_42_28172_1.log
4. To view the contents of the XML file, open it with an editor or use the grep command.
To view the debug log for all topology-based Python scripts, log into the publishing server and do the following:
1. Go to the system log directory:
  cd ${MTX_LOG_DIR} or cd cd_log_dir
2. Open the mtx_cmd.log file with a text editor.
To view a list of commands that were called when the publishing server created a database checkpoint:
1. Go to the system log directory on the publishing server.
  cd ${MTX_LOG_DIR} or cd cd_log_dir
2. Open the storage_commands.log file with a text editor.