이전 항목: 트랜잭션 추적 세션 시작다음 항목: Loadbalancing.xml 명령


출력

트랜잭션 추적 출력을 지정된 파일에 보냅니다.

명령 옵션

이 단원에서는 트랜잭션 추적 명령 옵션을 설명합니다.

추적 모드

CLW는 트랜잭션 추적 세션 결과를 캡처하기 위한 두 가지 모드를 지원합니다.

동기 모드에서 기록된 결과는 모든 데이터가 단일 파일에 있으므로 쉽게 볼 수 있습니다. 그러나 세션이 종료되기 전에는 데이터를 볼 수 없으며, 고용량 또는 복잡한 트랜잭션의 경우에는 동기 캡처에 상당한 메모리가 소비될 수 있습니다.

트랜잭션 데이터를 비동기적으로 기록하면 메모리가 덜 소비되고, 트랜잭션 추적 세션이 종료되기 전에도 트랜잭션 데이터를 볼 수 있습니다.

-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로 설정하면 Enterprise Manager에 의해 반환되는 데이터의 양이 감소하므로 문제가 해결됩니다.

이 경우 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의 최대 힙 크기를 조정해야 할 수 있습니다. 그렇지 않으면 Enterprise Manager 메모리가 부족할 수 있습니다.

트랜잭션 추적 명령 예제

이 단원에서는 트랜잭션 추적 세션을 시작하는 CLW 명령의 예를 제공합니다. 각 예제 명령은 600초 길이의 세션을 시작합니다. 모든 에이전트에서 5초보다 오래 걸리는 트랜잭션이 추적됩니다.

참고: 모든 예제 명령은 기본 로그인 설정을 사용하여 Enterprise Manager에 연결합니다.

트랜잭션 추적 세션을 실행하는 스크립트의 예는 샘플 스크립트를 참조하십시오.

기본 옵션 값을 사용하는 트랜잭션 추적

이 CLW 명령은 다음에 대한 기본 설정을 사용하여 트랜잭션 추적 세션을 시작합니다.

비동기 캡처를 사용하는 트랜잭션 추적

이 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 디렉터리)를 지정합니다.

매개 변수와 오류 필터를 사용하는 트랜잭션 추적

실행할 시간(초)을 지정하고 Workstation에서 사용할 수 있는 것과 동일한 필터(사용자 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 명령을 사용하여 해당 데이터를 검색할 수 있습니다.

<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>
<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 엔터티와 연결된 특수 경고입니다. 심사 맵 경고는 "Triage Map Configurations"(심사 맵 구성) 관리 모듈의 TriageMapConfigurationsManagementModule.jar 파일에 있습니다.

다음 명령을 이 관리 모듈에 사용할 수 있습니다.

관리 모듈 나열

관리 모듈의 상태 쿼리

심사 맵 경고 나열

관리 모듈의 상태 쿼리

심사 맵 엔터티 메트릭 그룹 나열

심사 맵 엔터티 메트릭 그룹의 상태 쿼리

관리 모듈 나열

이 명령은 심사 맵 관리 모듈의 이름을 나열합니다.

구문

list management modules matching <REGULAR EXPRESSION>

list management modules matching (Triage Map.*)

이 명령은 Triage Map으로 시작하는 이름의 관리 모듈을 나열합니다.

출력

각 관리 모듈의 이름과 상태가 나열됩니다. 이 경우 "Triage Map Configurations"(심사 맵 구성) 관리 모듈이 정규식과 일치하며 다음과 같이 나열됩니다.

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