使用跨组件跟踪来对应用程序进行故障诊断

您可以使用跨组件跟踪 (XCT) 来帮助诊断WebSphere® Application Server。

1. 如果还未启用 XCT，请启用。
   1. 登录管理控制台。
   2. 如果使用管理代理程序拓扑，请选择要管理的节点并浏览到该节点。
   3. 从控制台的导航部分，选择故障排除>日志和跟踪。
   4. 选择要为其启用 XCT 的服务器。
   5. 选择更改日志详细级别。
   6. 选择配置如果要进行静态配置更改，则选项卡，或者运行如果要更改服务器的运行时状态，请单击此处的链接。
   7. 查看启用日志和跟踪关联复选框。
   8. 选择在日志和跟踪记录中包含请求 ID ，在日志和跟踪记录以及关联日志记录中包含请求 ID ， 或者在日志和跟踪记录中包含请求 ID、创建关联日志记录并捕获数据快照作为适当的。
   9. 单击确定。
   10. 如果在“配置”选项卡上进行了更改，请保存更改并重新启动应用程序服务器。
       最佳实践：

       • 当需要了解在所有线程和应用程序服务器进程中与同一请求相关的记录和跟踪条目时，请让 XCT 在记录和跟踪文件中包括请求标识。 请求标识仅在使用 HPEL 记录和跟踪方式时才会记录，可供使用 logViewer 命令进行查看和用于过滤。
       • 当要记录请求在线程和进程之间的分支情况，并了解有关每个请求的更多信息时，请让 XCT 创建相关日志记录。 让 XCT 创建相关日志记录可能对您的系统性能有显著影响，所以最适合测试和开发环境。
       • 当要存储针对文件系统的整个请求和响应主体时，请让 XCT 捕获数据快照。 让 XCT 捕获数据快照可能对您的系统性能有显著影响，所以最适合测试和开发环境。 XCT 捕获由 SIBus 处理的消息请求和响应的数据快照。
       • $WSXCTCONTEXTID 私有标头包含 XCT 上下文 ID，用于关联跨组件的请求。 要将来自应用程序服务器的出站 HTTP 请求与 XCT 上下文关联，请将此标头设置为应用程序服务器的入站请求上的 XCT 上下文 ID 的值。

       避免麻烦：数据快照被捕获并写入$SERVER_LOG_ROOT/snapdata目录。 应用程序服务器不会自动从此目录中清除文件。 当启用数据快照捕获时，您将需要定期从此目录中删除文件。 数据快照会存储整个请求和响应内容，并且可以包括敏感信息。 此选项可能不适合在生产环境中使用。
2. 使用 XCT 请求标识信息来跟踪请求。
   1. 确保您在使用高性能可扩展日志记录 (HPEL) 日志和跟踪方式，因为基本方式日志和跟踪方式不会存储请求标识。 阅读“从基本方式切换至 HPEL 日志和跟踪”主题以了解更多信息。
   2. 如果还未启用 XCT，请启用。
   3. 使用 HPEL LogViewer 命令行工具过滤日志以查找重要信息，如错误或警告。 使用高级格式来输出日志，以便您可以在日志中查看请求标识信息。
      例如，使用如下命令：

      logViewer -minLevel WARNING -format advanced

      

       logViewer.sh -minLevel WARNING -format advanced

   4. 在找到了您感兴趣的日志条目后，记录与这些条目相关联的请求标识。
   5. 
      
      使用 HPEL LogViewer 命令行工具并使用您在上述步骤中记录的请求标识，按请求标识来过滤您的日志，如下所示：

      logViewer -includeExtensions requestID=<requestID>

      

      logViewer.sh -includeExtensions requestID=<requestID>

      请阅读“LogViewer 命令行工具”主题以了解更多信息。
3. 使用 XCT 相关日志记录来确定调用链的层次结构。
   1. 如果还未启用 XCT，请启用。 选中在日志和跟踪记录中包括请求标识并创建相关日志记录以确保 XCT 创建相关日志记录。
   2. 如果您在使用 HPEL，请使用 LogViewer 命令行工具将日志转换为文本。
      例如，使用如下命令：

      logViewer -outLog myLog.txt

      

      logViewer.sh -outLog myLog.txt

      请阅读“LogViewer 命令行工具”主题以了解更多信息。
   3. 使用IBM® WebSphere跨组件跟踪日志查看器工具IBMSupport Assistant从参与处理您的请求的所有应用程序服务器加载日志和跟踪文件，并查看请求调用链的层次结构。 阅读使用IBMSupport Assistant主题以了解更多信息。