如何启用并配置线程转储

线程转储可以提供有关代理 JVM 中正在发生的事情的有用详细信息。在与度量标准浏览器树的每个代理节点相关联的“线程转储”选项卡中都提供线程转储功能。

有关收集和分析线程转储的信息，请参阅《CA APM Workstation 用户指南》。设置 Thread_Dump 权限可允许用户查看“线程转储”选项卡并使用所有功能。有关更多信息，请参阅《CA APM 安全指南》。

启用线程转储需要使用 IntroscopeAgent.profile 和 IntroscopeEnterpriseManager.properties 属性。默认情况下，“线程转储”选项卡及其功能处于启用状态。但是，如果将其中一个或两个线程转储启用属性设置为 false，则用户将无法看到“线程转储”选项卡。

如果在 MOM 上启用或禁用线程转储，则该配置将应用于群集中的所有收集器。因此，如果在 MOM 上禁用线程转储，将同时在所有收集器上禁用线程转储。

启用线程转储

打开 <Agent_Home>/wily/core/config 目录中的 IntroscopeAgent.profile 文件并设置此属性：
```
introscope.agent.threaddump.enable=true
```
保存并关闭 IntroscopeAgent.profile。
打开位于 <EM_Home>/config 目录中的 IntroscopeEnterpriseManager.properties 文件并设置此属性：
```
introscope.enterprisemanager.threaddump.enable=true
```
保存并关闭 IntroscopeEnterpriseManager.properties。

为使 CA Introscope® 用户能够查看“死锁计数”度量标准，请配置 IntroscopeAgent.profile。您可以执行其他配置以显示代理“线程”节点度量标准。

启用“死锁计数”度量标准收集

打开 <Agent_Home>/wily/core/config 目录中的 IntroscopeAgent.profile 文件。
将此属性设置为 true 可启用“死锁计数”度量标准收集。
```
introscope.agent.threaddump.deadlockpoller.enable=true
```
（可选）设置 PBL 的完整版本以在代理“线程”节点中显示度量标准。
- 在属性 introscope.autoprobe.directivesFile 中指定 PBL 文件的名称。
  例如，要为 WebLogic 服务器使用标准 PBL 的完整版本，请将该属性设置为：
```
introscope.autoprobe.directivesFile=weblogic-full.pbl 
```
  用户可以在“AgentName”|“线程”下看到活动线程计数和线程组等度量标准。
保存并关闭 IntroscopeAgent.profile。

使用 IntroscopeAgent.profile 和 IntroscopeEnterpriseManager.properties 属性配置线程转储。

配置线程转储

打开位于 <EM_Home>/config 目录的 IntroscopeEnterpriseManager.properties 文件。
（可选）设置此属性，以将线程转储文件保存到企业管理器中的特定目录。例如，TestThreadDumps。
```
introscope.enterprisemanager.threaddump.storage.dir=TestThreadDumps
```
（可选）设置此属性，以清除指定天数以前的线程转储文件。例如，清除 30 天以前的文件。
```
introscope.enterprisemanager.threaddump.storage.clean.disk.olderthan.days=30
```
（可选）设置此属性，以在指定天数以后清除线程转储文件。例如，每两天清除一次文件。
```
introscope.enterprisemanager.threaddump.storage.clean.disk.freq.days=2
```
（可选）设置此属性，以限制可以存储在企业管理器上的线程转储文件的最大数量。例如，5000 个文件。
```
introscope.enterprisemanager.threaddump.storage.max.disk.usage=5000
```
注意：如果：

* 存储的线程转储文件数超过在 introscope.enterprisemanager.threaddump.storage.max.disk.usage 属性中设置的限制

且

* 没有 introscope.enterprisemanager.threaddump.storage.clean.disk.olderthan.days 属性中设置的天数之前的文件

则企业管理器不会存储任何线程转储文件。
保存并关闭 IntroscopeEnterpriseManager.properties。
重新启动企业管理器。

如果某个企业管理器关闭，您可以将线程转储文件复制到其他企业管理器，以便用户可以查看线程转储数据。

重要信息！ 在线程转储目录中添加或删除文件后，请重新启动企业管理器。 CA Technologies 建议不要将线程转储文件从一个企业管理器移动到其他企业管理器。

将线程转储文件从一个企业管理器复制到其他企业管理器

导航到包含线程转储文件的企业管理器 (EM1) 上的 <EM_Home>/threaddumps 目录。
复制线程转储文件。
将文件粘贴到用户要查看线程转储的企业管理器 (EM2) 上的 <EM_Home>/threaddumps 目录中。
重新启动企业管理器 EM1 和 EM2。
根据需要，在 EM2 上建立代理连接，然后启用并配置线程转储。
EM2 用户可以选择代理节点，然后在“线程转储”选项卡中单击“加载先前”按钮。将显示从 EM1 移动的线程转储列表。