输出

使用命令行 Workstation › CLW 命令参考 › 启动事务跟踪会话 › 列出 SNMP 收集 › 输出

输出

将事务跟踪输出发送到指定文件。

命令选项

本节介绍了事务跟踪命令选项。

跟踪模式

CLW 支持两种用于捕获事务跟踪会话结果的模式：

同步模式－默认情况下，CLW 在会话结束时将跟踪写入到事务事件数据库以及名为 TransactionTraceData-yyyyMMddhhmmss.xml 的单个 xml 文件，其中日期-时间字符串反映该会话的开始时间。
异步模式－在此模式下，将每个事务报告到事务事件数据库时，CLW 就立即将该事务跟踪写入到其自己的名为 nnnn(sec)-TransactionTraceDatayyyyMMddhhmmss-<sequence number>.xml 的 XML 文件中，其中 nnnn 是以秒为单位的事务持续时间，日期-时间字符串反映事务的开始时间。如果您提供自己的文件名，它会在最后的“.”之前添加一个序号。如果所提供的文件名不含“.”，它会在文件名末尾添加一个序号。

以同步模式记录的结果更容易查看－所有数据都在单个文件中。但是，必须等到会话结束后您才能查看数据，对于大容量或复杂的事务，同步捕获可能会消耗大量内存。

以异步模式记录事务数据占用较少内存，并且您在事务跟踪会话结束之前就可以查看事务数据。

-Dintroscope.clw.tt.mode=(Synch|Asynch)

仅输出到事务事件数据库

使用此选项运行事务跟踪并将输出仅保存到事务事件数据库（非 xml 文件输出）。可以通过某个 Introscope 报警触发此命令，该报警被触发后将触发该命令以自动启动跟踪事务。

如下所示，在命令前添加单词 quietly：

quietly trace transactions exceeding 2 seconds in agents matching "(.*)" for 60 seconds

仅返回标头数据

在某些情况下，通过 CLW 检索大量事务追踪数据时，traces.db 文件可能会无限增长，导致 CLW 花费很长时间才能返回数据。将此属性设为 false，可以减少企业管理器返回的数据量，从而解决上述问题。

CLW 将只返回标头跟踪数据。默认情况下，或在此属性设置为 true 时，通过 CLW 获取事务跟踪数据将同时返回标头和正文。

-Dwily.ps.workstation.clws.gettracebody

事务跟踪器限定

默认情况下，单个事务跟踪达到 5000 个跟踪组件时，会限制其大小。超出限制的事务跟踪将被丢弃在代理上，并在代理日志文件中记录如下警告消息：

2/23/07 05:33:18 PM PST [WARN] [IntroscopeAgent] Transaction trace component limit of 5000 reached, recording will cease for this transaction.

要更改一个事务跟踪中允许的最大组件数，请更改以下代理属性：

introscope.agent.transactiontrace.componentCountClamp=max_TT_components（默认值是 5000）

例如，代理配置文件中的以下行：

introscope.agent.transactiontrace.componentCountClamp=30000

将事务跟踪中允许的最大组件数更改为 30,000。

警告！：如果增大此限制大小，事务跟踪可能会需要更多的内存，因此您有必要相应调整 JVM 的最大堆大小，否则企业管理器可能会内存不足。

事务跟踪命令示例

本节提供了启动事务跟踪会话的 CLW 命令示例。每个示例命令启动一个 600 秒长的会话。来自所有代理的超过 5 秒的事务将被跟踪。

注意：所有示例命令都使用默认登录设置连接到企业管理器。

有关用来运行事务跟踪会话的脚本示例，请参阅示例脚本。

使用默认选项值的事务跟踪

此 CLW 命令使用以下默认设置启动事务跟踪会话：

跟踪模式－同步捕获事务跟踪数据－所有结果都写入到单个 xml 文件中。

目录位置－未指定 -Dintroscope.clw.tt.dirname 时，跟踪结果将写入到当前工作目录中。

java -jar CLWorkstation.jar trace transactions exceeding 5 seconds in agents matching "(.*)" for 600 seconds

使用异步捕获执行事务跟踪

此 CLW 命令启动事务跟踪会话并为会话输出使用默认目录位置：

java –Dintroscope.clw.tt.mode=Asynch -jar CLWorkstation.jar trace transactions exceeding 5 seconds in agents matching "(.*)" for 600 seconds

数据以异步模式捕获－为每个事务创建单独的 xml 文件。

将事务跟踪结果写入用户定义的目录中

此 CLW 命令使用跟踪模式的默认设置启动事务跟踪会话－以同步模式捕获事务跟踪数据。所有结果都写入到单个 xml 文件中：

java –Dintroscope.clw.tt.dirname=C:\mytraces -jar CLWorkstation.jar trace transactions exceeding 5 seconds in agents matching "(.*)" for 600 seconds

此命令为 xml 文件指定非默认位置－C:\mytraces 目录。

使用参数和错误筛选器的事务跟踪

您可以启动指定了运行秒数并使用与工作站中可用的筛选器相同的筛选器（用户 ID、URL、URL 查询、会话 ID、请求标头、请求参数、会话属性以及错误）的事务跟踪会话：

对用户 ID、URL、URL 查询或会话 ID 进行筛选

trace transactions where (userid|url|url query|sessionid) (equals|not equals|contains|not contains|starts with|ends with) [EXACT MATCH] in agents matching [REGULAR EXPRESSION] for [EXACT MATCH] (second|seconds|sec|secs|s)
trace transactions where (userid|url|url query|sessionid) (exists|not exists) in agents matching [REGULAR EXPRESSION] for [EXACT MATCH] (second|seconds|sec|secs|s)
quietly trace transactions where (userid|url|url query|sessionid) (equals|not equals|contains|not contains|starts with|ends with) [EXACT MATCH] in agents matching [REGULAR EXPRESSION] for [EXACT MATCH] (second|seconds|sec|secs|s)
quietly trace transactions where (userid|url|url query|sessionid) (exists|not exists) in agents matching [REGULAR EXPRESSION] for [EXACT MATCH] (second|seconds|sec|secs|s)

对请求标头、请求参数或会话属性进行筛选

trace transactions where (request header|request parameter|session attribute) [EXACT MATCH] (equals|not equals|contains|not contains|starts with|ends with) [EXACT MATCH] in agents matching [REGULAR EXPRESSION] for [EXACT MATCH] (second|seconds|sec|secs|s)
trace transactions where (request header|request parameter|session attribute) [EXACT MATCH] (exists|not exists) in agents matching [REGULAR EXPRESSION] for [EXACT MATCH] (second|seconds|sec|secs|s)
quietly trace transactions where (request header|request parameter|session attribute) [EXACT MATCH] (equals|not equals|contains|not contains|starts with|ends with) [EXACT MATCH] in agents matching [REGULAR EXPRESSION] for [EXACT MATCH] (second|seconds|sec|secs|s)
quietly trace transactions where (request header|request parameter|session attribute) [EXACT MATCH] (exists|not exists) in agents matching [REGULAR EXPRESSION] for [EXACT MATCH] (second|seconds|sec|secs|s)

对错误进行筛选

trace transactions with errors containing [EXACT MATCH] in agents matching [REGEX] for [EXACT MATCH] (second|seconds|sec|secs|s)
quietly trace transactions with errors containing [EXACT MATCH] in agents matching [REGEX] for [EXACT MATCH] (second|seconds|sec|secs|s)

对事务事件数据库执行的事务跟踪查询

事务跟踪结果自动存储在事务事件数据库中。可使用此处描述的 CLW 命令来检索该数据。

Get Historical Events Matching <VALUE>

此命令从事务事件数据库检索完整的事件 XML 输出文件。完整事件（与下文描述的摘要事件相对）是在事务事件查看器中靠下的部分中提供的完整数据。

java –Dintroscope.clw.tt.mode=Asynch -jar CLWorkstation.jar trace transactions get historical events matching "localhost"

下面是一个输出示例：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TransactionTracerSession Duration="78" Version="0.1" EndDate="2005-06-20T17:40:24.146-08:00" StartDate="2005-06-20T17:40:24.068-08:00" User="Admin">
<TransactionTrace Domain="SuperDomain" Duration="78" Process="UnknownProcess" Host="maddleman-dt2" AgentName="Tomcat" StartDate="2005-06-20T17:40:24.068-08:00" EndDate="2005-06-20T17:40:24.146-08:00">
<CalledComponent RelativeTimestamp="0" Duration="78" ComponentType="Browser" ComponentName="Browser" MetricPath="Browser">
<CalledComponents>
<CalledComponent RelativeTimestamp="0" Duration="0" ComponentType="JNDI" ComponentName="ProxyDirContext" MetricPath="JNDI|Context|ProxyDirContext">
<Parameters>
<Parameter Value="lookup" Name="Method"/>
</Parameters>
</CalledComponent>
<CalledComponent RelativeTimestamp="0" Duration="0" ComponentType="JNDI" ComponentName="ProxyDirContext" MetricPath="JNDI|Context|ProxyDirContext">
<Parameters>
<Parameter Value="lookup" Name="Method"/>
</Parameters>
</CalledComponent>
<CalledComponent RelativeTimestamp="0" Duration="62" ComponentType="Servlets" ComponentName="HelloWorldExample" MetricPath="Servlets|HelloWorldExample">
<CalledComponents>
<CalledComponent RelativeTimestamp="0" Duration="0" ComponentType="JNDI" ComponentName="ProxyDirContext" MetricPath="JNDI|Context|ProxyDirContext">
<Parameters>
<Parameter Value="lookup" Name="Method"/>
</Parameters>
</CalledComponent>
<CalledComponent RelativeTimestamp="0" Duration="0" ComponentType="JNDI" ComponentName="ProxyDirContext" MetricPath="JNDI|Context|ProxyDirContext">
<Parameters>
<Parameter Value="lookup" Name="Method"/>
</Parameters>
</CalledComponent>
</CalledComponents>
</TransactionTrace>
</TransactionTracerSession>

Get summaries matching <VALUE>

此命令从事务事件数据库仅检索事件摘要 XML 并输出一个 xml 文件。事件摘要是在事务事件查看器的顶部窗格中提供的信息。此命令可以用来导出事务事件数据库中的数据以便生成有关系统发生的错误数（例如每天发生的错误数）的报告。

get historical event summaries matching [REGULAR EXPRESSION]

下面是一个输出示例：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TransactionTracerSession Duration="78" Version="0.1" EndDate="2005-06-20T17:40:24.146-08:00" StartDate="2005-06-20T17:40:24.068-08:00" User="Admin">
<TransactionTrace Domain="SuperDomain" Duration="78" Process="UnknownProcess" Host="maddleman-dt2" AgentName="Tomcat" StartDate="2005-06-20T17:40:24.068-08:00" EndDate="2005-06-20T17:40:24.146-08:00">
<CalledComponent RelativeTimestamp="0" Duration="78" ComponentType="Browser" ComponentName="Browser" MetricPath="Browser">
<Parameters>
<Parameter Value="" Name="URL"/>
<Parameter Value="Normal" Name="Trace Type"/>
<Parameter Value="\20050620\17\1119314425302" Name="Trace ID"/>
<Parameter Value="" Name="User ID"/>
</Parameters>
</CalledComponent>
</TransactionTrace>
</TransactionTracerSession>

应用程序分类视图命令

分类视图报警是与 AppMap 和 AppMap 实体关联的专用报警。分类视图报警位于 TriageMapConfigurationsManagementModule.jar 文件的分类视图配置管理模块中。

以下命令可供该管理模块使用：

列出管理模块

此命令用于列出分类视图管理模块的名称。

语法

list management modules matching <REGULAR EXPRESSION>

示例

list management modules matching (Triage Map.*)

此命令将列出名称以 Triage Map 开头的管理模块。

输出

列出每个管理模块的名称和状态。在此示例中，分类视图配置管理模块会匹配正则表达式，并按如下方式列出：

Triage Map Configurations

查询管理模块的状态

此命令用于列出分类视图管理模块的状态。

语法

query state of management modules matching [REGULAR EXPRESSION]

示例

query state of management modules matching (.*)

此命令可返回所有管理模块的名称和状态。

输出

列出为您的系统配置的每个管理模块的名称和状态。例如：

Supportability:Active
Trade Application Definitions:Active
Triage Map Configurations:Active
Browser Response Time Adapter:Active
Sample:Active
MOM Infrastructure Monitoring:Active
Reports Unit Tests:Active
Collector - 1:Active
ChangeDetector:Active
CEM BT Stats:Active

列出分类视图报警

此命令用于列出分类视图报警。

语法

list triage map alerts matching [REGULAR EXPRESSION] in management modules matching [REGULAR EXPRESSION]

示例

list triage map alerts matching (.*) in management modules matching (Triage Map .*)

此命令将尝试列出名称以 Triage Map 开头的管理模块中的所有分类视图报警。

输出

列出为您的系统配置的所有分类视图报警的名称。例如：

Triage Map Configurations.By Frontend|TradeService|Health:Average Response Time (ms)_Summary_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|loginAdmin.action|loginAdmin.action:Errors Per Interval_Summary_MetricAlert
Triage Map Configurations.By Frontend|ReportingService|Backend Calls|WebServices:Average Response Time (ms)_Location_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|viewNewlyRegisteredPatients.action:Average Response Time (ms)_Location_MetricAlert
Triage Map Configurations.By Frontend|PatientFacadeServiceWebApp|Backend Calls|//localhost%9082/medrec(POINTBASE DB):Alert
Triage Map Configurations.By Frontend|ReportingEngine|Backend Calls|jdbc%hsqldb%file%report-records:Stall Count_Summary_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|viewNewlyRegisteredPatients.action:Stall Count_Location_MetricAlert
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|home.action:Alert
Triage Map Configurations.By Frontend|/medrec|Health:Errors Per Interval_Location_MetricAlert
Triage Map Configurations.Business Service|Trading Service|Business Transactions|View Orders:Total Defects Per Interval_Summary_MetricAlert
Triage Map Configurations.By Frontend|AuthenticationService|Health:Errors Per Interval_Summary_MetricAlert
Triage Map Configurations.By Business Service|Trading Service|Options Trading|Check Options:Concurrent Invocations_Summary_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|index.action|index.action:Stall Count_Location_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|index.action|index.action:Concurrent Invocations_Summary_MetricAlert
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|viewPatients.action:Total Defects Per Interval_Summary_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|index.action|index.action:Average Response Time (ms)_Summary_MetricAlert

查询管理模块的状态

此命令用于列出分类视图报警的状态。

语法

query state of triage map alerts matching [REGULAR EXPRESSION] in management modules matching [REGULAR EXPRESSION]

示例

query state of triage map alerts matching (.*) in management modules matching (Triage Map .*)

此命令将列出名称以 Triage Map 开头的管理模块中的所有分类视图报警及其状态。

输出

列出为您的系统配置的所有分类视图报警的名称及其状态。例如：

Triage Map Configurations.By Frontend|TradeService|Health:Average Response Time (ms)_Summary_MetricAlert:Active
Triage Map Configurations.By Business Service|MedRecBS|loginAdmin.action|loginAdmin.action:Errors Per Interval_Summary_MetricAlert:Active
Triage Map Configurations.By Frontend|ReportingService|Backend Calls|WebServices:Average Response Time (ms)_Location_MetricAlert:Active
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|viewNewlyRegisteredPatients.action:Average Response Time (ms)_Location_MetricAlert:Active
Triage Map Configurations.By Frontend|PatientFacadeServiceWebApp|Backend Calls|//localhost%9082/medrec(POINTBASE DB):Alert:Active
Triage Map Configurations.By Frontend|ReportingEngine|Backend Calls|jdbc%hsqldb%file%report-records:Stall Count_Summary_MetricAlert:Active
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|viewNewlyRegisteredPatients.action:Stall Count_Location_MetricAlert:Active
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|home.action:Alert:Active
Triage Map Configurations.By Frontend|/medrec|Health:Errors Per Interval_Location_MetricAlert:Active
Triage Map Configurations.Business Service|Trading Service|Business Transactions|View Orders:Total Defects Per Interval_Summary_MetricAlert:Active
Triage Map Configurations.By Frontend|AuthenticationService|Health:Errors Per Interval_Summary_MetricAlert:Active
Triage Map Configurations.By Business Service|Trading Service|Options Trading|Check Options:Concurrent Invocations_Summary_MetricAlert:Active
Triage Map Configurations.By Business Service|MedRecBS|index.action|index.action:Stall Count_Location_MetricAlert:Active

列出分类视图实体度量标准组

此命令用于列出分类视图实体度量标准组的名称。

语法

list triage map entity metric groups matching [REGULAR EXPRESSION] in management modules matching [REGULAR EXPRESSION]

示例

list triage map entity metric groups matching (.*) in management modules matching (Triage Map .*)

此命令将列出管理模块中名称以 Triage Map 开头的所有分类视图实体组。

输出

列出为您的系统配置的所有分类视图实体组的名称和状态。例如：

Triage Map Configurations.By Frontend|/medrec|Health:Average Response Time (ms)_Summary
Triage Map Configurations.By Frontend|AuthenticationEngine|Health:Average Response Time (ms)_Summary
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|index.action:Total Defects Per Interval_Summary
Triage Map Configurations.By Business Service|Trading Service|View Orders|View my order:Concurrent Invocations_Location
Triage Map Configurations.By Frontend|PatientFacadeServiceWebApp|Health:Errors Per Interval_Summary
Triage Map Configurations.By Business Service|Trading Service|Transaction Summary|Request Transaction Summary:Average Response Time (ms)_Summary
Triage Map Configurations.By Frontend|ReportingEngine|Health:Errors Per Interval_Summary
Triage Map Configurations.By Business Service|Trading Service|Options Trading|Check Options:Errors Per Interval_Summary
Triage Map Configurations.By Frontend|AuthenticationEngine|Backend Calls|jdbc%hsqldb%file%customer-records:Average Response Time (ms)_Summary
Triage Map Configurations.By Frontend|OrderEngine|Health:Average Response Time (ms)_Location
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|viewPatients.action:Total Transactions Per Interval_Summary
Triage Map Configurations.By Business Service|Trading Service|Options Trading|Check Options:Stall Count_Summary

查询分类视图实体度量标准组的状态

此命令用于列出分类视图实体度量标准组的状态。

语法

query state of triage map entities matching [REGULAR EXPRESSION] in management modules matching [REGULAR EXPRESSION]

示例

query state of triage map entities matching (.*) in management modules matching (Triage Map .*)

此命令将尝试列出管理模块中名称以 Triage Map 开头的所有分类视图实体及其状态。

输出

列出为您的系统配置的所有分类视图实体的名称。例如：

Triage Map Configurations.By Frontend|OrderEngine|Backend Calls:Active
Triage Map Configurations.By Business Service|MedRecBS|viewRecordSummary.action|kmuerxnjasdfgdfhjwerhgiusadfoiuoherg:Active
Triage Map Configurations.By Frontend|/medrec|Backend Calls|System localhost on port 9082:Active
Triage Map Configurations.By Business Service|MedRecBS|viewPatient.action|viewPatient.action:Active
Triage Map Configurations.By Frontend|Apache-Axis:Active
Triage Map Configurations.By Business Service|Trading Service:Active
Triage Map Configurations.By Business Service|Trading Service|Balances:Active
Triage Map Configurations.By Frontend|AuthenticationEngine:Active
Triage Map Configurations.By Frontend|AuthenticationService|Backend Calls|WebServices:Active
Triage Map Configurations.By Frontend|AuthenticationService|Health:Active
Triage Map Configurations.By Business Service|MedRecBS|viewRecordSummary.action:Active
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|kmuerxnjasdfgdfhjwerhgiusadfoiuoherg:Active
Triage Map Configurations.By Business Service|Trading Service|Place Order:Active
Triage Map Configurations.Business Service|Trading Service|Business Transactions|Login:Active
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|index.action:Active