Use Management Cockpit to manage Agentry log files. You can enable or disable the various files, specify how log file are generated (based on a processing thread, or more narrow areas of functionality), and set the verbosity level of the message contents.
The contents of all log messages, regardless of category, include both error messages and informational or status messages. Each message includes a date and timestamp, precise to the millisecond. The verbosity of the messages generated is configured when the category of log messages are enabled.
Log messages generated by the Agentry application are stored in log files. When enabling and configuring the logging behavior of the Agentry application, the contents of the log messages are configured. In addition, the files into which those messages are written is also configured. By default, when a log message category is enabled, those messages are written to a log file for a processing thread. Each Agentry application processing thread has its own log file containing all messages generated by the Agentry application for processing within that thread, and for the category of log messages that have been enabled.
As an optional additional method for storing log messages, each category of log messages can be written to a category-specific log file. When this is enabled, all log messages generated by the Agentry application for a specific category are written to the same log file, regardless of processing thread. The messages within the category-specific log files are grouped by the processing thread. Therefore, a category log file contains log messages resulting from processing related to that category.
Configuring the log files to generate separately based on the log message category has a negative impact on Agentry application performance, as multiple processing threads are logging messages to the same physical log file. One message at a time is written to such a log; therefore, each thread must wait until the log file is available before it can write its log message. SAP recommends that you configure log files in this manner only in a development environment.
All log files are written to the Agentry application folder in <SMP_HOME>\log\agentry. Log files are rolled over periodically, during SAP Mobile Platform Server start-up or restart, and, on command, to the subdirectory rolled.