트랜잭션 추적 출력을 지정된 파일에 보냅니다.
이 단원에서는 트랜잭션 추적 명령 옵션을 설명합니다.
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 명령은 다음에 대한 기본 설정을 사용하여 트랜잭션 추적 세션을 시작합니다.
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 디렉터리)를 지정합니다.
실행할 시간(초)을 지정하고 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 명령을 사용하여 해당 데이터를 검색할 수 있습니다.
이 명령은 트랜잭션 이벤트 데이터베이스에서 전체 이벤트 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>
이 명령은 트랜잭션 이벤트 데이터베이스에서 이벤트 요약 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
|
Copyright © 2013 CA.
All rights reserved.
|
|