Log files for web services
This section lists the different log files that are part of Infrastructure Management.
List of log files for web services
The following table lists the log files that contain information related to Infrastructure Management:
Log file name | Description | Corresponding debug log file name |
|---|---|---|
bppmws.log | Records all activities in the web-services framework. This log file must be included in all support cases that are related to web services. | bppmws.debug.log |
errorws.log | Records details about the failures in the web services. This log file must be included in all support cases that are related to web services. | errorws.debug.log |
sapws.log | Records details about activities in the Single Access Point deployment that is for Central-Child servers (not Standalone servers). This log file must be included in all support cases that are related to web services that run on Central server; Central-Child registration, deregistration, heartbeat; and DSIM use cases. | sapws.debug.log |
bwws.log | Records details about ITDA integration. | bwws.debug.log |
imws.log | Records details about IMData CRUD web services. | imws.debug.log |
statsws.log | Records the monitoring statistics data that is related to web services. | statsws.debug.log |
slows.log | Records details about the SLO CRUD web services. | slows.debug.log |
caws.log | Records details about Integration service that is related to web services. | caws.debug.log |
eventws.log | Records details about the Event CRUD web services. | eventws.debug.log |
ciws.log | Records details about the CI CRUD web services. | ciws.debug.log |
ctaws.log | Records details about Cloud Vista web services that are used in CLM integration. | ctaws.debug.log |
streamws.log | Records details about the Event Streaming related web services. | streamws.debug.log |
The log files are present in the \pw\pronto\logs folder. The debug log files are present in the \pw\pronto\logs\debug folder. The debug log files are available only when the debug option is enabled. For information about enabling the debug option, see Debug log files.
Subsystems of Infrastructure Management
Every log file is part of the subsystem of Infrastructure Management (bppmws subsystem). The supported subsystems of Infrastructure Management are:
- statsws
- ciws
- eventws
- slows
- bppmws
bppmws is the gateway for Infrastructure Management, and bppmws is a subsystem on its own.
For example, the ciws.log file contains log entries of the web service APIs that manage CIs.
Configuration of log files
The log4j configuration file, bppmws.log4j.properties, located in the \pw\pronto\conf folder contains the configuration details of the log files for web services. Each bppmws subsystem is listed in the log4j file as appender name.
For example, the configuration of statsws subsystem in the log4j file is as follows:
#Subsystem is specified as statsws
log4j.additivity.com.bmc.sms.statsws=false
#Sets the activity as false for the subsystem, which prevents from adding the entries to the rootLogger appender
log4j.appender.statsws=org.apache.log4j.RollingFileAppender
#Defines the appender for the subsystem
Debug log files
By default, the debug log files are not available. You must enable them using the pw debug CLI command. You can use the following pw debug commands:
- pw debug list
- pw debug on|off
For information about the pw debug commands, see pw-debug.
Examples for pw debug command
The following examples explain the usage of the subsystem names for the pw debug command:
- To enable the debug log files for the slows subsystem, run the following pw debug command:
pw debug on -p jserver -s bppmws/slows
slows is the subsystem for the web services. It is prefixed with bppmws which is the gateway name. - To disable the debug log files for the bppmws subsystem, run the following pw debug command:
pw debug off -p jserver -s bppmws
bppmws is the subsystem for the web services, and it does not require the prefix of bppmws similar to other subsystems.