Software AG Products 10.11 | Integrate Software AG Products Using Digital Event Services | webMethods API Gateway Documentation | Administrating API Gateway | Operating API Gateway | Application Log Configurations | Configuring Log Levels
 
Configuring Log Levels
You can configure the log level settings to specify the level of detail that you want to capture in the logs.
The log level settings that you can specify are described below. Each logging level includes the indicated type of message plus all messages from the levels above it (for example, the Warn level includes Fatal, Error, and Warn messages).
Log Level
API Gateway Server records these entries
Examples
Fatal
Failures that end operations in such a way that the operations cannot successfully continue without user intervention. Failure is very likely to affect other operations or products.
Product cannot read its configuration file and has no default settings.
Error
Same as Fatal, except that existing error handling renders the failure unlikely to affect other operations or products.
Business process step failed due to a service error caused by bad input data.
Warn
Problems that do not end operations, or unexpected or unusual conditions that might signal impending failure.
Multiple registered JMX servers were discovered when only one is needed.
Info
Success of an event that you need to know about.
Package loaded, or connection pool initialized.
Debug
Code-level statements recording unusual conditions or decisions that might lead to errors.
Expected an object to be initialized but it is not, or hash table is empty.
Trace
Code-level statements recording program flow and state during normal execution.
Method entry/exit, or local and global object state.
Off
No information for the product or facility is written to the server log.
You must have the API Gateway's manage general administration configurations functional privilege assigned to configure log levels.
*To configure log levels
1. Expand the menu options icon , in the title bar, and select Administration.
2. Select General > Application logs.
3. In the Log level configuration section you can configure the following parameters:
Log file type
Description
Source of the log file
API Gateway
This setting sets the API Gateway server log level. All the design time activities (such as creation of API,application, alias, and so on) and run-time activities (such as API invocation) are logged based on this setting. API Gateway server logs also contain information on the start-up activity of API Gateway server and its functioning, its state and activities related to connections to various components.
Select a log level that you want to configure to collect required logs.
The available log levels are: off, trace, debug, info, warn, error, fatal.
By default, the log level for API Gateway server logs are set as info.
Note:
Changing the log level of API Gateway logs sets that value of log level for all the log components of API Gateway.
Install_Dir/IntegrationServer/instances/default/logs/server.log
API Gateway Data Store logs
This setting sets the API Data Store log level. This contains log files of Elasticsearch bundled with API Gateway. All API Gateway assets such as API, application, alias, and so on that are stored in API Data Store are logged based on this settings.
Select a log level that you want to configure to collect required logs.
The available log levels are: off, debug, info, warn, error, fatal.
By default, the log level for API Data Store logs are set as info.
Install_Dir/InternalDataStore/logs/SAG_EventDataStore.log
Dashboard
This setting sets the log level for dashboard logs. These logs contain information regarding dashboard related activities and the kibana log files that are included in API Gateway.
Select a log level that you want to configure to collect required logs.
The available log levels are: silent, quiet, verbose.
By default, the log level for dashboard logs are set as quiet.
Install_Dir/profiles/IS_instance_name/apigateway/dashboard/startup.log
Security
This setting enables API Gateway security logs. These logs contain information on security-related administrative and operational events. For example, changes to authorization, authentication, port settings, password restrictions, attempts to log on to API Gateway and to access API Gateway services, and so on.
Select the checkbox to enable the collection of security logs.
Install_Dir/IntegrationServer/instances/default/logs/WMSECURITY*.log
Session
This setting enables API Gateway session logs. These logs contain information on sessions activated on API Gateway and provide data on when sessions start, their current status, their duration, and so on.
Select the checkbox to enable the collection of session logs.
Install_Dir/IntegrationServer/instances/default/logs/WMSESSION*.log
Platform
This setting sets API Gateway platform logs.
Select a log level that you want to configure to collect required logs.
The available log levels are: off, trace, debug, info, warn, error, fatal.
By default, the log level for platform logs are set as info.
Note:
Whenever you change the log level settings for the API Gateway platform logs, make sure you restart API Gateway for the changes to take effect.
Install_Dir/ profiles/IS_instance_name/logs/sag-osgi.log
4. Click Save.
This configures the log levels for the various log file types that can be downloaded as an archive.