Setting the log level per user

This procedure describes how to set the log level per user, which enables you to debug problems related to a specific user. A Control-M Administrator can set a specific IP/s to a specific log level. A separate log is created, ctm_web_debug.log, which includes log messages from the specified IP and messages from the Web Server related to the specified IP.

Setting log level per user:

1. From the Control- M Installation directory, open the ctmweb.debug.properties file.
2. Add a user IP under #Ip of the user we want to debug. For multiple IPs, add a line for each IP. For example:

   #Ip of the user we want to debug. Optional: you can also set the log level: debug (default), info, warn, error;

   #ip:127.0.0.2;

3. For advanced options, do one or all of the following:
   • (Optional) Change the default maximum log file size in MaxFileSize.
   • (Optional) Change the default maximum number of files to keep in backup in MaxBackupIndex.
   • (Optional) Override the default HTTP header which extracts the IP. The default is X-FORWARDED-FOR.
   • (Optional) Set the debug level for each specific IP, by typing the IP and then the debug level option. For example:

     #Ip of the user we want to debug. Optional: you can also set the log level: debug (default), info, warn, error;

     #ip:127.0.0.1, level:debug;

   When the log utility receives a request to write to the log, in addition to the standard log, it will check for the specific IP and display the messages to the debug log.