使用 wsadmin 脚本编制来配置 XCT
可以使用 wsadmin 脚本编制来配置跨组件跟踪 (XCT)。使用本主题中的示例作为构建您自己 wsadmin 脚本的指南。
关于此任务
变量 | 描述 |
---|---|
myCell | 单元的名称 |
myNode | 节点的主机名 |
myServer | 服务器的名称 |
过程
- 使用 AdminConfig 对象来配置 XCT。
对于使用 AdminConfig 对象进行的更改,将在您下次启动服务器时生效。
- 为服务器启用 XCT。
缺省情况下,为服务器禁用 XCT。以下示例说明了当服务器使用高性能可扩展日志记录 (HPEL) 日志和跟踪方式时,如何为服务器启用 XCT。当您的服务器使用基本日志和跟踪方式时,请指定 RASLoggingService,而不是 HighPerformanceExtensibleLogging。指定 false(而非 true)可禁用 XCT。
# get rid of existing property if already present configId = AdminConfig.getid("/Cell:myCell/Node:myNode /Server:myServer/HighPerformanceExtensibleLogging: /Property:com.ibm.websphere.logging.enableCorrelation")if (len(configId) > 0): AdminConfig.remove(configId) # add new property LoggingService = AdminConfig.getid("/Cell:myCell/Node:myNode /Server:myServer/HighPerformanceExtensibleLogging:/") AdminConfig.create("Property", LoggingService, [["name", "com.ibm.websphere.logging.enableCorrelation"],["value", "true"]]) AdminConfig.save()
- 更改 XCT 的日志设置。
缺省情况下,XCT 日志设置会在日志和跟踪文件中包含请求标识。以下示例说明如何使 XCT 在日志和跟踪文件中同时包含请求标识以及如何记录 XCT 日志记录。指定 REQUEST ID(而非 LOG)可以使 XCT 仅在日志和跟踪文件中包含请求标识。指定 DATA_SNAPSHOT(而非 LOG)可以使 XCT 在日志和跟踪文件中包含请求标识,记录 XCT 日志记录以及捕获数据快照。 当您的服务器使用基本日志和跟踪方式时,请指定 RASLoggingService,而不是 HighPerformanceExtensibleLogging。
# get rid of existing property if already present configId = AdminConfig.getid("/Cell:myCell/Node:myNode /Server:myServer/HighPerformanceExtensibleLogging:/Property:com.ibm.websphere .logging.correlationLevel") if (len(configId) > 0): AdminConfig.remove(configId) # add new property LoggingService = AdminConfig.getid("/Cell:myCell/Node:myNode Server:myServer/HighPerformanceExtensibleLogging:/") AdminConfig.create("Property", LoggingService, [["name", "com.ibm.websphere.logging.correlationLevel"],["value", "LOG"]]) AdminConfig.save()
最佳实践: 当需要了解在所有线程和应用程序服务器进程中与同一请求相关的日志和跟踪条目时,请让 XCT 在日志和跟踪文件中包括请求标识。请求标识仅在使用 HPEL 日志和跟踪方式时才会记录,可供使用 logViewer 命令进行查看和用于过滤。bprac
最佳实践: 当要记录请求在线程和进程之间的分支情况,并了解有关每个请求的更多信息时,请让 XCT 创建相关日志记录。 让 XCT 创建相关日志记录可能对您的系统性能有显著影响,所以最适合测试和开发环境。bprac
最佳实践: 当您将整个请求和响应主体存储到文件系统时,请让 XCT 捕获数据快照。让 XCT 捕获数据快照可能对您的系统性能有显著影响,所以最适合测试和开发环境。XCT 捕获由 SIBus 处理的消息请求和响应的数据快照。bprac
避免故障: 数据快照将捕获并写入到 $SERVER_LOG_ROOT/snapdata 目录中。 应用程序服务器不会自动从此目录中清除文件。当启用数据快照捕获时,您将需要定期从此目录中删除文件。数据快照会存储整个请求和响应内容,并且可以包括敏感信息。此选项可能不适合在生产环境中使用。gotcha
- 为服务器启用 XCT。
- 使用 AdminControl 对象来配置 XCT。 您使用 AdminControl 对象进行的更改将立即生效。
- 为服务器启用 XCT。
缺省情况下,为服务器禁用 XCT。以下示例说明了当服务器使用 HPEL 日志和跟踪方式时,如何为服务器启用 XCT。当服务器使用基本日志和跟踪方式时,请确保服务器正在运行,然后指定 RasLoggingService(而非 HPELControlService)。指定 false(而非 true)可禁用 XCT。
LoggingMBean = AdminControl.queryNames('cell=myCell,node=myNode, type=HPELControlService,process=myServer,*') AdminControl.setAttribute(LoggingMBean, "correlationEnabled", "true")
- 更改 XCT 的日志设置。
缺省情况下,XCT 日志设置会在日志和跟踪文件中包含请求标识。以下示例说明如何使 XCT 在日志和跟踪文件中同时包含请求标识以及如何记录 XCT 日志记录。指定 REQUEST ID(而非 LOG)可以使 XCT 仅在日志和跟踪文件中包含请求标识。指定 DATA_SNAPSHOT(而非 LOG)可以使 XCT 在日志和跟踪文件中包含请求标识,记录 XCT 日志记录以及捕获数据快照。 当服务器使用基本日志和跟踪方式时,请确保服务器正在运行,然后指定 RasLoggingService(而非 HPELControlService)。
LoggingMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELControlService,process=myServer,*') AdminControl.setAttribute(LoggingMBean, "xctLevel", "LOG")
最佳实践: 当需要了解在所有线程和应用程序服务器进程中与同一请求相关的日志和跟踪条目时,请让 XCT 在日志和跟踪文件中包括请求标识。请求标识仅在使用 HPEL 日志和跟踪方式时才会记录,可供使用 logViewer 命令进行查看和用于过滤。bprac
最佳实践: 当要记录请求在线程和进程之间的分支情况,并了解有关每个请求的更多信息时,请让 XCT 创建相关日志记录。 让 XCT 创建相关日志记录可能对您的系统性能有显著影响,所以最适合测试和开发环境。bprac
最佳实践: 当您将整个请求和响应主体存储到文件系统时,请让 XCT 捕获数据快照。让 XCT 捕获数据快照可能对您的系统性能有显著影响,所以最适合测试和开发环境。XCT 捕获由 SIBus 处理的消息请求和响应的数据快照。bprac
避免故障: 数据快照将捕获并写入到 $SERVER_LOG_ROOT/snapdata 目录中。 应用程序服务器不会自动从此目录中清除文件。当启用数据快照捕获时,您将需要定期从此目录中删除文件。数据快照会存储整个请求和响应内容,并且可以包括敏感信息。此选项可能不适合在生产环境中使用。gotcha
- 为服务器启用 XCT。
结果


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_confXTCwsadmin
文件名:ttrb_confXTCwsadmin.html