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 |
ibrsdws.log | Records details about IBRSD integration. | ibrsdws.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.
Note
You can also refer to ProactiveNet.log and jserver.log files for BMC TrueSight Infrastructure Management Server and JServer related log entries.
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:
log4j.logger.com.bmc.sms.statsws=INFO, statsws
#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.
Note
For the pw debug
command, the subsystem name is always prefixed by the gateway name, which is bppmws
, but you do not have to prefix the gateway name if the subsystem is bppmws
.
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 withbppmws
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 ofbppmws
similar to other subsystems.
Comments
The debug commands for the bppmws subsystems do not work for TSIM 10.5. Why is the documentation littered with these basic errors?
Log in or register to comment.