Java 에이전트 속성
에이전트는 IntroscopeAgent.profile에 있는 속성을 참조하여 표준 연결 및 이름 지정 속성을 확인합니다. 에이전트를 설치하면 <에이전트 홈>/core/config 디렉터리에 에이전트 프로필이 설치됩니다.
apmdevops104kr
에이전트는 IntroscopeAgent.profile에 있는 속성을 참조하여 표준 연결 및 이름 지정 속성을 확인합니다. 에이전트를 설치하면
<에이전트 홈>
/core/config 디렉터리에 에이전트 프로필이 설치됩니다.참고:
모든 Java 에이전트 속성은 온-프레미스 CA APM에 적용되고, 일부만 Application Performance Management(CA의 Digital Experience Insights)에 적용됩니다.2
2
IntroscopeAgent.profile 위치 구성
Introscope는 다음 위치에서 순서대로 에이전트 프로필을 찾습니다.
- 시스템 속성com.wily.introscope.agentProfile에 정의된 위치
- com.wily.introscope.agentResource에 정의된 위치
- <작업 디렉터리>/core/config 디렉터리
참고:
Windows 컴퓨터에 있는 경로를 추가할 경우 백슬래시는 C:\\Introscope\\lib\\Agent.jar와 같이 다른 백슬래시로 이스케이프하십시오.IntroscopeAgent.profile의 위치를 변경할 수 있습니다.
다음 단계를 따르십시오.
- 다음 방법 중 하나를 사용하여 새 위치를 정의합니다.
- Java 명령줄에서-D옵션을 사용하여 시스템 속성을 정의합니다. IntroscopeAgent.profile 파일 위치의 전체 경로를 지정하십시오.-Dcom.wily.introscope.agentProfile.
- Java 명령줄에서-D옵션과 함께 바로 가기 시스템 속성을 사용하여 IntroscopeAgent.profile 파일 위치의 전체 경로를 지정합니다. 정규 형식이 바로 가기보다 우선합니다.-DagentProfile=/path/to/IntroscopeAgent.profile
- 클래스 경로의 리소스에서 IntroscopeAgent.profile을 사용할 수 있도록 설정합니다.com.wily.introscope.agentResource를 설정하여 에이전트 프로필이 들어 있는 리소스의 경로를 지정합니다.
- ProbeBuilder 지시문(PBD 및 PBL 파일)을 에이전트 프로필과 동일한 위치로 이동합니다. PBD 및 PBL 파일은 프로필 위치에 상대적인 위치로 참조됩니다.
명령줄 속성 재정의
Introscope에서 명령줄을 사용하여 Enterprise Manager, 에이전트, Workstation 및 WebView의 특정 속성을 재정의할 수 있습니다. 클러스터된 환경에서 Java 에이전트에 대한 명령줄 재정의는 다음과 같은 면에서 특히 유용합니다.
- 에이전트의 여러 복사본이 공유됩니다.
- 모니터링되는 응용 프로그램 각각에 대해 에이전트 설정을 구성할 필요가 없습니다.
전제 조건:
모니터링할 응용 프로그램 서버에 에이전트가 설치 및 구성되어 있습니다. 에이전트가 Enterprise Manager에 올바르게 연결됩니다.명령줄을 사용하여 에이전트 속성을 재정의하려면
- 에이전트를 시작하도록 Java 명령을 수정한 파일을 엽니다.이 파일의 위치는 사용자 환경에서 사용하는 응용 프로그램 서버에 따라 다릅니다.
- -D명령을 추가하여 속성을 재정의합니다. 예를 들어 다음 명령을 추가하여 에이전트가weblogic-full.pbl파일도 사용하도록 설정할 수 있습니다.-Dintroscope.autoprobe.directivesFile=weblogic-full.pbl열려 있는 파일에서 다른-D명령 옆에 이 명령을 배치합니다.참고:이 명령을 사용하여 핫 배포 가능 속성을 재정의할 경우 해당 속성은 더 이상 핫 배포 가능 속성이 아닙니다. 나중에 구성 파일에서 이 속성을 수정하면 Workstation 또는 WebView에서 경고 메시지가 표시됩니다. 메시지 내용은 재정의된 속성을 수정했으므로 변경 내용이 적용되지 않는다는 것입니다. 이러한 경우를 방지하려면 구성 파일에서 속성을 수정하기 전에 재정의 명령을 제거하십시오.
- 파일을 저장합니다.
- 에이전트를 다시 시작합니다.예를 들어-Dintroscope.autoprobe.directivesFile=weblogic-full.pbl명령을 추가한 경우에는 에이전트를 다시 시작한 후 에이전트 노드에 추가 WebLogic 메트릭을 표시할 수 있습니다.중요!시스템 속성은 Introscope 속성의 속성 공간에 포함됩니다. 따라서
를 사용하는 모든 항목에서IndexedProperties
같은 정보를 볼 수 있습니다.java.io.tmpdir
에이전트 장애 조치 속성
Java 에이전트와 기본 Enterprise Manager의 연결이 끊길 경우 에이전트 장애 조치를 구성할 수 있습니다. 이러한 속성은 에이전트가 장애 조치되는 대상 Enterprise Manager를 지정합니다. 이 속성은 또한 에이전트가 기본 Enterprise Manager에 대한 재연결을 시도하는 빈도도 지정합니다.
연결 순서
백업 Enterprise Manager의 연결 순서를 설정하려면
agentManager.url
속성을 사용하십시오.속성 접미사의 숫자에 따라 연결 순서가 자동으로 결정됩니다. 기본 Enterprise Manager(
agentManager.url.1
)를 사용할 수 없으면 에이전트는 다음 Enterprise Manager(agentManager.url.2
)에 연결을 시도합니다. 첫 번째 백업 Enterprise Manager와 연결할 수 없으면 에이전트는 다음 Enterprise Manager(agentManager.url.3
)에 연결을 시도합니다. 에이전트와 기본 Enterprise Manager 간의 연결이 끊어질 경우 에이전트에서 사용하는 연결 순서를 지정하십시오.
예:
agentManager.url.1=sfcollect01:5001agentManager.url.2=paris:5001agentManager.url.3=voyager:5002
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.enterprisemanager.failbackRetryIntervalInSeconds
이 속성을 설정할 경우 에이전트는 Enterprise Manager를 사용할 수 있게 될 때까지 허용되는 Enterprise Manager에 계속 연결을 시도해야 합니다.
이 속성은 거부된 에이전트가 허용되는 Enterprise Manager에 재연결을 시도하는 시간 간격(초)을 지정합니다.
- 에이전트 프로필 introscope.agent.enterprisemanager.connectionorder 속성 값에 구성된 순서를 기반으로 하는 Enterprise Manager
- loadbalancing.xml 구성을 기반으로 하는 허용되는 모든 Enterprise Manager
에이전트는 Enterprise Manager에 연결할 수 없는 경우 다음과 같은 방식으로 연결을 처리합니다.
- 허용되는 다음 Enterprise Manager에 연결을 시도합니다.
- 허용되지 않는 Enterprise Manager에는 연결하지 않습니다.
기본값
기본 간격은 120초입니다.
예:
introscope.agent.enterprisemanager.failbackRetryIntervalInSeconds=120
참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성은 에이전트가 다음 CA APM 구성 요소를 통과하여 연결할 수 있는 환경에 유용합니다.
- 클러스터
- 수집기 및 독립 실행형 Enterprise Manager
- 클러스터, 수집기 및 독립 실행형 Enterprise Manager의 조합
예:
에이전트가 다른 클러스터의 Enterprise Manager에 연결할 수 있고
introscope.agent.enterprisemanager.failbackRetryIntervalInSeconds
가 구성되어 있지 않으면 다음 작업이 수행됩니다.- 클러스터 1의 Enterprise Manager에 연결된 에이전트가 연결이 끊어집니다.
- 에이전트는 클러스터 2의 Enterprise Manager에 허용되지 않는 모드로 연결합니다.
- 에이전트는 클러스터 1의 허용되는 Enterprise Manager를 사용할 수 있게 되는 시기를 알 수 없습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
에이전트와 Enterprise Manager의 연결 속성
에이전트가 Enterprise Manager에 연결하는 방법을 제어할 수 있습니다.
agentManager.localIpaddress.1
이 속성은 에이전트가 Enterprise Manager에 연결하는 데 사용하는 응용 프로그램 서버 환경의 IP 주소를 지정합니다.
agentManager.localIpaddress.1
은 에이전트 컴퓨터에 NIC가 여러 개 있고 에이전트에 특정 NIC를 사용하려는 경우에 유용합니다.기본값:
localhost예:
agentManager.localIpaddress.1=172.31.255.255
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.agentManager.localPort.1
이 속성은 에이전트에서 Enterprise Manager에 연결할 수 있도록 응용 프로그램 서버의 기본 로컬 포트를 지정합니다. 이 속성이 설정되지 않거나 0으로 설정된 경우 에이전트는 임의의 사용 가능한 포트 번호를 선택합니다.
기본값:
0예:
agentManager.localPort.1=5000
참고:
- 서버 환경에서 사용할 에이전트의 포트 번호 설정을 사용자 지정할 수 있습니다. 이 경우 에이전트가 설치된 운영 체제의 TIME_WAIT 설정을 구성하십시오. 이 구성은 에이전트와 컨트롤러 사이의 연결 실패를 방지합니다.추가 정보:포트 시간 만료 설정을 관리하려면 에이전트가 설치된 컴퓨터의 운영 체제 설명서를 참조하십시오.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
프록시 서버에 대한 에이전트 HTTP 터널링
다음 속성은 HTTP를 통해 터널링하도록 구성되어 있고 프록시 서버를 사용하여 Enterprise Manager에 연결해야 하는 에이전트에 적용됩니다.
agentManager.httpProxy.host
이 속성은 프록시 서버 호스트 이름을 지정합니다.
기본값:
지정되지 않음참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
agentManager.httpProxy.port
이 속성은 프록시 서버 포트 번호를 지정합니다.
기본값:
지정되지 않음참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
agentManager.httpProxy.username
프록시 서버에서 에이전트 인증을 필요로 하는 경우 인증을 위한 사용자 이름을 지정합니다.
기본값:
지정되지 않음참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
agentManager.httpProxy.password
프록시 서버에서 에이전트 인증을 필요로 하는 경우 인증을 위한 암호를 지정합니다.
기본값:
지정되지 않음참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
에이전트 메모리 오버헤드 속성
상당한 에이전트 메모리 오버헤드는 극단적인 몇몇 경우에만 발생합니다. 일반적으로 메모리 소비를 줄이면 대신 응답 시간이 늘어날 수 있습니다. 그러나 각 응용 프로그램은 고유하며 메모리 사용량과 응답 시간 사이의 균형도 응용 프로그램에 따라 달라질 수 있습니다.
introscope.agent.reduceAgentMemoryOverhead
이 속성은 사용할 에이전트 구성을 지정합니다. 에이전트 메모리 오버헤드를 줄이려면 주석 처리를 제거하십시오.
값:
true 또는 false기본값:
true예:
introscope.agent.reduceAgentMemoryOverhead=true참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
에이전트 메트릭 만료 처리 속성
에이전트 메트릭 만료 처리는 사용되지 않는 메트릭을 주기적으로 에이전트 메모리 캐시에서 제거합니다. 사용되지 않는 메트릭은 구성된 시간 동안 새 데이터를 보고하지 않은 메트릭입니다. 오래된 메트릭을 제거하면 에이전트 성능을 향상하고 발생할 수 있는 메트릭 급증을 방지할 수 있습니다.
참고:
에이전트가 시스템이 처리할 수 있는 것보다 많은 메트릭을 보고할 경우 메트릭 급증이 발생합니다. 너무 많은 메트릭이 보고되면 응용 프로그램 서버의 성능에 영향을 미칠 수 있습니다. 심한 경우 에이전트로 인해 서버가 전혀 작동하지 않게 될 수도 있습니다.그룹에 속한 메트릭은 그룹의 모든 메트릭이 제거 후보에 해당하는 경우에만 제거됩니다. 현재
BlamePointTracer
및 MetricRecordingAdministrator
메트릭만 그룹으로 제거됩니다. 다른 메트릭은 개별적으로 제거됩니다.MetricRecordingAdministrator
에는 메트릭 그룹을 생성, 검색 또는 제거하기 위한 다음과 같은 인터페이스가 있습니다.- getAgent().IAgent_getMetricRecordingAdministrator.addMetricGroup문자열 구성 요소, 수집 메트릭. 구성 요소 이름은 메트릭 그룹의 메트릭 리소스 이름입니다. 동일한 메트릭 노드 아래에 메트릭이 있어야만 그룹으로 간주됩니다. 메트릭은com.wily.introscope.spec.metric.AgentMetric데이터 구조의 모음입니다. 이 모음에는AgentMetric데이터 구조만 추가할 수 있습니다.
- getAgent().IAgent_getMetricRecordingAdministrator.getMetricGroup문자열 구성 요소. 메트릭 리소스 이름인 구성 요소 이름을 기준으로 메트릭의 모음을 가져올 수 있습니다.
- getAgent().IAgent_getMetricRecordingAdministrator.removeMetricGroup문자열 구성 요소. 메트릭 그룹은 메트릭 리소스 이름인 구성 요소를 기반으로 제거됩니다.
- getAgent().IAgent_getDataAccumulatorFactory.isRemoved메트릭이 제거되었는지 확인합니다. 확장에 있는 누산기의 인스턴스를 유지하려는 경우 이 인터페이스를 사용합니다. 메트릭 만료 처리로 인해 누산기가 제거되면 이 인터페이스를 통해 사용되지 않는 참조를 유지하지 않도록 합니다.
중요!
다른 CA Technologies 제품에서 사용하기 위한 용도 등으로 인터페이스를 사용하는 확장을 생성하는 경우 사용자 고유의 누산기 인스턴스를 삭제해야 합니다. 호출된 적이 없는 메트릭은 만료 처리될 수 있습니다. 나중에 해당 메트릭의 데이터를 사용할 수 있게 되어도 이전 누산기 인스턴스가 새 메트릭 데이터 포인트를 생성하지 않습니다. 이러한 상황을 방지하려면 사용자 고유의 누산기 인스턴스를 삭제하지 말고 대신MetricRecordingAdministrator
인스턴스를 사용하십시오.getDataAccumulatorFactory
에이전트 메트릭 만료 처리 구성
에이전트 메트릭 만료 처리는 기본적으로 사용됩니다. 속성을 사용하여 이 기능을 해제할 수 있습니다. 이 속성을 IntroscopeAgent.profile에서 제거하면 에이전트 메트릭 만료 처리가 기본적으로 해제됩니다.
에이전트 메트릭 만료 처리는 에이전트의 하트비트에 실행됩니다. 하트비트는 속성을 사용하여 구성됩니다. 하트비트 빈도를 낮게 유지해야 합니다. 하트비트가 높으면 에이전트와 Introscope의 성능에 영향을 미칩니다.
각 하트비트 동안 에이전트 메트릭 만료 처리 기능은 메트릭 집합을 확인합니다. 속성을 사용하여 이 집합을 구성할 수 있습니다. 이 값이 높으면 성능에 영향을 줄 수 있으므로 이 값을 낮게 유지하십시오. 기본값을 사용할 경우 하트비트당 500개 메트릭이 확인됩니다. 메트릭 500개 각각을 확인하여 제거 후보에 해당하는지 확인합니다. 예를 들어 이 속성을 하트비트당 메트릭 500개 단위의 청크를 확인하도록 설정한다고 가정합니다. 에이전트 메모리의 메트릭은 총 10,000개입니다. 값을 500개 메트릭으로 설정하면 에이전트가 메트릭 10,000개를 모두 확인하는 과정 중 일부 시간에는 성능 저하가 발생합니다. 그러나 introscope.agent.metricAging.dataChunk 속성을 더 높은 값으로 설정하면 에이전트가 10,000개의 메트릭 모두를 보다 빨리 확인하는 반면 오버헤드가 높아질 수 있습니다.
메트릭에 새 데이터가 수신되지 않은 채 일정 시간이 지나면 해당 메트릭은 제거 후보가 됩니다. 이 시간은 속성을 사용하여 구성할 수 있습니다. 이 속성은 기본적으로 180000으로 설정됩니다. 메트릭이 제거 조건을 충족하면 검사가 수행됩니다. 에이전트 메트릭은 해당 그룹의 모든 메트릭이 메트릭 제거 후보인지 여부를 확인합니다. 이 요구 사항도 충족하면 메트릭이 제거됩니다.
introscope.agent.metricAging.turnOn
에이전트 메트릭 만료 처리를 설정하거나 해제합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.metricAging.turnOn=true참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.metricAging.heartbeatInterval
이 속성은 제거할 메트릭을 확인하는 시간 간격을 초 단위로 지정합니다.
기본값:
86400예:
introscope.agent.metricAging.heartbeatInterval=86400참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.metricAging.dataChunk
이 속성은 각 간격에서 확인할 메트릭의 수를 지정합니다.
기본값:
500예:
introscope.agent.metricAging.dataChunk=500참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.metricAging.numberTimeslices
이 속성은 데이터를 제거 대상으로 만들기 전에 새 데이터가 없는지 확인하는 간격의 수를 지정합니다.
기본값:
180000예:
introscope.agent.metricAging.numberTimeslices=180000참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.metricAging.metricExclude.ignore.0
이 속성은 지정된 메트릭을 제거하지 않도록 제외합니다. 만료 처리에서 하나 이상의 메트릭을 제외하려면 목록에 메트릭 이름이나 메트릭 필터를 추가합니다.
값:
쉼표로 구분된 메트릭 목록. 메트릭 이름에서 별표(*)를 와일드카드로 사용할 수 있습니다.기본값:
Threads로 시작하는 메트릭 이름(Threads*
예:
introscope.agent.metricAging.metricExclude.ignore.0=Threads*참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.에이전트 메트릭 클램프 속성
introscope.agent.metricClamp
이 속성은 에이전트가 Enterprise Manager로 전송되는 메트릭의 수를 대략적으로 클램프하도록 구성합니다. 생성된 메트릭의 수가 속성 값을 초과하면 에이전트는 새 메트릭의 수집 및 전송을 중지합니다. 기존 메트릭은 계속해서 값을 보고합니다.
기본값:
5000예:
introscope.agent.metricClamp=5000
참고:
- 이 속성을 설정하지 않으면 기본적으로 에이전트는 메트릭 수를 최대값인 50000개로 클램프합니다. 에이전트는 새 메트릭을 보고하지 않지만 기존 메트릭은 계속해서 보고합니다.
- 값이 1000보다 크거나 같아야 적용됩니다.
- 이 클램프 속성은 apm-events-thresholds-config.xml 파일에 있는introscope.enterprisemanager.agent.metrics.limit속성과 함께 작동합니다.introscope.enterprisemanager.agent.metrics.limit클램프 값이introscope.agent.metricClamp값보다 먼저 트리거되는 경우 Enterprise Manager는 에이전트 메트릭을 읽습니다. 하지만 Enterprise Manager가 Investigator 메트릭 브라우저 트리에서 해당 메트릭을 보고하지는 않습니다.introscope.agent.metricClamp클램프 값이introscope.enterprisemanager.agent.metrics.limit클램프 값보다 먼저 트리거되면 에이전트에서 Enterprise Manager로의 메트릭 전송이 중지됩니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
에이전트 이름 지정 속성
응용 프로그램 서버에 대한 Java 에이전트 이름을 가져오도록 속성을 구성할 수 있습니다.
introscope.agent.agentAutoNamingEnabled
이 속성은 지원되는 응용 프로그램 서버에 대해 Java 에이전트 이름을 지정할 때 에이전트 자동 이름 지정을 사용할지 여부를 지정합니다.
값:
true 또는 false기본값:
응용 프로그램 서버에 따라 달라집니다.예:
introscope.agent.agentAutoNamingEnabled=false참고:
- WebLogic 및 WebSphere에서는 기본적으로 에이전트 자동 이름 지정 기능이 사용되도록 설정되어 있습니다.
- WebLogic의 경우 이 속성을 사용하려면 시작 클래스를 지정해야 합니다.
- WebSphere의 경우 이 속성을 사용하려면 사용자 지정 서비스를 지정해야 합니다.
- Interstage 및 Tomcat 응용 프로그램 서버에서는 에이전트 자동 이름 지정이 사용되지 않도록 설정되어 있습니다.
- JBoss에 대해 자동 이름 지정을 사용하도록 설정할 수 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.agentAutoNamingMaximumConnectionDelayInSeconds
이 속성은 Enterprise Manager에 연결하기 전에 에이전트가 이름 지정 정보를 기다리는 시간(초)을 지정합니다.
기본값:
120예:
introscope.agent.agentAutoNamingMaximumConnectionDelayInSeconds=120참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.agentAutoRenamingIntervalInMinutes
이 속성은 에이전트가 이름이 변경되었는지 확인하기 전에 대기하는 시간(분)을 지정합니다.
기본값:
10(분)예:
introscope.agent.agentAutoRenamingIntervalInMinutes=10참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.agentName
이 속성은 다른 에이전트 이름 지정 방법이 실패할 경우 기본 에이전트 이름을 제공합니다.
값:
모든 설치에서 이 속성의 값이 잘못되었거나 이 속성이 프로필에서 삭제된 경우 에이전트 이름은 UnnamedAgent가 됩니다.예:
#introscope.agent.agentName=AgentName참고:
- 응용 프로그램 서버 관련 에이전트 설치 관리자와 함께 제공된 InstroscopeAgent.profile에서 기본값은 응용 프로그램 서버를 반영합니다. 예:WebLogic Agent.
- 기본 에이전트 설치 관리자와 함께 제공된 IntroscopeAgent.profile에서 해당 속성 값은AgentName입니다. 이 행은 주석 처리되어 있습니다.
- 다른 에이전트 이름 지정 방법이 실패하는 경우 기본 에이전트 이름을 제공하도록 이 속성의 주석 처리를 제거하십시오.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.autoprobe.directivesFile
참고:
CA CEM은 온-프레미스 CA APM에만 사용할 수 있습니다.introscope.autoprobe.directivesFile
속성 구성을 통해 ServletHeaderDecorator
/ HTTPHeaderDecorator
및 CEMTracer
를 사용하도록 설정하십시오.지시문 파일 속성은 AutoProbe용 지시문 파일(PBD) 또는 지시문 목록(PBL)을 찾을 위치를 지정합니다.
AutoProbe는 응용 프로그램을 활성화하고 에이전트가 Enterprise Manager에 보고하는 메트릭을 결정하기 위해 지시문을 사용합니다.
설정
이 설정은 설치된 에이전트 응용 프로그램 서버에 따라 다르며, 형식은 또는 입니다.
<appserver>
-full.pbl<appserver>
-typical.pbl기본값
default-typical.pbl
예:
introscope.autoprobe.directivesFile=weblogic-typical.pbl
참고
단순히 이 속성 목록의 끝에
ServletHeaderDecorator.pbd
또는 httpheaderdecorator.pbd
를 추가해도 되지만 다음 절차를 수행하는 것이 더 좋습니다.- 속성에 지정된 PBL 파일을 찾습니다.예를 들어introscope.autoprobe.directivesFile=weblogic-typical.pbl에서 지정된 pbl은weblogic-typical.pb입니다.
- PBL 파일을 텍스트 편집기에서 엽니다.
- Java 에이전트의 경우 ServletHeaderDecorator.pbd 행의 주석 처리를 제거하여 이 행을 활성화합니다.
- .NET 에이전트의 경우 httpheaderdecorator.pbd 행의 주석 처리를 제거하여 이 행을 활성화합니다.
- PBL 파일의 변경 사항을 저장합니다.
introscope.agent.agentNameSystemPropertyKey
이 속성은 Java 시스템 속성 값을 사용하여 에이전트 이름을 지정합니다.
기본값:
지정되지 않음예:
introscope.agent.agentNameSystemPropertyKey참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.disableLogFileAutoNaming
이 속성은 자동 이름 지정 옵션을 사용할 때 에이전트 로그 파일의 자동 이름 지정을 사용하지 않도록 설정할지 여부를 지정합니다.
이 속성을
true
로 설정하면 에이전트, AutoProbe 및 LeakHunter에 대한 로그 파일의 이름이 에이전트 이름 또는 타임스탬프를 사용해 자동 지정되지 않도록 설정됩니다.값:
true 또는 false기본값:
false예:
introscope.agent.disableLogFileAutoNaming=false참고:
- 로그 파일 자동 이름 지정은 두 가지 경우에만 적용됩니다. Java 시스템 속성 또는 응용 프로그램 서버 사용자 지정 서비스를 사용하여 에이전트 이름을 확인할 수 있는 경우가 이에 해당합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.clonedAgent
이 속성은 동일한 컴퓨터에서 응용 프로그램의 동일한 복사본을 실행할 수 있도록 합니다. 동일한 컴퓨터에서 응용 프로그램의 동일한 복사본이 실행 중인 경우에는 이 속성을
true
로 설정하십시오.값:
true 또는 false기본값:
false예:
introscope.agent.clonedAgent=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.customProcessName
이 속성은 Enterprise Manager와 Workstation에 표시할 프로세스 이름을 지정합니다.
기본값:
응용 프로그램 서버에 따라 달라집니다.예:
introscope.agent.customProcessName=CustomProcessName참고:
- 응용 프로그램 서버 관련 에이전트 설치 관리자와 함께 제공된 에이전트 프로필에서 기본값은 응용 프로그램 서버를 반영합니다. 예:WebLogic.
- 기본 에이전트 설치 관리자와 함께 제공된 에이전트 프로필에서 이 속성은 주석 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.defaultProcessName
이 속성은 두 조건이 충족될 때 프로세스 이름에 사용되는 값을 지정합니다. 사용자 지정 프로세스 이름이 제공되지 않았거나 에이전트가 기본 응용 프로그램 클래스 이름을 확인할 수 없는 경우가 두 조건에 해당합니다.
기본값:
UnknownProcess예:
introscope.agent.defaultProcessName=UnknownProcess참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.display.hostName.as.fqdn
이 속성은 에이전트 이름이 FQDN(정규화된 도메인 이름)으로 표시되는지 여부를 지정합니다. FQDN을 사용하도록 설정하려면 이 속성 값을
true
로 설정하십시오. 기본적으로 에이전트는 호스트 이름을 표시합니다.값:
true 또는 false기본값:
false예:
introscope.agent.display.hostName.as.fqdn=false참고:
- Catalyst가 통합된 경우 이 속성을 true로 설정하십시오.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
에이전트 기록(비즈니스 기록) 속성
에이전트에서 비즈니스 트랜잭션 기록을 처리하는 방식을 제어할 수 있습니다.
introscope.agent.bizRecording.enabled
이 속성은 에이전트의 비즈니스 트랜잭션 기록을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.bizRecording.enabled=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.에이전트 스레드 우선 순위 속성
이 단원의 속성은 에이전트 스레드의 우선 순위를 제어합니다.
introscope.agent.thread.all.priority
이 속성은 에이전트 스레드의 우선 순위를 제어합니다.
값:
1(낮음) - 10(높음)기본값:
5예:
introscope.agent.thread.all.priority=5참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
응용 프로그램 이름 지정 속성
이 섹션의 속성은 Team Center 및 Investigator 메트릭 브라우저 트리에 표시되는 Java 응용 프로그램의 이름을 구성합니다.
introscope.agent.application.name
이 속성을 사용하면 이 에이전트에 연결된 모든 Java 응용 프로그램에 대해 하나의 사용자 지정 이름을 설정할 수 있습니다. 이 사용자 지정 이름은 기본 Java 응용 프로그램 이름 대신 표시됩니다.
이 속성 값이 지정되지 않은 경우에는 개별 응용 프로그램 이름이 Team Center 및 메트릭 브라우저 트리의 개별 노드 이름으로 표시됩니다. 예를 들어 에이전트가 서로 다른 여러 응용 프로그램을 모니터링한다고 가정합니다. 에이전트는 각 응용 프로그램에 대한 메트릭을 "Frontends"(프런트엔드) 노드 아래의 개별 노드로 보고합니다.
이 속성의 주석 처리가 제거되고 값이 지정된 경우에는 개별 응용 프로그램 이름이 함께 묶입니다. 해당 이름은 Team Center 및 메트릭 브라우저 트리에서 하나의 사용자 지정 노드 이름으로 표시됩니다. 예를 들어
introscope.agent.application.name=Application 1
을 설정한다고 가정합니다. 서로 다른 여러 응용 프로그램을 모니터링하는 에이전트는 각 응용 프로그램에 대한 메트릭을 Frontends | Application 1 | URLs 아래에 보고합니다.값
: 영숫자 문자열. 와일드카드는 허용되지 않습니다.기본값:
이 속성에는 기본 설정이 없습니다.예:
introscope.agent.application.name=Application 1참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
응용 프로그램 심사 맵 속성
에이전트 및 응용 프로그램 심사 맵 데이터를 위한 비즈니스 트랜잭션 기록을 구성할 수 있습니다.
introscope.agent.appmap.enabled
이 속성은 응용 프로그램 심사 맵의 모니터링 대상 코드 추적을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.appmap.enabled=trueintroscope.agent.appmap.metrics.enabled
이 속성은 응용 프로그램 심사 맵 노드의 메트릭 추적을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.appmap.metrics.enabled=false참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.agent.appmap.queue.size
이 속성은 응용 프로그램 심사 맵의 버퍼 크기를 지정합니다.
값:
양의 정수기본값:
1000예:
introscope.agent.appmap.queue.size=1000참고:
- 값을 0으로 설정하면 버퍼에 제한이 없습니다.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
introscope.agent.appmap.queue.period
이 속성은 응용 프로그램 심사 맵 데이터를 Enterprise Manager로 보내는 빈도(밀리초)를 지정합니다.
값:
양의 정수기본값:
1000(밀리초)예:
introscope.agent.appmap.queue.period=1000참고:
- 값이 0으로 설정되면 기본값이 사용됩니다.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
introscope.agent.appmap.intermediateNodes.enabled
이 속성은 응용 프로그램의 프런트엔드 노드와 백엔드 노드 사이에 중간 노드를 포함하는 기능을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
false예:
#introscope.agent.appmap.intermediateNodes.enabled=true참고:
- 이 속성을 true로 설정하면 에이전트 성능이 저하될 수 있습니다.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.appmap.catalystIntegration.enabled
이 속성은 Catalyst와의 통합을 위해 에이전트에서 추가 정보를 보내는 기능을 사용하거나 사용하지 않도록 설정합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.appmap.catalystIntegration.enabled=false
참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.agent.primary.net.interface.name
이 속성은 에이전트가 Catalyst 통합을 위해 사용하는 호스트 컴퓨터의 기본 네트워크 인터페이스 이름을 지정합니다.
에이전트 로깅 수준이
DEBUG
로 설정된 경우 구성에 사용할 수 있는 네트워크 인터페이스 이름에 대한 정보가 로그 파일에 나타납니다. 또는 이 속성에 대해 기본 네트워크 인터페이스 이름을 결정하기 위해 네트워크 인터페이스 유틸리티를 사용할 수 있습니다.(선택 사항) 하위 인터페이스 번호(0부터 시작)를 지정하여 여러 네트워크 주소를 허용할 수 있습니다.
기본값:
정의되지 않음. 이 속성이 설정되지 않은 경우 에이전트는 첫 번째 사용 가능한 네트워크 인터페이스를 기본 인터페이스로 지정합니다. 이 속성의 이름 값을 결정하기 위해 네트워크 인터페이스 유틸리티를 사용할 수 있습니다.예:
introscope.agent.primary.net.interface.name=eth4
다음 예는 하위 인터페이스 번호 형식을 나타냅니다.
introscope.agent.primary.net.interface.name=eth4.1
참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
응용 프로그램 심사 맵 비즈니스 트랜잭션 POST 매개 변수 속성
introscope.agent.bizdef.matchPost
POST 매개 변수와 대조하여 보다 복잡한 모니터링을 수행할 수 있도록 Local Product Shorts를 구성할 수 있습니다. 이 속성은 POST 매개 변수와 일치되는 시기를 결정합니다.
참고:
이 속성을 구성하기 전에 에이전트 기록이 작동하는 방식을 숙지하십시오.값:
이 속성의 유효한 설정은 never
, before
after
입니다.- NeverPOST 매개 변수를 매칭하지 않습니다. 이 옵션은 가장 빠르지만 비즈니스 트랜잭션 구성 요소 매칭이 부정확하게 될 수 있습니다.에이전트 기능을 모두 사용하고 성능을 향상시키려는 경우에는 이 속성을never로 설정하십시오. 이 설정을 사용하면 응용 프로그램이 URL, 쿠키 또는 헤더 매개 변수를 사용하여 모든 비즈니스 트랜잭션을 식별할 수 있지만, POST 매개 변수를 통해서만 식별되는 비즈니스 트랜잭션은 매칭할 수 없습니다.
- Before이 옵션은 서블릿이 실행되기 전에 POST 매개 변수를 매칭합니다.최대의 에이전트 성능을 얻으려면 이 속성을 before로 설정하십시오. 이 설정을 사용하면 응용 프로그램에서 POST 매개 변수를 사용하여 일부 또는 모든 비즈니스 트랜잭션을 식별할 수 있습니다. 하지만 응용 프로그램에서 HTTP 양식 요청을 위해 서블릿 스트림에 직접 액세스할 수는 없습니다. 이 속성이 before로 설정되어 있으면 새로 배포되는 응용 프로그램도 표준 API를 따라야 합니다.
중요!
이 속성을 before
로 설정하면 응용 프로그램에 악영향을 줄 수도 있습니다. 구현 전에 CA Technologies 담당자와 함께 이 속성 설정을 검토하십시오.- After이 옵션은 서블릿이 실행된 후에 POST 매개 변수 패턴을 매칭합니다. "after"로 설정하면 크로스 프로세스 매핑과 일부 메트릭은 사용할 수 없습니다. 이 값이 기본 설정입니다.비즈니스 트랜잭션을 POST 매개 변수와 안전하게 매칭하되 에이전트 기능을 제한하려면 이 속성을after로 설정하십시오. 이 속성 값이after이면 에이전트는 POST 매개 변수로 식별된 비즈니스 트랜잭션을 프로세스 간에 매핑할 수 없습니다. 또한 에이전트는 프로세스 간에 POST 매개 변수에 대한 전체 메트릭 집합을 생성할 수 없습니다. 또한 이 설정은 다른 옵션에 비해 CPU 시간을 좀 더 소비하지만, POST 매개 변수 기능이 필요한 경우에는 가장 안전한 설정으로 간주됩니다. 이 설정을 사용하면 응용 프로그램에서 POST 매개 변수를 사용하여 일부 또는 모든 비즈니스 트랜잭션을 식별할 수 있지만, 서블릿 스트림에 대한 직접 액세스를 항상 금지할 수는 없습니다.
예:
introscope.agent.bizdef.matchPost=after
알려진 제한 사항
에이전트 기록을 사용하여 정의된 메트릭이 응용 프로그램 심사 맵에 표시됩니다. 에이전트 기록을 구성할 경우 정규식 사용과 관련하여 몇 가지 알려진 제한 사항이 있습니다. 대부분의 제한 사항은 POST 매개 변수와 관련이 있습니다.
- POST 매개 변수 값에는 행 마침 표시(.)를 사용할 수 없습니다.
- POST 매개 변수 정의가 비즈니스 트랜잭션 정의에 종속된 경우 비즈니스 트랜잭션 구성 요소에 세 가지 메트릭만 제공됩니다. 해당 메트릭은 다음과 같습니다.
- Average Response Time(평균 응답 시간)
- Responses Per Interval(간격당 응답 수)
- Errors Per Interval(간격당 오류 수)
- POST 매개 변수 정의가 비즈니스 트랜잭션 정의에 종속된 경우 트랜잭션 추적 구성 요소의 비즈니스 구성 요소 이름은 비즈니스 서비스, 비즈니스 트랜잭션 및 비즈니스 트랜잭션 구성 요소의 특정 이름이 아니라 일반 이름입니다. 이 내용은 매칭되지 않는 POST 매개 변수 정의에 종속된 비즈니스 트랜잭션 정의에도 적용됩니다.
응용 프로그램 심사 맵에서 관리되는 소켓 구성 속성
이 단원의 속성을 사용하여 응용 프로그램 심사 맵에 소켓 메트릭이 표시되거나 표시되지 않도록 설정할 수 있습니다.
introscope.agent.sockets.managed.reportToAppmap
이 속성은 응용 프로그램 심사 맵에 관리되는 소켓이 표시되도록 합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.sockets.managed.reportToAppmap=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.sockets.managed.reportClassAppEdge
이 속성은 관리되는 소켓이 클래스 수준 응용 프로그램 가장자리를 응용 프로그램 심사 맵에 보고하도록 합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.sockets.managed.reportClassAppEdge=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.sockets.managed.reportMethodAppEdge
이 속성은 관리되는 소켓이 메서드 수준 응용 프로그램 가장자리를 응용 프로그램 심사 맵에 보고하도록 합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.sockets.managed.reportMethodAppEdge=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.sockets.managed.reportClassBTEdge
이 속성은 관리되는 소켓이 응용 프로그램 심사 맵에 클래스 수준 비즈니스 트랜잭션 가장자리를 보고하도록 합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.sockets.managed.reportClassBTEdge=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.sockets.managed.reportMethodBTEdge
이 속성은 관리되는 소켓이 응용 프로그램 심사 맵에 메서드 수준 비즈니스 트랜잭션 가장자리를 보고하도록 합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.sockets.managed.reportMethodBTEdge=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.AutoProbe 속성
introscope.autoprobe.constructor.policy
생성자 계측 제한으로 인해 일부 JVM에서 바이트 코드 확인 오류가 발생할 수 있습니다. 생성자 계측 정책을 사용하면 제한 사항을 고려하면서 생성자 트랜잭션에 대한 가시성을 가능한 한 높일 수 있습니다.
값:
- Full전체 계측은 생성자 메서드의 전체 타이밍을 제공하며 throw된 모든 예외를 catch합니다. 하지만 이 설정을 사용하면 일부 응용 프로그램 및 JVM에서 클래스 확인 오류가 발생할 수 있습니다. 이 설정을 사용할 경우super() constructor메서드 호출과 나머지 생성자 본문에 대해 각각 하나씩, 두 개의 try/catch 블록이 생성됩니다.
- Partial이 설정을 사용할 경우 나머지 생성자 본문에 대해 하나의 try/catch 블록이 생성됩니다. 따라서 Java 에이전트는super() constructor메서드 호출의 타이밍을 보고하지 않습니다.super() constructor메서드 호출에서 예외가 throw되더라도 Java 에이전트는 생성자가 호출되었음을 알지 못하므로 오류를 보고할 수 없습니다.
- 없음Java 에이전트가 생성자 메서드를 계측할 수 없습니다.
기본값
: Partial예:
introscope.autoprobe.constructor.policy=Partial참고:
- 이 속성은 introscopeagent.profile 파일에 포함되어 있지 않습니다. 변경하려면 introscopeagent.profile에 이 속성을 추가하십시오.
- 이 속성 값은 대/소문자를 구분합니다. 첫 번째 문자는 대문자이고 나머지 문자는 소문자여야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.autoprobe.directivesFile
이 속성은 AutoProbe용 ProbeBuilder 지시문 파일을 지정합니다.
기본값:
설치 관리자에 따라 다릅니다.참고:
이 속성에 디렉터리가 하나 이상 포함되어 있고 동적 ProbeBuilding이 사용되도록 설정되어 있는 경우, 응용 프로그램을 다시 시작하지 않아도 에이전트가 지정된 디렉터리에서 지시문 파일을 로드합니다.introscope.autoprobe.enable
이 속성은 프로브를 바이트 코드에 자동으로 삽입하는 기능을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.autoprobe.enable=true참고:
- 이 속성을 false로 설정하면 프로브를 응용 프로그램 바이트 코드에 자동으로 삽입하는 기능만 해제되고 에이전트 또는 에이전트 보고 기능은 해제되지 않습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.autoprobe.logfile
이 속성은 로그 파일의 위치를 기본 위치가 아닌 다른 위치로 이동할지 여부를 지정합니다.
값:
절대 파일 경로 또는 절대 경로가 아닌 경로. 절대 이름이 아닌 이름은 이 속성 파일의 위치를 기준으로 확인됩니다.기본값:
../../logs/AutoProbe.log예:
introscope.autoprobe.logfile=../../logs/AutoProbe.log로깅을 사용하지 않도록 설정하려면 로그 파일에서 다음과 같이 주석 처리하십시오.
introscope.autoprobe.logfile=logs/AutoProbe.log
JVM 매개 변수를 설정하여 AutoProbe 로그를 대략적인 크기로 제한할 수 있습니다. 이 속성이 설정된 경우 AutoProbe 로그는 현재 로그 크기를 이 시스템 속성과 비교합니다. 현재 로그 크기가 속성 값보다 크면 AutoProbe 로깅이 중지됩니다. 따라서 AutoProbe 로그 파일 크기는 지정된 값보다 클 수 있습니다.
-javaagent
속성과 동일한 위치에서 모니터링되는 응용 프로그램의 Java 매개 변수에 이 속성을 추가하십시오.-Dcom.wily.autoprobe.logSizeInKB=
이 예에서는 AutoProbe 로그 파일 크기를 약 1 MB(1024 KB)로 제한하는 방법을 보여 줍니다.
-Dcom.wily.autoprobe.logSizeInKB=1024
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.Command Center 속성
introscope.agent.acc.enable
이 속성은 Agent Controller에 대한 연결을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.acc.enable=true참고:
이 속성은 IntroscopeAgent.profile 파일에 포함되어 있지 않습니다. CA APM Command Center가 에이전트를 관리하도록 하려면 이 속성을 추가하십시오.세부 수준 상속 설정
세부 수준 상속 속성을 사용하는 가장 일반적인 기능은 EJB와 서블릿 요청 추적입니다. 예를 들어 WebLogic은 자체적인
ServletRequest
구현을 사용하며, 세부 수준 상속이 비활성화된 경우 이 구현은 인식되지 않습니다. EJB는 직접 SessionBean
및 EJBObject
를 구현하는 경우에만 동작하며, 이 구현은 웹 서버 버전 및 구현 유형에 따라 차이가 있습니다. 이 규칙은 또한 세부 수준 상속 속성을 적용하는 확장 및 기타 사용자 지정 PBD에 적용됩니다.PBD 예:
apm-common.pbdIdentifyDeepInheritedAs: javax.servlet.ServletRequest ServletRequestClassIdentifyDeepInheritedAs: javax.servlet.http.HttpServletRequest ServletRequestClassj2ee.pbdIdentifyDeepInheritedAs: javax.ejb.SessionBean SessionBeanTracingIdentifyDeepInheritedAs: javax.ejb.EntityBean EntityBeanTracingIdentifyDeepInheritedAs: javax.ejb.MessageDrivenBean MessageDrivenBeanTracingIdentifyDeepInheritedAs: javax.ejb.EJBObject EJB2StubTracingHTTP_Tracer_For_SYSVIEW.pbdIdentifyDeepInheritedAs: java.net.URLConnection URLConnectionCorrelationTracingIdentifyDeepInheritedAs: javax.servlet.http.HttpServlet HttpServletCorrelationTracing
introscope.autoprobe.deepinheritance.enabled
이 속성은 PBD 지시문을 통해 세부 수준 상속 계측을 활성화합니다.
이 속성이 false로 설정되면 세부 수준 상속 지시문이 간략한 수준 상속으로서 동작합니다. 즉, 바로 위의 슈퍼클래스 인터페이스를 벗어난 상속 관계는 인식되지 않습니다.
값
: true 또는 false기본값
: true속성 예
: introscope.autoprobe.deepinheritance.enabled=false참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.autoprobe.deepinheritance.auto.turnoff.enable
세부 수준 상속 속성을 사용하도록 설정하는 경우 이 속성이 적용됩니다. 이 속성은 세부 수준 상속에 너무 오랜 시간이 걸리는 경우 이를 자동으로 해제할지 여부를 제어합니다.
- 이 속성이 true로 설정되면 세부 수준 상속에 너무 오랜 시간이 걸릴 경우 상속이 자동으로 종료됩니다.
- 이 속성이 false로 설정되면 세부 수준 상속이 자동으로 종료되지 않고 계속됩니다.
값
: true 또는 false기본값
: true속성 예
: introscope.autoprobe.deepinheritance.auto.turnoff.enable=true참고
: 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.autoprobe.deepinheritance.auto.turnoff.requests.per.interval
세부 수준 상속 자동 해제 속성을 사용하도록 설정하는 경우 이 속성이 적용됩니다. 이 속성은 확인 간격에서 요청의 수를 지정합니다.
값
: 숫자기본값
: 100속성 예
: introscope.autoprobe.deepinheritance.auto.turnoff.requests.per.interval=100참고
: 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.autoprobe.deepinheritance.auto.turnoff.maxtime.per.interval
세부 수준 상속 자동 해제 속성을 사용하도록 설정하는 경우 이 매개 변수가 적용됩니다. 이 속성은 확인 간격에 허용되는 최대 시간(밀리초)을 지정합니다.
값
: 숫자기본값
: 12000속성 예
: introscope.autoprobe.deepinheritance.auto.turnoff.maxtime.per.interval=12000참고
: 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.autoprobe.deepinheritance.auto.turnoff.maxtime.total
세부 수준 상속 자동 해제 속성을 사용하도록 설정하는 경우 이 속성이 적용됩니다. 이 속성은 응용 프로그램 시작 후 세부 수준 상속이 소비할 수 있는 총 최대 시간을 지정합니다. 응용 프로그램이 지정된 값을 초과하면 세부 수준 상속이 사용되지 않게 됩니다.
값
: 숫자기본값
: 120000속성 예
: introscope.autoprobe.deepinheritance.auto.turnoff.maxtime.total=120000참고
: 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.Bootstrap Classes Instrumentation Manager 속성
이 단원의 속성은 Bootstrap Classes Instrumentation Manager를 구성합니다.
Bootstrap Classes Instrumentation Manager는 에이전트 부트스트랩 이후에 일련의 클래스를 계측합니다. 이 계측 기능은 에이전트 성능을 향상시키고, Java NIO 및 SSL(Secure Sockets Layer)을 위한 추적 프로그램을 간편하게 구현할 수 있게 해 줍니다. 이 기능을 사용하지 않도록 설정하려면
IntroscopeAgent.profile
에서 이 속성을 주석으로 처리하십시오.introscope.bootstrapClassesManager.enabled
이 속성은 Bootstrap Manager를 활성화 또는 비활성화합니다. false로 설정되면 시스템 클래스가 계측되지 않습니다.
값:
true 또는 false기본값:
false예:
introscope.bootstrapClassesManager.enabled=true참고:
- 이 속성은 Java 1.5 이상을 실행하는 JVM에서만 동작합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.bootstrapClassesManager.waitAtStartup
시작 후 에이전트가 부트스트랩 클래스를 계측할 때까지 기다리는 시간(초)을 설정합니다.
기본값: <password>
- Interstage, WebLogic, WebSphere Application Server에서 사용하는 경우 240초입니다.
- JBoss, Sun, Tomcat에서 사용하는 경우 5초입니다.
예:
introscope.bootstrapClassesManager.waitAtStartup=5참고:
- 이 속성은 Java 1.5 이상을 실행하는 JVM에서만 동작합니다.
- 이 속성이 활성화되면 건너뛰도록 지정된 클래스에 대해 이 속성이 우선합니다. 건너뛴 클래스가 계속 계측되는 경우 CA Technologies 담당자나 CA Support에 문의하십시오.
CA CEM 에이전트 프로필 속성
<에이전트 홈>
디렉터리에 있는 CA CEM 관련 IntroscopeAgent.profile(에이전트 프로필이라고도 함) 속성 파일을 구성할 수 있습니다. CA CEM과 Introscope는 함께 작동하도록 미리 구성되어 있습니다.
참고:
CA CEM은 온-프레미스 CA APM에만 사용할 수 있습니다.introscope.agent.remoteagentconfiguration.allowedFiles
이 속성은 임의의 컴퓨터에서 에이전트 디렉터리로 원격 복사가 허용되는 파일을 식별합니다.
Enterprise Manager는 이 속성의 파일 이름을 사용하여 에이전트로 보낼 유효한 CA CEM 도메인 구성 파일을 식별합니다. 도메인 구성 파일은 CA CEM 비즈니스 서비스와 트랜잭션 정의를 포함하고 있습니다.
설정
올바른 파일 이름을 사용하십시오.
기본값
domainconfig.xml
예:
introscope.agent.remoteagentconfiguration.allowedFiles=domainconfig.xml
참고:
이 속성은 명령줄 Workstation의
Send Config File
명령에도 적용됩니다.이 속성은 CA CEM 릴리스에 대해 유효합니다.
introscope.agent.remoteagentconfiguration.enabled
이 부울 값이
true
로 설정되면 다른 컴퓨터에서 에이전트로 원격 파일 복사를 허용할 수 있습니다.Enterprise Manager가 CA CEM 도메인 구성 파일을 에이전트에 보내려면 이 속성을
true
로 설정해야 합니다. 도메인 구성 파일은 CA CEM 비즈니스 서비스와 트랜잭션 정의를 포함하고 있습니다.설정
참 또는 거짓
기본값
- Java 에이전트의 경우 true
- .NET 에이전트의 경우 false
예:
introscope.agent.remoteagentconfiguration.enabled=true
참고
원격 사용자는 또한 Introscope CLW(명령줄 Workstation)의
Send Config File
명령을 사용하여 구성 파일을 에이전트 디렉터리로 복사할 수 있습니다. 해당 파일은 introscope.agent.remoteagentconfiguration.allowedFiles
속성으로 지정합니다.호환되지 않는 에이전트는 지원되지 않는 .NET 에이전트, EPA 에이전트 또는 그 밖의 Java가 아닌 에이전트입니다. 에이전트가 호환되지 않는 경우에는 introscope.agent.remoteagentconfiguration.enabled를
false
로 설정하십시오.introscope.agent.decorator.enabled
이 부울 값이 true로 설정되어 있으면 에이전트가 HTTP 응답 헤더에 추가적인 성능 모니터링 정보를 추가하도록 구성됩니다. ServletHeaderDecorator/HTTPHeaderDecorator는 각 트랜잭션에 GUID를 연결하고 이 GUID를 HTTP 헤더
x-apm-info
에 삽입합니다.이 속성은 CA CEM과 Introscope 간의 트랜잭션 상관 관계를 활성화합니다.
설정:
true 또는 false기본값
- Java 에이전트의 경우 false
- .NET 에이전트의 경우 false
참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.예:
introscope.agent.decorator.enabled=false
introscope.agent.decorator.security
이 속성에 따라 CA CEM으로 전송되는 데코레이트된 HTTP 응답 헤더의 형식이 결정됩니다.
설정:
- Clear일반 텍스트 인코딩
- Encrypted헤더 데이터가 암호화됩니다.
기본값:
Encrypted예:
introscope.agent.decorator.security=encrypted
참고:
지원되는 버전은 제품 호환성 표를 참조하십시오.ChangeDetector 구성 속성
로컬 에이전트가 ChangeDetector와 함께 작동하는 방식을 제어할 수 있습니다.
introscope.changeDetector.enable
이 속성은 ChangeDetector의 활성화 여부를 지정합니다. ChangeDetector가 사용되도록 설정하려면 이 속성을 true로 설정합니다.
값:
true 또는 false기본값:
False예:
introscope.changeDetector.enable=false
참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- ChangeDetector가 사용되도록 설정한 경우 ChangeDetector 관련 추가 속성을 설정하십시오.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.changeDetector.agentID
이 속성은 로컬 에이전트를 식별하기 위해 ChangeDetector가 사용하는 텍스트 문자열을 지정합니다. ChangeDetector가 사용되도록 설정할 경우 이 속성의 주석 처리를 제거하고 적절한 값으로 설정하십시오.
기본값:
SampleApplicationName
예:
introscope.changeDetector.agentID=SampleApplicationName
참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.changeDetector.rootDir
이 속성은 ChangeDetector 파일의 루트 디렉터리를 지정합니다. 루트 디렉터리는 ChangeDetector가 해당 로컬 캐시 파일을 생성하는 폴더입니다.
값:
ChangeDetector 파일의 루트 디렉터리에 대한 전체 경로를 나타내는 텍스트 문자열기본값:
기본 경로는 c:\\sw\\AppServer\\<에이전트 홈
>\\change_detector입니다.예:
introscope.changeDetector.rootDir=c:\\sw\\AppServer\\<Agent_Home>\\change_detector
참고:
예와 같이 백슬래시를 사용하여 백슬래시 문자를 이스케이프하십시오.introscope.changeDetector.isengardStartupWaitTimeInSec
이 속성은 에이전트가 시작된 후 ChangeDetector가 Enterprise Manager 연결을 시도하기 전에 대기하는 기간을 초 단위로 지정합니다.
기본값:
15(초)예:
introscope.changeDetector.isengardStartupWaitTimeInSec=15
참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.changeDetector.waitTimeBetweenReconnectInSec
이 속성은 Enterprise Manager 연결을 다시 시도하기 전에 ChangeDetector가 대기하는 기간을 초 단위로 지정합니다.
기본값:
10(초)예:
introscope.changeDetector.waitTimeBetweenReconnectInSec=10
참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.changeDetector.profile
이 속성은 ChangeDetector 데이터 원본 구성 파일의 절대 또는 상대 경로를 지정합니다.
기본값:
ChangeDetector-config.xml예:
introscope.changeDetector.profile=CDConfig\\ChangeDetector-config.xml
참고:
- 예에서처럼 백슬래시를 사용하여 백슬래시 문자를 이스케이프하십시오.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
introscope.changeDetector.profileDir
이 속성은 데이터 원본 구성 파일이 들어 있는 디렉터리에 대한 절대 또는 상대 경로를 지정합니다. 이 속성이 설정된 경우 이 디렉터리의 모든 데이터 원본 구성 파일과 introscope.changeDetector.profile 속성으로 지정된 모든 파일이 사용됩니다.
기본값:
changeDetector_profiles예:
introscope.changeDetector.profileDir=c:\\CDconfig\\changeDetector_profiles
참고:
- 백슬래시를 사용하여 백슬래시 문자를 이스케이프 처리하십시오.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
introscope.changeDetector.compressEntries.enable
이 속성은 ChangeDetector 데이터 버퍼에 압축을 사용할 수 있는지 여부를 지정합니다. 시작 시 메모리 소비 문제가 발생할 경우 성능 향상을 위해 이 속성을
true
로 설정할 수 있습니다.값:
true 또는 false기본값:
false(에이전트 프로필에 이 속성이 설정되어 있지 않거나 주석으로 처리된 경우)예:
introscope.changeDetector.compressEntries.enable=true
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.changeDetector.compressEntries.batchSize
이 속성은
introscope.changeDetector.compressEntries.enable
속성에 설정된 압축 작업의 배치 크기를 정의합니다.기본값:
1000예:
introscope.changeDetector.compressEntries.batchSize=1000
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.스마트 계측 속성
사용 중인 환경에서 필요한 경우 스마트 계측 가시성의 깊이와 범위를 변경할 수 있습니다. 오버헤드 영향 및 모니터링 환경을 고려할 수 있습니다. 예를 들어 테스트 또는 QA 환경에서는 오버헤드를 높여 볼 수 있지만 프로덕션 환경에서는 그럴 수 없습니다.
참고
: 심층 가시성 구성 요소를 보려면 다음 속성 모두가 true로 설정되어야 합니다.- introscope.agent.deep.instrumentation.enabled
- introscope.agent.deep.trace.enabled
introscope.agent.deep.instrumentation.enabled
이 속성은 스마트 계측을 제공하기 위해 PBD 구성 없이 심층 가시성 구성 요소를 자동으로 계측하는 에이전트 기능을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.deep.instrumentation.enabled=true참고:
- introscope.agent.deep.trace.enabled 속성이 작동하려면 introscope.agent.deep.instrumentation.enabled 속성을 사용하도록 설정해야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.deep.trace.enabled
이 속성은 심층 가시성 구성 요소를 수집하고 데이터를 Enterprise Manager에 전송할 수 있는 에이전트 기능을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
True예:
introscope.agent.deep.trace.enabled=true참고:
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
- introscope.agent.deep.trace.enabled 속성이 작동하려면 introscope.agent.deep.instrumentation.enabled 속성을 사용하도록 설정해야 합니다.introscope.agent.deep.instrumentation.enabled=true및introscope.agent.deep.trace.enabled=true인 경우 에이전트는 심층 가시성 구성 요소를 자동으로 계측합니다. 또한 Introscope는 심층 가시성 구성 요소 데이터를 Enterprise Manager로 전송합니다.introscope.agent.deep.instrumentation.enabled=true 및 introscope.agent.deep.trace.enabled=false인 경우 에이전트는 심층 가시성 구성 요소를 자동으로 계측합니다. 그러나 심층 가시성 구성 요소 데이터가 Enterprise Manager로 전송되거나 표시되지 않습니다.introscope.agent.deep.instrumentation.enabled=false및introscope.agent.deep.trace.enabled=true인 경우 에이전트는 심층 가시성 구성 요소를 계측하지 않습니다. 따라서 심층 가시성 구성 요소가 검색되거나, Enterprise Manager로 전송되거나, 표시되지 않습니다.
참고:
다음 속성이 작동하기 위해서는 및introscope.agent.deep.instrumentation.enabled
가 모두 true로 설정되어야 합니다.introscope.agent.deep.trace.enabled
introscope.agent.deep.instrumentation.level
이 속성은 계측 수준을 설정합니다. 이 속성은 에이전트가 심층 가시성 메서드를 검색하기 위해 계측하는 관리되는 응용 프로그램 코드의 규모를 결정합니다.
중요!
수준을 너무 높게 설정하면 오버헤드가 발생합니다.계측 수준이 변경되면 클래스가 일괄적으로 다시 로드됩니다. 수준 변경의 기간은 클래스의 수와 배치 크기 및 간격에 따라 달라집니다. 수준 변경이 진행 중일 때 다른 변경이 수행되면 첫 번째 변경이 완료된 후 두 번째 변경이 시작됩니다. 수준 상태에 대한 현재 계측 수준 지원 가능성 메트릭을 보십시오.
값:
- Low: 가시성이 응용 프로그램 리소스에 미치는 영향을 최소화합니다.
- Medium: 응용 프로그램 리소스에 더 많은 영향을 주지만 보다 심층적인 가시성을 제공합니다.
- High: medium 및 low 설정보다 응용 프로그램 리소스에 더 많은 영향을 주지만 최대한의 가시성을 제공합니다.
기본값:
low예:
introscope.agent.deep.instrumentation.level=low참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.instrumentation.level.batch.size
중요!
배치 크기 기본값은 일반적인 프로덕션 환경에 최적화되어 있습니다. 기본값보다 큰 값은 트랜잭션 부하가 높은 환경에서 성능 오버헤드를 증가시킬 수 있습니다.introscope.agent.deep.instrumentation.level 속성이 변경되면 클래스가 일괄적으로 다시 로드됩니다. 이 속성은 배치당 다시 로드되는 클래스의 수를 지정합니다.
값:
0보다 큰 정수 0보다 작거나 같은 경우 기본값으로 자동 재설정됩니다.기본값:
5예:
introscope.agent.deep.instrumentation.level.batch.size=5참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.instrumentation.level.batch.interval
introscope.agent.deep.instrumentation.level 속성이 변경되면 클래스가 일괄적으로 다시 로드됩니다. 이 속성은 배치 간 시간 간격(분)을 지정합니다.
값:
1보다 크거나 같은 정수 1보다 작은 경우 기본값으로 자동 재설정됩니다.기본값:
2예:
introscope.agent.deep.instrumentation.level.batch.interval=2참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.errorsnapshot.enable
이 속성은 오류 스냅숏에서 심층 가시성 구성 요소의 표시를 활성화하거나 비활성화합니다. 라이브 오류 뷰어 및 기록 이벤트 뷰어의 스택 뷰에서 상세한 오류 스냅숏 정보를 표시합니다.
값:
true 또는 false기본값:
True예
: introscope.agent.deep.errorsnapshot.enable=true참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.stallsnapshot.enabled
이 속성은 오류 스냅숏에서 지체에 대한 심층 가시성 구성 요소의 표시를 활성화하거나 비활성화합니다. 라이브 오류 뷰어 및 기록 이벤트 뷰어의 스택 뷰에서 상세한 중단 정보를 표시합니다.
값:
true 또는 false기본값:
True예: introscope.agent.deep.stallsnapshot.enabled=true
참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.instrumentation.max.methods
PBD 계측 없이 에이전트가 자동으로 계측할 수 있는 메서드의 수를 제한합니다.
값:
정수 > 0 <= 10000기본값:
10000예:
introscope.agent.deep.instrumentation.max.methods=10000참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.trace.max.components
에이전트가 트랜잭션 추적에서 수집할 수 있는 심층 가시성 구성 요소의 최대 수를 제한합니다.
값:
정수 > 0 <= 1000기본값:
1000예:
introscope.agent.deep.trace.max.components =1000참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.trace.max.consecutive.components
트랜잭션 추적에서 연속된 심층 가시성 구성 요소의 최대 수를 제한합니다. PBD 계측 메서드 간에 검색 및 표시되는 심층 가시성 구성 요소 수를 설정합니다.
값:
정수 > 0기본값:
15예:
introscope.agent.deep.trace.max.consecutive.components=15참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.instrumentation.custom.prefixes
이 속성은 Introscope가 스마트 계측에서 낮은 계측 우선 순위를 부여하는 Java 패키지를 지정합니다.
값:
유효한 Java 패키지 접두사 문자로만 구성된 모든 문자열입니다. 하나 또는 여러 접두사 세그먼트가 허용됩니다. 여러 문자열을 구분하려면 쉼표를 사용하십시오. 와일드카드는 허용되지 않습니다.기본값:
java예:
introscope.agent.deep.instrumentation.custom.prefixes=java,org.apache이 예에서 Introscope는 Java 및 org.apache에 정의된 API를 호출하는 메서드를 스마트 계측에 의해 계측되는 낮은 우선 순위로 간주합니다.
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.deep.automatic.trace.enabled
이 속성은 Introscope의 트랜잭션 추적 자동 수집 기능을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
True예:
introscope.agent.deep.automatic.trace.enabled=true참고:
- 이 속성은 트랜잭션 추적 샘플링에는 적용되지 않습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.deep.automatic.trace.clamp
Introscope가 1분마다 수집하는 자동 트랜잭션 추적의 수를 제한합니다.
값:
0보다 크고 10보다 작거나 같은 정수. 0보다 작거나 같을 경우 Introscope는 자동 트랜잭션 추적을 수집하지 않습니다. 10보다 클 경우에는 HTTP 프로토콜 헤더 제한으로 인해 자동 트랜잭션 추적에 크로스 프로세스 트랜잭션이 표시되지 않을 수 있습니다. 기본값:
10예:
introscope.agent.deep.automatic.trace.clamp=10참고:
- 이 속성은 트랜잭션 추적 샘플링에는 적용되지 않습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.deep.automatic.trace.crossprocess.enabled
이 속성은 자동 트랜잭션 추적에 대한 크로스 프로세스 지원을 활성화하거나 비활성화합니다.
참고
: 자동 트랜잭션 추적에 크로스 프로세스 트랜잭션을 표시하려면 다음 속성이 true로 설정되어야 합니다.- introscope.agent.deep.trace.enabled
- introscope.agent.deep.instrumentation.enabled
- introscope.agent.deep.automatic.trace.enabled
값:
true 또는 false기본값:
True예:
introscope.agent.deep.automatic.trace.crossprocess.enabled=true참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.entrypoint.enabled
이 속성은 진입점을 감지하는 에이전트 기능을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
True예:
introscope.agent.deep.entrypoint.enabled=true참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.deep.entrypoint.skip.pkgs
이 속성은 에이전트가 진입점을 고려하지 않고 건너뛸 클래스에 대한 Java 패키지 접두사를 지정합니다. 기존의 기본 또는 사용자 지정 PBD에서 건너뛴 플래그와 클래스뿐만 아니라 이러한 접두사도 제외됩니다.
값:
유효한 Java 패키지 접두사 문자로 구성된 임의의 값 여러 문자열을 구분하려면 쉼표를 사용하십시오. 와일드카드는 허용되지 않습니다.기본값:
<비어 있음>예:
introscope.agent.deep.entrypoint.skip.pkgs=com.abc이 예에서는 에이전트가 접두사 com.abc를 사용하는 모든 클래스를 건너뜁니다. 에이전트는 이러한 클래스가 진입점일 수 있는 것으로 간주하지 않습니다.
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.autopersist.instrumentation.count.max
AutoPersist.pbd
에 유지될 수 있는 진입점과 자동 백엔드의 최대 개수를 제한합니다.값:
정수 > 0 <= 250기본값:
60예:
introscope.agent.autopersist.instrumentation.count.max=60참고:
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
- introscope.agent.autopersist.instrumentation.count.max속성은 더 이상 사용되지 않는introscope.agent.deep.entrypoint.count.max property속성을 대체합니다.
introscope.agent.automatic.backend.detection.enabled
이 속성은 자동 백엔드를 감지하는 에이전트 기능을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
True예:
introscope.agent.automatic.backend.detection.enabled=true참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.automatic.backend.detection.skip.pkgs
이 속성은 에이전트가 자동 백엔드를 고려하지 않고 건너뛸 클래스에 대한 Java 패키지 접두사를 지정합니다. 기존의 기본 또는 사용자 지정 PBD에서 건너뛴 플래그와 클래스뿐만 아니라 이러한 접두사도 제외됩니다.
값:
유효한 Java 패키지 접두사 문자로 구성됩니다. 여러 문자열을 구분하려면 쉼표를 사용하십시오. 와일드카드는 허용되지 않습니다.기본값:
<비어 있음>예:
introscope.agent.automatic.backend.detection.skip.pkgs=com.abc,com.xyz이 예에서는 에이전트가 접두사 com.abc 및 com.xyz를 사용하는 모든 클래스를 건너뜁니다. 에이전트는 이러한 클래스가 자동 백엔드일 수 있는 것으로 간주하지 않습니다.
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.동적 계측 속성
클래스 및 메서드가 동적으로 계측되도록 설정할 수 있습니다. 동적 계측을 위해 사용자 지정 PBD를 작성하거나 응용 프로그램 서버를 다시 시작하거나 에이전트를 다시 시작하지 않아도 됩니다.
introscope.autoprobe.dynamicinstrument.enabled
이 속성은 에이전트에 동적 ProbeBuilding을 사용하도록 설정합니다.
값:
true 또는 false기본값:
true예:
introscope.autoprobe.dynamicinstrument.enabled=true참고:
- JDK 1.5 이상에서 실행되며 AutoProbe를 사용하는 에이전트에 해당되는 기능입니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.autoprobe.dynamicinstrument.simpleClassNameSearch.enabled
이 속성은 클래스를 다시 정의할 때 동적 계측 기능에서 간단한 클래스 이름 검색이 가능하도록 설정합니다. WebSphere Application Server나 WebSphere Liberty 프로필에서 JSP 클래스를 다시 정의할 때 이 속성을 사용하십시오. 에이전트 로그에 다음과 같은 예외가 표시되면 이 속성을 사용하도록 설정하십시오.
[IntroscopeAgent.Agent] Could not obtain class bytes for the class -com.ibm._jsp._directives java.io.IOException: input stream null ....
기본값:
false예제
: introscope.autoprobe.dynamicinstrument.simpleClassNameSearch.enabled=true
참고
: 이 속성은 기본적으로 속성 파일에 포함되어 있지 않습니다. 이 속성을 추가하려면 예제 텍스트를 복사하여 속성 파일에 붙여 넣으십시오.autoprobe.dynamicinstrument.pollIntervalMinutes
이 속성에 따라 에이전트가 새 PBD 및 변경된 PBD를 폴링하는 빈도가 결정됩니다.
기본값:
1예:
autoprobe.dynamicinstrument.pollIntervalMinutes=1참고:
JDK 1.5 이상에서 실행되며 AutoProbe 및 동적 ProbeBuilding을 사용하는 에이전트에 해당되는 기능입니다.introscope.autoprobe.dynamicinstrument.classFileSizeLimitInMegs
일부 클래스 로더 구현에서는 대량의 클래스 파일을 반환하는 것으로 확인되었습니다. 이 속성은 메모리 오류를 방지하기 위한 것입니다.
기본값:
1예:
introscope.autoprobe.dynamicinstrument.classFileSizeLimitInMegs=1참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.autoprobe.dynamic.limitRedefinedClassesPerBatchTo
한 번에 너무 많은 클래스를 다시 정의하면 CPU가 무리하게 사용될 수 있습니다. 이 속성은 PBD의 변경 사항으로 인해 많은 수의 클래스를 다시 정의해야 할 때 프로세스를 안정적인 속도로 일괄 처리합니다.
기본값:
10예:
introscope.autoprobe.dynamic.limitRedefinedClassesPerBatchTo=10introscope.agent.remoteagentdynamicinstrumentation.enabled
이 속성은 동적 계측의 원격 관리를 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.remoteagentdynamicinstrumentation.enabled=true참고:
- 동적 계측은 CPU를 많이 사용하는 작업입니다. 계측되는 클래스를 최소화하는 구성을 사용하십시오.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.autoprobe.dynamicinstrument.pollIntervalMinutes
이 속성은 PBD 변경 사항을 폴링할 폴링 간격(분)을 정의합니다.
기본값:
1예:
introscope.autoprobe.dynamicinstrument.pollIntervalMinutes=1참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.ErrorDetector 속성
ErrorDetector는 기본적으로 에이전트와 함께 설치됩니다. 에이전트가 ErrorDetector와 상호 작용하는 방식을 제어할 수 있습니다.
introscope.agent.errorsnapshots.enable
이 속성은 에이전트가 심각한 오류에 대한 트랜잭션 세부 정보를 캡처할 수 있도록 합니다. 오류 스냅숏을 볼 수 있도록 하려면 이 속성을 true로 설정해야 합니다.
값:
true 또는 false기본값:
true참고:
관리되는 응용 프로그램을 다시 시작하지 않아도 됩니다.introscope.agent.errorsnapshots.throttle
이 속성은 에이전트가 15초 동안 보낼 수 있는 최대 오류 스냅숏 수를 지정합니다.
기본값:
10예:
introscope.agent.errorsnapshots.throttle=10참고:
관리되는 응용 프로그램을 다시 시작하지 않아도 됩니다.introscope.agent.errorsnapshots.ignore.<index>
이 속성은 오류 메시지 필터를 하나 이상 지정합니다. 속성 이름에 인덱스 식별자(예: .0, .1, .2 ...)를 추가하여 필터를 필요한 수만큼 지정할 수 있습니다. 와일드카드(*)를 사용할 수 있습니다. 지정한 조건과 일치하는 오류 메시지는 무시됩니다. 또한, 오류 스냅숏 및 오류 메트릭이 생성되어 Enterprise Manager로 전송되지도 않습니다.
중요!
이 속성은 SOAP 오류 메시지를 필터링하는 데 사용할 수 없습니다.기본값:
IntroscopeAgent.profile에서 예제 값이 제공됩니다.예:
introscope.agent.errorsnapshots.ignore.0=*com.company.HarmlessException*
introscope.agent.errorsnapshots.ignore.1=*HTTP Error Code: 404*
참고:
관리되는 응용 프로그램을 다시 시작하지 않아도 됩니다.확장 속성
에이전트 확장의 위치 및 기능을 구성할 수 있습니다.
introscope.agent.extensions.directory
이 속성은 설치 관리자에서 선택하거나, 지원 센터에서 다운로드하거나, <
에이전트 홈
>/examples 폴더에서 복사하는 에이전트 확장의 위치를 지정합니다. 디렉터리의 절대 또는 상대 경로를 지정할 수 있습니다. 절대 경로를 지정하지 않을 경우, 지정한 경로는 IntroscopeAgent.profile 위치를 기준으로 확인됩니다.기본 디렉터리 값을 변경하지
않는
것이 좋습니다.기본값:
<에이전트 홈>
/ext 디렉터리예:
introscope.agent.extensions.directory=../ext참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.extensions.bundles.directory
이 속성은 에이전트 확장(예: CA APM Marketplace에서 제공되는 확장)의 설치 디렉터리를 지정합니다.
기본값:
<에이전트 홈
>/extensions예:
introscope.agent.extensions.bundles.directory=<에이전트 홈
>/extensions참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.extensions.bundles.mode
이 속성은 에이전트 확장 로드 메커니즘을 설정합니다. 다음은 모드 값입니다.
- Off- <에이전트 홈>/extensions 디렉터리에서의 확장 로드 및 언로드를 비활성화합니다.
- Controlled- 에이전트 시작 시에만 확장을 로드하고 언로드합니다. Controlled 모드는 프로덕션 환경에서 에이전트가 에이전트 확장을 로드하는 시기 및 방법을 제어하기 위한 용도로 적합합니다. 일부 확장은 Controlled 모드에서만 실행할 수 있고 Dynamic 모드로는 설정할 수 없습니다. Controlled 모드 확장의 경우 모니터링을 활성화하려면 항상 응용 프로그램을 다시 시작해야 합니다.
- Dynamic- 런타임 중에 응용 프로그램 재시작이 필요하지 않은 확장을 로드하고 언로드합니다.
기본값:
Dynamic예:
introscope.agent.extensions.bundles.mode=dynamic참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.에이전트 일반 디렉터리
introscope.agent.common.directory
이 속성은 에이전트 확장 관련 파일의 위치를 지정합니다.
기본값:
<에이전트 홈
>/common 디렉터리의 common 폴더예:
introscope.agent.common.directory=../../common외부 비즈니스 트랜잭션 모니터링 속성
IntroscopeAgent.* 프로필에서 다음을 사용할 수 있습니다.
- 외부 비즈니스 트랜잭션 모니터링 속성을 사용하여 외부 비즈니스 트랜잭션과 일치하도록 CA APM 비즈니스 트랜잭션을 구성합니다. End-User Endpoints Monitoring은 이 이름 매칭을 사용합니다.
- 트랜잭션 추적 프로그램 구성x-apm-bt속성은 트랜잭션 추적 프로그램 데이터에서 특정 HTTP 요청 헤더, 매개 변수 또는 세션 특성을 기록합니다.
참고:
이 속성은 레거시 모드 Java 에이전트에서 사용할 수 없습니다.introscope.agent.external.biz.enabled
이 속성은 외부 비즈니스 트랜잭션 모니터링을 활성화하거나 비활성화합니다.
기본값:
Trueintroscope.agent.external.biz.header.size.max
이 속성은 외부 비즈니스 트랜잭션 헤더 매개 변수(
x-apm-bt
)에 대한 최대 데이터 크기를 지정합니다. 단위는 1 KB입니다. 매개 변수가 이 제한을 초과하는 요청은 외부 비즈니스 트랜잭션으로서 처리되지 않습니다.기본값:
10introscope.agent.external.biz.bt.count.max
이 속성은 외부 비즈니스 트랜잭션의 허용되는 최대 수(클램프)를 지정합니다. 클램프는 에이전트(계측되는 Java 백엔드 응용 프로그램 인스턴스) 단위로 적용됩니다. 클램프에 도달하면 에이전트 로그 및 지원 가능성 메트릭에 항목이 표시됩니다. 이 속성은 현재 외부 비즈니스 트랜잭션 정의를 재설정합니다.
기본값:
100introscope.agent.transactiontracer.parameter.httprequest.headers=x-apm-bt
이 속성은 트랜잭션 추적 프로그램 데이터에서 HTTP 요청 헤더, 매개 변수 또는 세션 특성을 지정합니다.
GC 모니터 속성
"GC Monitor"(GC 모니터) 노드 아래의 메트릭은 가비지 수집기 및 메모리 풀에 대한 정보를 보고합니다. 이러한 메트릭은 성능에 부정적인 영향을 주는 메모리 관련 문제를 감지하는 데 유용합니다. 에이전트 프로필에서 직접 이러한 메트릭의 수집이 사용되도록 설정하십시오.
introscope.agent.gcmonitor.enable
이 속성은 가비지 수집기 및 메모리 풀에 대한 메트릭을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.gcmonitor.enable=true참고:
- Sun 또는 IBM JVM을 모니터링하는 에이전트에 대해서만 "GC Monitor"(GC 모니터) 메트릭을 보고할 수 있습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
Java NIO 속성
Java 에이전트는 Java New I/O(Java NIO 또는 NIO) 기능을 지원합니다. Java NIO는 최신 운영 체제의 낮은 수준 I/O 작업에 액세스할 수 있도록 설계된 API의 모음입니다. Java NIO 메트릭은 계측된 응용 프로그램에서 Java NIO를 사용하는 방식에 대한 정보를 캡처합니다.
참고:
Introscope Java NIO 메트릭 및 Java NIO 정보의 메트릭 수집은 Java 1.5 JVM 이상에서만 사용할 수 있습니다.Introscope Java 에이전트는 NIO 채널에 대한 메트릭을 수집합니다.
특정 NIO 메트릭의 생성을 제한할 수 있습니다.
Java NIO 추적 프로그램 그룹은 기본적으로 사용되도록 설정되어 있습니다. 이러한 추적 프로그램 그룹을 해제하여 메트릭 생성을 추가적으로 제한할 수 있습니다.
채널
Java NIO 채널을 사용하면 NIO 버퍼 및 외부 시스템과도 대량 데이터 전송이 가능합니다. 이 낮은 수준의 데이터 전송 메커니즘은 표준 Java I/O 내의 성능 및 확장성 문제를 해결하기 위해 설계되었습니다.
채널은 버퍼와 외부 시스템 간에 바이트를 이동하기 위한 메커니즘을 제공합니다. Introscope 채널 메트릭의 특징은 채널을 통한 데이터 흐름 속도에 있습니다. 수집된 NIO 채널 메트릭은 표준 Java I/O 기술을 사용하여 파일 및 소켓 I/O에 대해 현재 생성된 메트릭에 해당합니다. Workstation Investigator에서는 다음 채널 유형에 대한 메트릭이 개별적으로 수집되어 표시됩니다.
- 데이터그램 채널
- 소켓 채널
NIODatagramTracing 메트릭
UDP가 연결 없는 프로토콜이긴 하지만 Java 에이전트가 데이터그램 메트릭을 수집하는 방법을 기술하기 위해
NIODatagramTracing
의 설명에 "연결"이란 표현이 사용되었습니다. Java 에이전트는 '전송' 또는 '수신'된 각 원격 끝점 데이터그램에 대해 개별적으로 메트릭을 수집합니다. 각 '대상' 및 '원본' 끝점에서 관찰된 첫 번째 데이터그램의 방향에 따라 클라이언트 또는 서버로 분류됩니다.예를 들어 첫 번째 데이터그램이 ‘원본’ 끝점인 경우 Java 에이전트는 해당 끝점에서 주고받는 모든 이후 데이터그램을 분류합니다. 이 메트릭은
NIO|Channels|Datagrams|Server|Port {PORT}
아래에 표시됩니다. 여기서 {PORT}
는 로컬 포트입니다.첫 번째 데이터그램이 ‘대상’ 끝점인 경우 해당 끝점에서 주고받는 모든 이후 데이터그램은
NIO|Channels|Datagrams|Client|{HOST}|Port {PORT}
아래에 분류됩니다. 여기서 {HOST}
및 {PORT}
는 원격 끝점입니다.Java 에이전트는 또한 클라이언트 "연결"에 대한 백엔드 메트릭을 생성합니다. '수신' 메서드가 읽는 데이터그램은 예외입니다. DatagramChannel 연결 메서드를 사용하여 생성된 데이터그램 채널은 관찰된 첫 번째 데이터그램의 방향과 관계없이 클라이언트 연결로 간주됩니다.
참고:
UDP 연결을 사용하여(연결 메서드 사용) 생성된 데이터그램 채널은 클라이언트 연결로 간주됩니다.Java NIO 메트릭 제한
속성을 구성하여 Java NIO 계측이 작동하는 방식을 제어할 수 있습니다. 데이터그램 및 소켓 메트릭의 생성을 제한할 수도 있습니다. 이러한 속성은
NIOSocketTracing
및 NIODatagramTracing
추적 프로그램 그룹에 의해 생성된 세부 메트릭에만 적용됩니다.introscope.agent.nio.datagram.client.hosts
이 속성은 메트릭 보고를 지정된 호스트가 하나 이상 있는 '클라이언트' UDP "연결"로 제한합니다.
값:
쉼표로 구분된 호스트 목록기본값:
정의되지 않음(값 없음)예:
introscope.agent.nio.datagram.client.hosts=hostA,hostB참고:
- 목록이 비어 있는 경우 호스트 제한이 적용되지 않습니다.
- 호스트는 이름이나 IP 주소(IPv4 또는 IPv6 형식)의 텍스트 표현으로 지정할 수 있습니다.
- 잘못된 호스트 이름은 에이전트 로그에 보고되고 무시됩니다.
- 중복 호스트 이름은 삭제됩니다. 여러 개의 호스트 이름이 단일 IP에 매핑되는 경우에는 하나의 이름만 유지됩니다. 그러나 이 속성은 클라이언트 연결을 동의어 이름 집합의 임의 항목과 매칭합니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.nio.datagram.client.ports
NIO 메트릭을 보고하는 포트를 나열합니다. 지정된 포트에 대한 '클라이언트' 데이터그램 메트릭만 생성됩니다.
값:
쉼표로 구분된 포트
번호 목록. 포트
는 전송되는 데이터그램의 대상이자 수신되는 원격 포트 데이터그램의 원본인 원격 포트입니다.기본값:
정의되지 않음(값 없음)예:
introscope.agent.nio.datagram.client.ports=123,456,789참고:
- 목록이 비어 있는 경우 포트 제한이 적용되지 않습니다.
- 잘못된 포트 번호는 에이전트 로그에 보고되고 무시됩니다.
- 중복 포트는 삭제됩니다. 여러 개의 포트가 단일 IP에 매핑되는 경우에는 하나의 포트만 유지됩니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.nio.datagram.server.ports
NIO 메트릭을 보고하는 포트를 나열합니다. 지정된 포트에 대한 '서버' 데이터그램 메트릭만 생성됩니다.
값:
쉼표로 구분된 포트
번호 목록. 포트
는 데이터그램 전송 및 수신 시 사용되는 로컬 포트입니다.기본값:
정의되지 않음(값 없음)예:
introscope.agent.nio.datagram.server.ports=123,456,789참고:
- 목록이 비어 있는 경우 포트 제한이 적용되지 않습니다.
- 잘못된 포트 번호는 에이전트 로그에 보고되고 무시됩니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.nio.socket.client.hosts
이 속성은 메트릭 보고를 지정된 호스트가 있는 '클라이언트' TCP "연결"로 제한합니다.
값:
쉼표로 구분된 호스트 목록기본값:
정의되지 않음(값 없음)예:
introscope.agent.nio.socket.client.hosts=hostA, hostB참고:
- 목록이 비어 있는 경우 호스트 제한이 적용되지 않습니다.
- 호스트는 이름이나 IP 주소(IPv4 또는 IPv6 형식)의 텍스트 표현으로 지정할 수 있습니다.
- 잘못된 호스트 이름은 에이전트 로그에 보고되고 무시됩니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.nio.socket.client.ports
NIO 메트릭을 보고하는 포트를 나열합니다. 지정된 포트에 대한 '클라이언트' 소켓 메트릭만 생성됩니다.
값:
쉼표로 구분된 포트
번호 목록. 포트
는 데이터그램을 주고받는 원격 포트입니다.기본값:
정의되지 않음(값 없음)예:
introscope.agent.nio.socket.client.ports=123,456,789참고:
- 목록이 비어 있는 경우 포트 제한이 적용되지 않습니다.
- 잘못된 포트 번호는 에이전트 로그에 보고되고 무시됩니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.nio.socket.server.ports
NIO 메트릭을 보고하는 포트를 나열합니다. 지정된 포트에 대한 '서버' 소켓 메트릭만 생성됩니다.
Java NIO 메트릭은 Investigator 트리에서 에이전트의 최상위 수준 노드 아래에 있는 NIO 노드 아래에 표시됩니다. 모든 '클라이언트' 연결에 대한 추가 NIO 메트릭은 "Backends"(백엔드) 노드 아래에 표시됩니다.
TraceOneMethodIfFlagged
또는 TraceOneMethodWithParametersIfFlagged
지시문을 주석으로 처리하여 하나 이상의 개별 NIO 메트릭을 표시하지 않을 수 있습니다. 하지만 이름이 BackendTracer
또는 MappingTracer
로 끝나는 추적 프로그램은 주석으로 처리하지 마십시오.예를 들어 데이터그램에 대한 "Concurrent Reader"(동시 판독기 수) 메트릭을 표시하지 않으려면
TraceOneMethodIfFlagged
지시문을 주석으로 처리하십시오.TraceOneMethodWithParametersIfFlagged: NIODatagramTracing read NIODatagramConcurrentInvocationCounter "Concurrent Readers"
값:
쉼표로 구분된 포트
번호 목록. 포트
는 데이터그램 전송 및 수신 시 사용되는 로컬 포트입니다.기본값:
정의되지 않음(값 없음)예:
introscope.agent.nio.socket.client.ports=123,456,789참고:
- 목록이 비어 있는 경우 포트 제한이 적용되지 않습니다.
- 잘못된 포트 번호는 에이전트 로그에 보고되고 무시됩니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
JMS 임시 대상 속성
jms.temporaryDestination.check
이 속성은 대상이
javax.jms.TemporaryDestination
의 인스턴스인 큐 및 항목이 단일 대상으로 병합되는지(true), 아니면 개별적으로 보고되는지(false)를 지정합니다.값:
true 또는 false기본값:
true예:
jms.temporaryDestination.check=true참고:
- 이 속성을 사용하지 않도록 설정하면 많은 수의 원치 않는 메트릭이 표시될 수 있습니다. 실제로 일시적인 큐 및 항목으로만 출력을 제한하려면jms.temporaryDestination.names속성을 사용하십시오(다음 속성 참조).
- 이 속성의 변경 사항은 즉시 적용됩니다. 에이전트 또는 응용 프로그램을 다시 시작할 필요가 없습니다.
jms.temporaryDestination.names
jms.temporaryDestination.check
가 false
로 설정된 경우(이전 속성 참조), jms.temporaryDestination.names
를 사용하여 '임시 큐' 및 '임시 항목' 메트릭으로 처리해야 하는 동적 또는 임시 대상 이름을 식별할 수 있습니다.값:
쉼표로 구분된 와일드카드 패턴 목록. 0개 이상의 문자를 나타내는 별표(*) 와일드카드 문자만 사용할 수 있습니다.예:
- XYZ*는 XYZ로 시작하는 대상 이름을 나타냅니다.
- *XYZ는 XYZ로 끝나는 대상 이름을 나타냅니다.
- *XYZ*는 XYZ가 포함된 대상 이름을 나타냅니다.
- XYZ는 XYZ와 정확히 일치함을 나타냅니다.
참고:
이 속성의 변경 사항은 즉시 적용됩니다. 에이전트 또는 응용 프로그램을 다시 시작할 필요가 없습니다.JMX 속성
introscope.agent.jmx.enable
이 속성은 JMX 메트릭의 수집을 활성화합니다.
값:
true 또는 false기본값:
에이전트 버전별로 달라집니다.예:
introscope.agent.jmx.enable=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.jmx.ignore.attributes
이 속성은 에이전트가 무시할 JMX MBean 특성(있는 경우)을 제어합니다.
값:
쉼표로 구분된 키워드 목록기본값:
server예:
introscope.agent.jmx.ignore.attributes=server참고:
- MBean 특성 이름이 목록에 있는 한 이름과 일치하면 해당 특성이 무시됩니다.
- 모든 MBean 특성을 포함하려면 목록을 비워두십시오.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.jmx.name.filter
이 속성은 Introscope에서 수집하고 표시하는 JMX 데이터를 결정하기 위한 필터 문자열을 쉼표로 구분된 목록으로 지정합니다.
Introscope에서는 필터 문자열과 일치하는 JMX 생성 메트릭을 보고합니다. 필터 문자열에는 별표(*) 및 물음표(?) 와일드카드 문자를 포함할 수 있습니다.
- *는 0개 이상의 문자와 일치합니다.
- ?는 하나의 문자와 일치합니다.
리터럴
*
또는 ?
와 매칭하려면 문자를 \\
로 이스케이프하십시오.예:
- ab\\*c는ab*c를 포함하는 메트릭 이름과 일치합니다.
- ab*c는abc, abxc, abxxc등을 포함하는 메트릭 이름과 일치합니다.
- ab?c는abxc를 포함하는 메트릭 이름과 일치합니다.
- ab\\?c는ab?c를 포함하는 메트릭 이름과 일치합니다.
기본값:
WebLogic의 경우:ActiveConnectionsCurrentCount,WaitingForConnectionCurrentCount,PendingRequestCurrentCount,ExecuteThreadCurrentIdleCount,OpenSessionsCurrentCount,j2eeType
예:
#introscope.agent.jmx.name.filter=ActiveConnectionsCurrentCount,WaitingForConnectionCurrentCount,PendingRequestCurrentCount,ExecuteThreadCurrentIdleCount,OpenSessionsCurrentCount,j2eeType
참고:
- 시스템에서 사용할 수 있는 모든 MBean 데이터를 포함하려면 이 속성을 비워 두십시오.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.jmx.name.jsr77.disable
이 속성은 Introscope가 복잡한 JMX 데이터를 포함한 전체 JSR77 데이터를 수집하고 보고할지 여부를 제어합니다.
이 속성은 WebLogic 및 WebSphere
IntroscopeAgent.profile
파일에서만 사용할 수 있습니다.값:
true 또는 false기본값:
true참고:
- 이 속성을 적용하려면 응용 프로그램 서버에서 JSR-77 관리를 지원해야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.jmx.name.primarykeys
이 속성은 MBean 정보의 사용자 정의 순서를 지정하고, 이름 변환을 간소화합니다.
값:
특정 MBean을 고유하게 식별하는 키가 쉼표로 구분되고 순서가 지정된 목록WebLogic에서의 값:
- Type
- Name
WebSphere에서의 값:
- J2EEServer
- Application
- j2eeType
- JDBCProvider
- name
- mbeanIdentifier
기본값: <password>
예:
introscope.agent.jmx.name.primarykeys=J2EEServer참고:
- WebLogic Server 9.0 이상을 사용하는 경우에는 이 속성을 주석으로 처리하십시오.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.jmx.excludeStringMetrics
이 속성은 문자열 값 메트릭을 포함할지 여부를 제어합니다. 문자열 값 메트릭이 사용되도록 설정하려면 이 속성 값을 false로 설정하십시오.
값:
true 또는 false기본값:
true예:
introscope.agent.jmx.excludeStringMetrics=true참고:
- 문자열 값 메트릭을 제외하면 전체 메트릭 수가 줄어들어 에이전트 및 EM 성능이 향상됩니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introcope.agent.jmx.syncWithAllMbeanServersForcibly
이 속성은 에이전트가 모든 MBean 서버의 모든 MBean을 폴링할 수 있는지 여부를 제어합니다.
true
로 설정하면 에이전트가 모든 MBean 서버의 모든 MBean을 폴링합니다.값:
true 또는 false기본값:
false예:
introcope.agent.jmx.syncWithAllMbeanServersForcibly=true참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.Tomcat 에이전트 JMX 속성
다음 속성은 Tomcat JMX에만 적용됩니다. 이 속성은 Tomcat 에이전트 설치 tars/zip에 포함되어 있습니다.
introscope.agent.jmx.ratecounter.enable
이 속성은 JMX Mbean 데이터에 대한 비율 카운터 메트릭의 수집을 제어합니다. Introscope Agent에서 JMX 비율 카운터 메트릭을 수집하려면
true
로 설정하십시오.값:
true 또는 false기본값:
False예:
introscope.agent.jmx.ratecounter.enable=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.jmx.ratecounter.reset.enable
JMX 비율 카운터 메트릭에 대한 카운터 재설정을 적용하는 데 사용됩니다. 비율이 음수이면 Java 에이전트는 이전 카운터 비율을 보고합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.jmx.ratecounter.reset.enable=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.jmx.compositedata.enable
이 속성은 JMX Mbean에서의 데이터(
CompositeData
유형) 수집을 제어합니다. Introscope Agent에서 JMX 데이터를 수집하려면 true
로 설정하십시오.값:
true 또는 false기본값:
false예:
introscope.agent.jmx.compositedata.enable=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.로깅 속성
log4j.logger.IntroscopeAgent
이 속성은 로그 정보에 대한 로깅 수준과 출력 위치를 지정합니다.
값:
세부 정보 수준 값:
- INFO
- VERBOSE#com.wily.util.feedback.Log4JSeverityLevel
대상 값:
- console
- logfile
- console및logfile모두
기본값:
INFO, logfile예:
log4j.logger.IntroscopeAgent=INFO, logfile에이전트 로깅을 사용하지 않도록 설정하려면 다음과 같이 이 속성에서 옵션을 제거합니다.
log4j.logger.IntroscopeAgent=
참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.log4j.appender.logfile.File
log4j.logger.IntroscopeAgent 속성에 logfile이 지정된 경우 log4j.appender.logfile.File은 IntroscopeAgent.log 파일의 이름 및 위치를 지정합니다. 파일 이름은 에이전트 프로필이 포함된 디렉터리를 기준으로 합니다.
기본값:
IntroscopeAgent.log예:
log4j.appender.logfile.File=../../logs/IntroscopeAgent.log참고:
시스템 속성(Java 명령줄 -D 옵션)은 파일 이름의 일부로 확장됩니다.예를 들어 Java가
-Dmy.property=Server1
로 시작되는 경우 log4j.appender.logfile.File=../../logs/Introscope-${my.property}.log
는 log4j.appender.logfile.File=../../logs/Introscope-Server1.log
로 확장됩니다.log4j.logger.IntroscopeAgent.inheritance
이 속성은 계측이 필요한 클래스에 대한 로그 메시지의 로그 수준 및 대상을 지정합니다.
값:
계측되지 않은 클래스는 슈퍼 형식 또는 인터페이스를 확장하므로 이러한 클래스의 로깅을 구성하려면 이 속성을 INFO, pbdlog
로 설정하십시오.기본값:
없음예:
log4j.logger.IntroscopeAgent.inheritance=INFO,pbdloglog4j.appender.pbdlog.File
이 속성은 계측이 필요한 클래스에 대한 메시지 로그 파일을 지정합니다.
값:
계측되지 않은 클래스는 슈퍼 형식 또는 인터페이스를 확장하므로 이러한 클래스의 로깅을 구성하려면 pbdupdate.log
로 설정하십시오.기본값:
없음예:
log4j.appender.pbdlog.File=../../pbdupdate.loglog4j.appender.pbdlog
이 속성은 계측이 필요한 클래스에 대한 메시지 로깅의 패키지를 지정합니다.
값:
계측되지 않은 클래스는 슈퍼 형식 또는 인터페이스를 확장하므로 이러한 클래스의 로깅을 구성하려면 log4j.appender.pbdlog
속성을 com.wily.introscope.agent.AutoNamingRollingFileAppender
값으로 설정하십시오.기본값:
없음예:
log4j.appender.pbdlog=com.wily.introscope.agent.AutoNamingRollingFileAppenderlog4j.appender.pbdlog.layout
이 속성은 계측이 필요한 클래스에 대한 메시지 로깅의 규칙을 지정합니다.
값:
계측되지 않은 클래스는 슈퍼 형식 또는 인터페이스를 확장하므로 이러한 클래스의 로깅을 구성하려면 log4j.appender.pbdlog.layout
속성을 com.wily.org.apache.log4j.PatternLayout
값으로 설정하십시오.기본값:
없음예:
log4j.appender.pbdlog.layout=com.wily.org.apache.log4j.PatternLayoutlog4j.appender.pbdlog.layout.ConversionPattern
이 속성은 계측이 필요한 클래스에 대한 메시지 로깅의 규칙을 지정합니다.
값:
계측되지 않은 클래스는 슈퍼 형식 또는 인터페이스를 확장하므로 이러한 클래스의 로깅을 구성하려면 log4j.appender.pbdlog.layout.ConversionPattern
을 %d{M/dd/yy hh:mm:ss a z} [%-3p] [%c] %m%n으로 설정하십시오.기본값:
없음예:
log4j.appender.pbdlog.layout.ConversionPattern=%d{M/dd/yy hh:mm:ss a z} [%-3p] [%c] %m%nlog4j.additivity.IntroscopeAgent.inheritance
이 속성은 다중 수준 상속에 대한 지시문이
pbdupdate.log
파일에만 로깅되어야 하는지 여부를 지정합니다.pbdupdate.log
에서만 다중 수준 상속 지시문의 로깅을 구성하려면 에이전트 프로필에 log4j.additivity.IntroscopeAgent.inheritance
를 추가하고 값을 false
로 설정하십시오.값:
true 또는 false기본값:
true예:
log4j.additivity.IntroscopeAgent.inheritance=true메트릭 수 속성
introscope.ext.agent.metric.count
이 속성은 Investigator에서
Metric Count
(메트릭 수) 메트릭이 표시되는 위치를 제어합니다. 기본적으로 Metric Count
(메트릭 수)는 Custom Metric Agent
(사용자 지정 메트릭 에이전트) 노드 아래에 표시됩니다. Agent Stats
(에이전트 통계) 노드 아래에 Metric Count
(메트릭 수) 메트릭이 표시되도록 하려면 이 속성을 IntroscopeAgent.profile
에 추가하십시오.값:
true 또는 false기본값:
IntroscopeAgent.profile
에는 없음, false예:
introscope.ext.agent.metric.count=true다중 상속 속성
introscope.autoprobe.hierarchysupport.enabled
이 속성은 슈퍼 유형 또는 인터페이스를 확장하는 클래스의 계측을 활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.autoprobe.hierarchysupport.enabled=true참고:
JDK 1.5 이상에서 실행되며 AutoProbe 및 동적 ProbeBuilding을 사용하는 에이전트에 해당되는 기능입니다.introscope.autoprobe.hierarchysupport.runOnceOnly
슈퍼 유형 또는 인터페이스를 확장하는 클래스의 계측을 사용하도록 설정한 경우 이 속성을 사용하십시오. 이 속성은 다중 상속을 가능하게 하는 유틸리티를 한 번만 실행할지 아니면 지정된 간격으로 실행할지 제어합니다.
주기적 감지가 필요한 경우에만 이 속성을 true로 변경하십시오.
값:
true 또는 false기본값:
false예:
introscope.autoprobe.hierarchysupport.runOnceOnly=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.autoprobe.hierarchysupport.pollIntervalMinutes
이 속성은 에이전트가 다중 상속으로 인해 계측되지 못한 클래스를 확인할 때의 폴링 간격 빈도(분)를 지정합니다. 일반적으로 에이전트는 이러한 클래스를 한 번만 확인하지만 응용 프로그램 서버가 초기화되는 경우를 고려하여 보수적인 값을 설정하는 것이 좋습니다.
기본값:
5예:
introscope.autoprobe.hierarchysupport.pollIntervalMinutes=5참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.autoprobe.hierarchysupport.executionCount
이 속성은 폴링 간격의 정확한 실행 횟수를 지정합니다. 폴링을 단 한 번 또는 주기적으로 실행하는 것이 아니라 일정 횟수만큼 실행하려면
introscope.autoprobe.hierarchysupport.executionCount
를 구성하십시오.이 속성을 사용하면 단 한 번 실행 설정이 무시됩니다.
값:
양의 정수기본값:
3예:
introscope.autoprobe.hierarchysupport.executionCount=3참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.autoprobe.hierarchysupport.disableLogging
이 속성은 감지되는 클래스의 로깅 여부를 지정합니다. 동적 계측이 활성화된 경우에만 이 속성의 주석 처리를 제거하십시오.
값:
true 또는 false기본값:
true예:
#introscope.autoprobe.hierarchysupport.disableLogging=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.autoprobe.hierarchysupport.disableDirectivesChange
이 속성은 변경 사항을 로깅하고 동적 계측의 트리거를 비활성화하도록 지정합니다.
값:
true 또는 false기본값:
true예:
introscope.autoprobe.hierarchysupport.disableDirectivesChange=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.플랫폼 모니터링 속성
introscope.agent.platform.monitor.system
이 속성은 플랫폼 모니터를 위해 로드할 운영 체제의 이름을 지정합니다.
기본값:
플랫폼에 따라 다름예:
introscope.agent.platform.monitor.system=LinuxIntelAmd64참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
원격 구성 속성
이 섹션의 속성은 Java 에이전트의 원격 구성을 가능하게 합니다.
introscope.agent.remoteagentconfiguration.enabled
이 속성은 에이전트의 원격 구성을 활성화 또는 비활성화합니다.
값: s
참 또는 거짓
기본값
True
예:
introscope.agent.remoteagentconfiguration.enabled=true
참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.remoteagentconfiguration.allowedFiles
이 속성은 이 에이전트로 원격 전송이 허용된 파일의 정확한 목록을 나열합니다.
값: s
domainconfig.xml
기본값
domainconfig.xml
예:
introscope.agent.remoteagentconfiguration.allowedFiles=domainconfig.xml
참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.보안 속성
이 단원의 속성은 CA CEM으로 전송되는 HTTP 헤더의 보안을 구성합니다.
introscope.agent.decorator.security
이 속성은 CA CEM으로 보내는 데코레이트된 HTTP 응답 헤더의 형식을 결정합니다.
값:
- Clear: 일반 텍스트 인코딩
- Encrypted: 헤더 데이터가 암호화됨
기본값:
Encrypted예:
introscope.agent.decorator.security=encrypted
서블릿 헤더 데코레이터 속성
이 섹션의 속성은 CA CEM과 Introscope 간의 트랜잭션 상관 관계를 활성화합니다.
introscope.agent.decorator.enabled
이 속성은 에이전트가 HTTP 응답 헤더에 추가 성능 모니터링 정보를 추가할지 여부를 지정합니다.
ServletHeaderDecorator
는 각 트랜잭션에 GUID를 연결하고 이 GUID를 HTTP 헤더(예: x-apm-info
)에 삽입합니다.값이 true면 추가 정보가 포함됩니다.
값:
true 또는 false기본값:
false예:
introscope.agent.decorator.enabled=false소켓 메트릭 속성
이 속성을 사용하여 I/O 소켓 메트릭의 생성을 제한할 수 있습니다.
com.wily.introscope.agent.sockets.clamp.level
이 속성은 에이전트가 모니터링하는 총 소켓 수를 지정합니다. 소켓 목록은 고유 조합 [port]:[ | ]에 따라 달라집니다.
기본값:
100예:
com.wily.introscope.agent.sockets.clamp.level=100- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
- 클라이언트 소켓과 서버 소켓이 동일한 JVM에 있는 경우, 클램프에 2개의 소켓이 있는 것으로 간주됩니다.
- 기본 설정값을 늘리면 심각한 메모리 오버헤드가 발생합니다.
- 최적의 성능을 위해 NIO 데이터그램 동시 판독기의 요약 메트릭이 클램프되지 않습니다.
introscope.agent.sockets.reportRateMetrics
이 속성은 개별 소켓의 I/O(입력/출력) 대역폭 비율 메트릭을 보고하도록 설정합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.sockets.reportRateMetrics=false참고:
- 이 속성은ManagedSocketTracing이 사용되도록 설정되고SocketTracing은 사용되지 않도록 설정된 경우에만 작동합니다. 자세한 내용은 이전 버전과의 호환성을 참조하십시오.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.io.socket.client.hosts
이 속성은 계측되는 소켓 클라이언트 연결을 지정된 원격 호스트를 사용한 연결로 제한합니다.
값:
쉼표로 구분된 값의 목록예:
introscope.agent.io.socket.client.hosts=참고:
- 개별 값이 잘못된 경우 해당 값은 무시됩니다.
- 어떠한 매개 변수도 정의되지 않은 경우나 잘못된 값을 제외한 후 목록이 비어 있게 되는 경우에는 해당 매개 변수에 제한이 적용되지 않습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.io.socket.client.ports
이 속성은 계측되는 소켓 클라이언트 연결을 지정된 원격 포트를 사용한 연결로 제한합니다.
값:
쉼표로 구분된 값의 목록예:
introscope.agent.io.socket.client.ports=참고:
- 개별 값이 잘못된 경우 해당 값은 무시됩니다.
- 어떠한 매개 변수도 정의되지 않은 경우나 잘못된 값을 제외한 후 목록이 비어 있게 되는 경우에는 해당 매개 변수에 제한이 적용되지 않습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.io.socket.server.ports
이 속성은 계측되는 소켓 클라이언트 연결을 지정된 로컬 포트를 사용한 연결로 제한합니다.
값:
쉼표로 구분된 값의 목록예:
introscope.agent.io.socket.server.ports=참고:
- 개별 값이 잘못된 경우 해당 값은 무시됩니다.
- 어떠한 매개 변수도 정의되지 않은 경우나 잘못된 값을 제외한 후 목록이 비어 있게 되는 경우에는 해당 매개 변수에 제한이 적용되지 않습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
SQL 에이전트 속성
SQL 에이전트의 요소를 구성할 수 있습니다.
introscope.agent.sqlagent.statement.clamp
이 속성은 SQL 에이전트가 정규화된 고유 SQL 문에 대해 보고할 수 있는 SQL 메트릭의 수를 지정합니다.
메트릭 제한 값에 도달하면 SQL 에이전트는 이후의 모든 고유 SQL 메트릭을 SQL | Default 노드 아래에 보고합니다.
기본값:
정규화된 고유 SQL 문 메트릭 100개예:
introscope.agent.sqlagent.statement.clamp=100참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.sqlagent.normalizer.extension
이 속성은 미리 구성된 정규화 체계를 재정의하는 데 사용되는 SQL 노멀라이저 확장의 이름을 지정합니다.
사용자 지정 정규화 확장 작업을 수행하려면 해당 매니페스트 특성
com-wily-Extension-Plugin-{pluginName}-Name
의 값이 이 속성에 지정된 값과 일치해야 합니다.이름을 쉼표로 구분된 목록으로 지정할 경우 에이전트는 기본 노멀라이저 확장을 사용합니다.
예를 들어 다음과 같은 설정을 사용하면 정규화에
RegexSqlNormalizer
가 사용됩니다.introscope.agent.sqlagent.normalizer.extension=RegexSqlNormalizer
이 속성은 SQL 에이전트 메트릭에 대해 Investigator 트리에 나타나는 SQL 문의 크기(바이트)를 제한합니다.
값:
미리 구성된 정규화 체계를 재정의하는 데 사용되는 SQL 노멀라이저 확장의 이름기본값:
RegexSqlNormalizer예:
introscope.agent.sqlagent.normalizer.extension=RegexSqlNormalizer참고:
- 기본 설정을 사용하는 경우에는 다음과 같이 정규식 SQL 문의 노멀라이저 속성도 구성해야 합니다.
- introscope.agent.sqlagent.normalizer.regex.matchFallThrough
- introscope.agent.sqlagent.normalizer.regex.keys
- introscope.agent.sqlagent.normalizer.regex.key1.pattern
- introscope.agent.sqlagent.normalizer.regex.key1.replaceAll
- introscope.agent.sqlagent.normalizer.regex.key1.replaceFormat
- introscope.agent.sqlagent.normalizer.regex.key1.caseSensitive
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.sqlagent.normalizer.extension.runPredefinedScheme
이 속성은 정규식 SQL 문 노멀라이저를 실행하기 전에 먼저 기본 노멀라이저를 실행할 수 있도록 합니다.
값:
True 또는 False기본값:
True예:
introscope.agent.sqlagent.normalizer.extension.runPredefinedScheme=true가시성:
이 속성은 IntroscopeAgent.profile 파일에 포함되어 있지 않습니다. 기본 설정을 FALSE로 변경하려면 이 속성을 수동으로 추가하십시오.introscope.agent.sqlagent.normalizer.regex.matchFallThrough
이 속성은 정규식 SQL 문 노멀라이저를 설정하며
introscope.agent.sqlagent.normalizer.extension
속성과 함께 사용됩니다. introscope.agent.sqlagent.normalizer.regex.matchFallThrough
가 true
로 설정되어 있으면 SQL 에이전트는 SQL 문자열을 모든 regex 키 그룹과 비교하여 평가합니다.구현은 체인으로 연결됩니다. 예를 들어 SQL이 여러 키 그룹과 일치하는 경우 group1의 정규화된 SQL 출력이 group2에 대한 입력으로 제공되는 방식으로 처리됩니다.
이 속성이
false
로 설정되어 있으면 키 그룹이 일치하는 즉시 해당 그룹의 정규화된 SQL 출력이 반환됩니다.값:
true 또는 false기본값:
false예:
introscope.agent.sqlagent.normalizer.regex.matchFallThrough=false참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.sqlagent.normalizer.regex.keys
이 속성은 정규식 SQL 문 노멀라이저를 설정하며 introscope.agent.sqlagent.normalizer.extension 속성과 함께 사용됩니다. 이 속성은 regex 그룹 키를 지정합니다. regex 그룹 키는 순서대로 평가됩니다.
기본값:
key1예:
introscope.agent.sqlagent.normalizer.regex.keys=key1참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.sqlagent.normalizer.regex.key1.pattern
이 속성은 정규식 SQL 문 노멀라이저를 설정하며 introscope.agent.sqlagent.normalizer.extension 속성과 함께 사용됩니다. 이 속성은 SQL과 매칭하는 데 사용되는 regex 패턴을 지정합니다.
값:
java.util.Regex
패키지에서 허용되는 유효한 모든 regex 항목을 여기에 사용할 수 있습니다.기본값:
.*call(.*\)\.FOO(.*\)예:
introscope.agent.sqlagent.normalizer.regex.key1.pattern=.*call(.*\)\.FOO(.*\)참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.sqlagent.normalizer.regex.key1.replaceAll
이 속성은 정규식 SQL 문 노멀라이저를 설정하며
introscope.agent.sqlagent.normalizer.extension
속성과 함께 사용됩니다. false
로 설정된 경우 introscope.agent.sqlagent.normalizer.regex.key1.replaceAll
은 SQL 쿼리에서 첫 번째로 나타나는 일치하는 패턴을 대체 문자열로 바꿉니다. 이 속성이 true
로 설정되어 있으면 SQL 쿼리에서 나타나는 일치하는 패턴이 모두 대체 문자열로 바뀝니다.값:
true 또는 false기본값:
false예:
introscope.agent.sqlagent.normalizer.regex.key1.replaceAll=false참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.sqlagent.normalizer.regex.key1.replaceFormat
이 속성은 정규식 SQL 문 노멀라이저를 설정하며 introscope.agent.sqlagent.normalizer.extension 속성과 함께 사용됩니다. 이 속성은 대체 문자열 형식을 지정합니다.
값:
java.util.Regex
패키지와 java.util.regex.Matcher
클래스에서 허용되는 유효한 모든 regex 항목을 여기에 사용할 수 있습니다.기본값:
$1예:
introscope.agent.sqlagent.normalizer.regex.key1.replaceFormat=$1참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.sqlagent.normalizer.regex.key1.caseSensitive
이 속성은 정규식 SQL 문 노멀라이저를 설정하며 introscope.agent.sqlagent.normalizer.extension 속성과 함께 사용됩니다. 이 속성은 패턴 일치 시 대/소문자 구분 여부를 지정합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.sqlagent.normalizer.regex.key1.caseSensitive=false참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.sqlagent.sql.artonly
이 속성은 에이전트가 평균 응답 시간 메트릭만 생성하고 전송해야 하는지 여부를 지정합니다. 백엔드 아래의 모든 SQL 에이전트 메트릭에 영향을 미칩니다. 값이
true
이면 SQL 에이전트가 메트릭을 보고할 때와 트랜잭션 추적을 수집할 때 성능이 향상될 수 있습니다.introscope.agent.sqlagent.sql.turnoffmetrics
를 true
로 설정하면 이 속성이 재정의됩니다.기본값:
false참고:
- 이 속성은 사용자 지정 메트릭은 제어하지 않습니다.
- 이 속성이 작동하려면 다음 추적 프로그램 매개 변수를 설정해야 합니다.SetTracerParameter: StatementToConnectionMappingTracer agentcomponent "SQL Agent"
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.sqlagent.sql.rawsql
이 속성은 트랜잭션 추적에서 에이전트가
정규화되지 않은
SQL을 SQL 구성 요소에 대한 매개 변수로 추가할지 여부를 지정합니다. 이 속성 값이 true
이면 SQL 메트릭 및 트랜잭션 추적에 대한 에이전트 성능이 향상될 수 있습니다.기본값:
false경고!
이 속성을 사용하도록 설정하면 암호 및 중요한 정보가 트랜잭션 추적에 표시될 수 있습니다.참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.sqlagent.sql.turnoffmetrics
이 속성은 SQL 문 메트릭을 해제할 수 있도록 지정합니다. 이 값을 지정하면 에이전트가 Enterprise Manager로 전송하는 메트릭이 줄어듭니다. 이 속성 값이 true이면 SQL 메트릭 및 트랜잭션 추적에 대한 에이전트 성능이 향상될 수 있습니다.
기본값:
false참고:
- 이 속성은introscope.agent.sqlagent.sql.artonly속성을 재정의합니다.
- 이 속성 설정이 작동하려면 다음 추적 프로그램 매개 변수를 설정해야 합니다.SetTracerParameter: StatementToConnectionMappingTracer agentcomponent "SQL Agent"
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.sqlagent.sql.turnofftrace
이 속성은 에이전트가 백엔드 아래의 SQL 문에 대해 트랜잭션 추적 구성 요소를 생성하여 Enterprise Manager로 전송할지 여부를 제어합니다. 이 속성 값이 true이면 SQL 메트릭 및 트랜잭션 추적에 대한 에이전트 성능이 향상될 수 있습니다.
기본값:
false참고:
- 이 속성 설정이 작동하려면 다음 추적 프로그램 매개 변수를 설정해야 합니다.SetTracerParameter: StatementToConnectionMappingTracer agentcomponent "SQL Agent"
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
SSL 통신 속성
에이전트는 SSL을 통해 Enterprise Manager에 연결할 수 있습니다. SSL 통신을 구성하려면 다음 속성을 사용하십시오.
agentManager.url.1
이 속성은 다음 설정을 지정합니다.
- 에이전트가 기본적으로 연결되는 Enterprise Manager를 실행하는 컴퓨터의 호스트 이름
- Enterprise Manager를 호스트하는 컴퓨터에서 에이전트로부터의 연결을 수신 대기하는 포트 번호
- SSL(통신 채널)
기본값:
localhost SSL(Secure Socket Layer) 프로토콜을 사용하는 경우 에이전트 연결을 수신 대기하는 기본 포트는 5443입니다.
예:
agentManager.url.1=ssl://localhost:5443
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.agentManager.trustStore.1
신뢰할 수 있는 Enterprise Manager 인증서가 포함된 신뢰 저장소의 위치입니다. 신뢰 저장소가 지정되지 않으면 에이전트는 모든 인증서를 신뢰합니다.
값:
에이전트 작업 디렉터리에 대한 절대 경로 또는 상대 경로예:
agentManager.trustStore.1=/var/trustedcerts
참고:
Windows에서는 백슬래시를 이스케이프해야 합니다. 예: C:\\keystoreagentManager.trustStorePassword.1
신뢰 저장소의 암호입니다.
예:
agentManager.trustStorePassword.1=
agentManager.keyStore.1
에이전트의 인증서를 포함하는 키 저장소의 위치입니다. Enterprise Manager가 클라이언트 인증을 요구하는 경우 키 저장소가 필요합니다.
값:
에이전트 작업 디렉터리에 대한 절대 경로 또는 상대 경로예:
agentManager.keyStore.1=c:\\keystore
참고:
Windows에서는 백슬래시를 이스케이프해야 합니다. 예: C:\\keystoreagentManager.keyStorePassword.1
키 저장소의 암호입니다.
예:
agentManager.keyStorePassword.1=MyPassword768
agentManager.cipherSuites.1
활성화된 암호 그룹을 설정합니다.
값:
쉼표로 구분된 암호 그룹 목록예:
agentManager.cipherSuites.1=SSL_DH_anon_WITH_RC4_128_MD5
참고:
지정되지 않으면 기본 사용 암호 그룹이 사용됩니다.중단 메트릭 속성
introscope.agent.stalls.thresholdseconds
이 속성은 실행 중인 프로세스가 지체된 프로세스로 간주되기 전까지 허용되는 시간(초)을 지정합니다. "중단 수" 메트릭의 정확성을 보장하려면 중단 임계값을 15초 이상으로 설정해야 합니다. 이 설정을 통해 Enterprise Manager가 하베스트 주기를 완료하기까지 허용되는 시간을 지정할 수 있습니다.
기본값:
30초예:
introscope.agent.stalls.thresholdseconds=30참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.stalls.resolutionseconds
이 속성은 에이전트가 지체 발생 여부를 검사하는 빈도를 지정합니다. "중단 수" 메트릭의 정확성을 보장하려면 중단 레졸루션을 10초 이상으로 설정해야 합니다. 이 설정을 통해 Enterprise Manager가 하베스트 주기를 완료하기까지 허용되는 시간을 지정할 수 있습니다.
기본값:
10초예:
introscope.agent.stalls.resolutionseconds=10참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.스레드 덤프 속성
스레드 덤프 속성은 Introscope 스레드 덤프 기능의 에이전트 요소를 사용하도록 설정하고 구성합니다.
참고
: 스레드 덤프 크기에 허용되는 총 행 수는 100000개(최대 제한)입니다.introscope.agent.threaddump.enable
이 속성은 에이전트 JVM에서 스레드 덤프를 수집하도록 설정합니다. 또한 이 속성은 사용자가 "스레드 덤프" 탭을 볼 수 있도록 합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.threaddump.enable=true참고:
- 이 속성은 IntroscopeEnterpriseManager.properties 파일의 introscope.enterprisemanager.threaddump.enable 속성과 함께 작동합니다. true로 설정할 경우 이 속성은 Enterprise Manager 스레드 덤프 기능을 사용하도록 설정합니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.threaddump.deadlockpoller.enable
이 속성은 현재 에이전트 JVM 교착 상태 수를 표시하는 "Deadlock Count"(교착 상태 수) 메트릭을 활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.threaddump.deadlockpoller.enable=true참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.threaddump.deadlockpollerinterval
이 속성은 Introscope가 교착 상태가 된 스레드에 대해 에이전트 JVM을 폴링하는 빈도(밀리초)를 지정합니다.
값:
0보다 큰 정수기본값:
15000(밀리초)예:
introscope.agent.threaddump.deadlockpollerinterval=15000참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.트랜잭션 추적 속성
이 단원의 속성은 트랜잭션 추적 및 샘플링을 제어합니다.
introscope.agent.bizdef.turnOff.nonIdentifying.txn
비식별 트랜잭션의 추적을 사용하거나 사용하지 않도록 설정합니다.
이 속성을
IntroscopeAgent.profile
에서 false로 설정하면 비식별 트랜잭션에 대한 추적이 생성됩니다.CEM UI에서 비식별 트랜잭션을 사용하도록 설정해도 비식별 트랜잭션에 대한 추적은 기본적으로 생성되지 않습니다.
값:
true 또는 false기본값:
true예:
introscope.agent.bizdef.turnOff.nonIdentifying.txn=falseintroscope.agent.transactiontracer.parameter.httprequest.headers
이 속성은 캡처할 HTTP 요청 헤더 데이터를 쉼표로 구분된 목록으로 지정합니다. 쉼표로 구분된 목록을 사용하십시오.
기본값:
User-Agent예:
introscope.agent.transactiontracer.parameter.httprequest.headers=User-Agent참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.agent.transactiontracer.parameter.httprequest.parameters
이 속성은 캡처할 HTTP 요청 매개 변수 데이터를 쉼표로 구분된 목록으로 지정합니다.
기본값:
일반 매개 변수예:
introscope.agent.transactiontracer.parameter.httprequest.parameters=parameter1,parameter2참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.agent.transactiontracer.parameter.httpsession.attributes
이 속성은 캡처할 HTTP 세션 특성 데이터를 쉼표로 구분된 목록으로 지정합니다.
기본값:
일반 매개 변수예:
introscope.agent.transactiontracer.parameter.httpsession.attributes=attribute1,attribute2참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.agent.transactiontracer.userid.key
이 속성은 사용자 정의된 키 문자열을 지정합니다.
기본값:
일반 매개 변수예:
#introscope.agent.transactiontracer.parameter.httpsession.attributes=attribute1,attribute2참고:
- 사용 환경에서HttpServletRequest.getHeader또는HttpServletRequest.getValue를 사용하여 사용자 ID에 액세스하는 경우 값을 제공할 수 있습니다.
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.transactiontracer.userid.method
이 속성은 사용자 ID를 반환하는 메서드를 지정합니다.
값:
- HttpServletRequest.getRemoteUser
- HttpServletRequest.getHeader
- HttpServletRequest.getValue
기본값:
세 개의 허용 가능한 각 값에 대한 주석 처리된 속성 정의. 사용할 속성의 주석 처리를 제거할 수 있습니다.예:
introscope.agent.transactiontracer.userid.method=HttpServletRequest.getRemoteUser#introscope.agent.transactiontracer.userid.method=HttpServletRequest.getHeader#introscope.agent.transactiontracer.userid.method=HttpSession.getValue
참고:
- 이 속성은 기본적으로 주석으로 처리되어 있습니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.transactiontrace.componentCountClamp
트랜잭션 추적에서 허용되는 구성 요소 수를 제한합니다.
기본값:
5000중요!
클램프 크기가 늘어나면 메모리 요구 사항도 높아집니다. 심한 경우 에이전트의 최대 힙 크기를 조정해야 할 수 있습니다. 힙 크기를 조정하지 않으면 관리되는 응용 프로그램에 메모리가 부족할 수 있습니다.예:
introscope.agent.transactiontrace.componentCountClamp=5000참고:
- 클램프를 초과하는 트랜잭션 추적은 에이전트에서 삭제됩니다. 에이전트 로그 파일에는 경고 메시지가 로깅됩니다.
- 설정된 제한에 도달하면 로그에 경고가 나타나고 추적이 중지됩니다.
- 0은 올바른 값이아닙니다. introscope.agent.transactiontrace.componentCountClamp를 0으로 설정하지마십시오.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.crossprocess.compression
이 속성은 크로스 프로세스 트랜잭션 추적 데이터의 크기를 줄입니다.
값:
lzma, gzip, 없음기본값:
lzma예:
introscope.agent.crossprocess.compression=lzma참고:
- 이 옵션을 사용하면 에이전트 CPU 오버헤드가 늘어나지만 프로세스 간 헤더의 크기는 줄어듭니다.
- 압축이lzmagzip보다 효율적이지만 CPU를 더 많이 사용할 수 있습니다.
- .NET 에이전트는gzip옵션을 지원하지 않습니다. 상호 운용성이 필요한 경우에는gzip을 사용하지 마십시오.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.crossprocess.compression.minlimit
이 속성은 압축을 적용할 크로스 프로세스 매개 변수 데이터 길이에 대한 최소값을 지정합니다.
값:
0에서 introscope.agent.crossprocess.correlationid.maxlimit에 설정된 총 최대 제한값의 두 배까지 지정할 수 있습니다.기본값인 1500보다 작게 설정하면 압축이 보다 빈번히 실행되고 더 많은 CPU 오버헤드를 발생시킵니다. 기본 설정값인 1500은 일반적으로 정상적인 조건에서 CPU에 오버헤드를 발생시키지 않습니다.
기본값:
1500예:
introscope.agent.crossprocess.compression.minlimit=1500참고:
- introscope.agent.crossprocess.compression속성과 함께 사용됩니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.crossprocess.correlationid.maxlimit
이 속성은 크로스 프로세스 매개 변수 데이터의 최대 허용 크기를 지정합니다.
압축을 적용한 후에도 크로스 프로세스 매개 변수 데이터의 총 크기가 이 제한을 초과할 경우에는 두 가지 문제가 발생합니다. 일부 데이터가 드롭되고 일부 크로스 프로세스 상관 관계 기능이 제대로 작동하지 않습니다.
그러나 이 설정을 사용하면 너무 큰 헤더 크기로 인해 사용자 트랜잭션이 네트워크 전송 시 실패하지 않도록 보호됩니다.
기본값:
4096예:
introscope.agent.crossprocess.correlationid.maxlimit=4096참고:
- introscope.agent.crossprocess.compression및introscope.agent.crossprocess.compression.minlimit속성과 함께 사용됩니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.transactiontracer.sampling.enabled
이 속성은 트랜잭션 추적 프로그램 샘플링을 활성화하거나 비활성화합니다.
참고:
Enterprise Manager 속성 파일을 통해 트랜잭션 추적 프로그램 샘플링을 비활성화할 수 없습니다.값:
true 또는 false기본값:
true예:
introscope.agent.transactiontracer.sampling.enabled=false참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.transactiontracer.sampling.perinterval.count
이 속성은 지정한 간격 동안 추적할 트랜잭션의 수를 지정합니다.
이 속성은 에이전트에서 이 속성이 구성된 경우 Enterprise Manager에서
introscope.agent.transactiontracer.sampling.perinterval.count
구성을 비활성화합니다.기본값:
1예:
introscope.agent.transactiontracer.sampling.perinterval.count=1참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.transactiontracer.sampling.interval.seconds
이 속성은 지정한 트랜잭션 수를 추적할 시간을 지정합니다.
이 속성은 에이전트에서 이 속성이 구성된 경우 Enterprise Manager에서
introscope.agent.transactiontracer.sampling.interval.seconds
구성을 비활성화합니다.기본값:
120예:
introscope.agent.transactiontracer.sampling.interval.seconds=120참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.transactiontrace.headFilterClamp
이 속성은 헤드 필터링에 허용되는 최대 구성 요소 수준을 지정합니다. 헤드 필터링은 전체 트랜잭션을 수집하기 위해 트랜잭션의 시작을 검사하는 프로세스입니다. 헤드 필터링 기능은 첫 번째 Blame 관련 구성 요소가 나타날 때까지 각 구성 요소를 검사합니다. 심층 호출 스택을 사용하는 트랜잭션의 경우 클램프가 적용되지 않으면 이 검사가 문제가 될 수 있습니다. 이 클램프 값은 에이전트가 고정된 수준까지만 조회하도록 합니다. 그러면 메모리 및 CPU 사용률에 미치는 영향이 제한됩니다.
기본값:
30중요! 클램프 크기가 늘어나면 메모리 요구 사항도 높아집니다. 이 경우 가비지 수집 동작이 영향을 받으므로 응용 프로그램 전체 성능에 영향을 줍니다.
예:
introscope.agent.transactiontrace.headFilterClamp=30참고:
- 다른 메커니즘이 활성화된 경우에는 가능한 수집에 대해 클램프를 초과하는 수준의 트랜잭션 추적만 검사됩니다. 예를 들어 수집할 트랜잭션을 선택하기 위해 샘플링이나 사용자가 시작한 트랜잭션 추적이 활성화된 경우가 이에 해당합니다.
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.ttClamp
에이전트가 각 보고 주기마다 보고하는 트랜잭션의 수를 제한합니다.
값:
정수기본값:
50예:
introscope.agent.ttClamp=50참고:
- 이 속성이 설정되지 않으면(비어 있음) 기본값 50이 사용됩니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.weblogic.crossjvm
이 속성은 WebLogic Server에서 크로스 프로세스 추적을 구성합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.weblogic.crossjvm=true참고:
이 속성은 기본적으로 주석으로 처리되어 있습니다.introscope.agent.transactiontracer.tailfilterPropagate.enable
이 속성은 테일 필터가 있을 경우 다운스트림 에이전트에서 자동 추적 수집이 트리거되는지 여부를 제어합니다. 이 속성은 헤드 필터 전달로 인한 자동 다운스트림 추적의 수집에는 영향을 주지 않습니다.
이 속성을 사용하도록 설정한 상태에서 테일 필터가 포함된 트랜잭션 추적 세션을 오랫동안 실행하면 원치 않는 결과가 발생할 수 있습니다. 원치 않는 추적이 Enterprise Manager에 필요 이상으로 전송될 수 있습니다.
값:
true 또는 false기본값:
true예:
introscope.agent.transactiontracer.tailfilterPropagate.enable=false참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.URL 그룹 속성
이 섹션의 속성은 프런트엔드 메트릭을 위한 URL 그룹을 구성하는 데 사용됩니다.
introscope.agent.urlgroup.keys
이 속성은 프런트엔드 이름 지정에 대한 구성 설정을 지정합니다.
기본값:
default예:
introscope.agent.urlgroup.keys=default참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.urlgroup.group.default.charEncoding
이 속성은 정의하는 URL 그룹에 대한 문자 인코딩을 지정합니다.
요청에 문자 인코딩이 포함되지 않은 경우 CEM 비즈니스 트랜잭션 쿼리 및 게시 매개 변수 매칭을 위해 이 속성을 설정합니다.
기본값:
Null예:
introscope.agent.urlgroup.group.default.charEncoding=ISO-8859-1참고
:- introscope.agent.urlgroup.group.default.charEncoding속성의 값이 없을 경우 에이전트는 숨겨진introscope.agent.charEncoding속성의 값을 사용합니다. 에이전트 프로필을 검사하여introscope.agent.charEncoding이 추가 및 구성되었는지 여부를 확인할 수 있습니다.introscope.agent.charEncoding속성은 CA APM에 정의된 모든 에이전트 문자 인코딩에 전역적으로 적용됩니다.introscope.agent.urlgroup.group.default.charEncoding속성은 각 URL 그룹에 대한 로컬 설정으로만 적용됩니다.에이전트는 요청 매칭 시 문자 인코딩을 사용할 수 있으며 다양한 소스에서 문자 인코딩을 제공할 수 있습니다. 에이전트는 다음 순서로 문자 인코딩을 평가하고 사용합니다.
- 요청에서 제공된 문자 인코딩
- introscope.agent.urlgroup.group.default.charEncoding속성의 값
- introscope.agent.charEncoding속성의 값
- 문자 인코딩 UTF-8
- 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
introscope.agent.urlgroup.group.default.format
이 속성은 프런트엔드 이름 지정에 대한 구성 설정을 지정합니다.
,introscope.agent.urlgroup.group.default.format={path_delimited:/:0:5}
introscope.agent.urlgroup.keys=default
및 introscope.agent.urlgroup.group.default.pathprefix=*
인 경우 기본 URL 그룹화 기능은 Java URL 그룹의 URL 경로 중 포트 뒷부분에 두 개의 세그먼트를 제공합니다.기본값
: URL 경로 중 포트 뒷부분의 두 개 세그먼트예:
introscope.agent.urlgroup.group.default.format={path_delimited:/:0:5}참고:
관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.urlgroup.group.default.pathprefix
이 속성은 프런트엔드 이름 지정에 대한 구성 설정을 지정합니다.
기본값:
*
예:
introscope.agent.urlgroup.group.default.pathprefix=*introscope.agent.urlgroup.frontend.url.clamp
이 속성은 Java 에이전트가 생성하는 고유 프런트엔드 URL 그룹 메트릭의 수를 제한합니다. 새 URL 그룹의 수가 설정된 값에 도달하면 새 URL 그룹에 대한 메트릭은 메트릭 브라우저의
Frontends|Apps|URLs|Default
노드 아래에 표시됩니다. 이 속성은 메트릭 급증을 방지하는 데 유용합니다.기본값
: 5
예:
introscope.agent.urlgroup.frontend.url.clamp=5introscope.agent.urlgroup.frontend.url.resources.list
프런트엔드 URL 그룹에는 예를 들어 <
파일 이름
>.png의 png와 같은 특정 파일 확장명이 포함될 수 있습니다. 이러한 확장명을 리소스
라고 합니다. 이 속성은 파일 확장명 유형을 지정합니다. introscope.agent.urlgroup.frontend.url.resources.list
에 나열된 리소스가 프런트엔드 URL에 포함된 경우 해당 리소스는 Frontends|Apps|URLs|Resources
노드 아래에 표시됩니다. 리소스 URL 그룹은 잘못된 URL로 인해 고유한 1회성 메트릭이 생성되고 많은 양의 Enterprise Manager 메모리가 사용되는 것을 방지합니다. 잘못된 URL의 일반적인 예는 404 오류를 생성하는 URL입니다.
기본값
: tif,tiff,jpg,jpeg,gif,png,bmp,bmpf,ico,cur,xbm,svg,img,css,woff,nil예:
introscope.agent.urlgroup.frontend.url.resources.list=tif,tiff,jpg,jpeg,gif,png,bmp,bmpf,ico,cur,xbm,svg,img,css,woff,nilintroscope.agent.backendpathgroup.key
경로 그룹은 백엔드 URL 경로 접두사를 사용하여 정의한 웹 서비스 HTTP 클라이언트 요청의 그룹입니다.
경로 그룹 메트릭을 검사하여 백엔드에서 호출된 요청의 수를 확인하는 방법으로 성능 문제를 진단할 수 있습니다.
기본적으로 모든 백엔드 URL 경로는 default 그룹에 할당됩니다. 백엔드 경로 그룹 키는 메트릭 브라우저에 표시할 백엔드 URL 그룹 메트릭의 목록을 정의합니다. 경로 그룹 특성을 선언하는 다른 속성도 경로 그룹 키를 참조할 수 있습니다.
일부 경로가 여러 그룹에 속하도록 경로 그룹을 정의할 수 있습니다. 이 구성에서는 속성에서 경로 그룹에 대한 키를 나열하는 순서가 중요합니다. 그룹 구성원이 더 적은 경로 그룹은 그룹 구성원이 더 많은 경로 그룹보다 앞에 오도록 해야 합니다.
이 속성은
introscope.agent.backendpathgroup.group.default.pathprefix
및 introscope.agent.backendpathgroup.group.default.format
속성과 함께 사용됩니다.기본값:
default예:
introscope.agent.backendpathgroup.keys=default추가 정보
: 백엔드 경로 그룹 구성참고:
이 속성에 대한 변경 내용은 즉시 적용되므로 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.backendpathgroup.group.default.pathprefix
이 속성은 경로 접두사를 매칭할 패턴을 지정하여 경로 그룹에 속하는 요청을 정의합니다.
기본값:
*
예:
introscope.agent.backendpathgroup.group.default.pathprefix=*추가 정보
: 백엔드 경로 그룹 구성참고:
이 속성에 대한 변경 내용은 즉시 적용되므로 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.backendpathgroup.group.default.format
이 속성은 백엔드 이름 지정에 대한 구성 설정을 지정합니다. i
ntroscope.agent.backendpathgroup.group.default.format
,={path_delimited:/:0:5}
introscope.agent.backendpathgroup.key=default
및 introscope.agent.backendpathgroup.group.default.pathprefix=*
인 경우 기본 백엔드 경로 그룹화 기능은 Java 백엔드 경로의 URL 경로 중 포트 뒷부분에 두 개의 세그먼트를 제공합니다.기본값
: URL 경로 중 포트 뒷부분의 두 개 세그먼트기본값:
default예
: introscope.agent.backendpathgroup.group.default.format={path_delimited:/:0:5}추가 정보
: 백엔드 경로 그룹 구성참고:
이 속성에 대한 변경 내용은 즉시 적용되므로 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다. introscope.agent.backendpathgroup.group.backend.url.clamp
이 속성은 Java 에이전트가 생성하는 고유 백엔드 경로 그룹 메트릭의 수를 제한합니다. 새 URL 그룹의 수가 설정된 값에 도달하면 새 URL 그룹에 대한 메트릭은 메트릭 브라우저의
Backends|WebService at {프로토콜}_//{호스트}_{포트}|Paths|
Default
노드 아래에 표시됩니다. 이 속성은 메트릭 급증을 방지하는 데 유용합니다.기본값
: 5
예:
introscope.agent.backendpathgroup.group.backend.url.clamp=5WebSphere PMI 속성
introscope.agent.pmi.enable
이 속성은 WebSphere PMI에서 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.pmi.enable=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.pmi.enable.alarmManagerModule
이 속성은 true로 설정된 경우 PMI 경보 관리자 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.alarmManagerModule=false참고:
- 경고 관리자 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.beanModule
이 속성은 PMI bean 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.beanModule=falseintroscope.agent.pmi.enable.cacheModule
이 속성은 true로 설정된 경우 PMI 캐시 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.cacheModule=false참고:
- 캐시 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.connectionPoolModule
이 속성은 PMI
connectionPool
데이터의 수집을 활성화합니다.값:
true 또는 false기본값:
true예:
introscope.agent.pmi.enable.connectionPoolModule=trueintroscope.agent.pmi.enable.hamanagerModule
이 속성은 true로 설정된 경우 PMI 관리자 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.hamanagerModule=false참고:
- 관리자 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.j2cModule
이 속성은 true로 설정된 경우 PMI J2C 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.pmi.enable.j2cModule=true참고:
- J2C 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.jvmpiModule
이 속성은 PMI JVM PI 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.jvmpiModule=false참고:
이 모듈에 데이터가 제공되게 하려면 JVMPI가 WebSphere에서 설정되야 합니다.introscope.agent.pmi.enable.jvmRuntimeModule
이 속성은 PMI JVM 런타임 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.jvmRuntimeModule=false참고:
- 이 모듈에 데이터가 제공되도록 하려면 JVMPI가 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.objectPoolModule
이 속성은 true로 설정된 경우 PMI 개체 풀 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.objectPoolModule=false참고:
- 개체 풀 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.orbPerfModule
이 속성은 true로 설정된 경우 PMI
orbPerf
데이터의 수집을 활성화합니다.값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.orbPerfModule=false참고:
- orbPerf데이터 범주는 WebSphere에서 켜져 있어야만 Introscope 데이터로 표시됩니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.schedulerModule
이 속성은 true로 설정된 경우 PMI 스케줄러 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.schedulerModule=false참고:
- 스케줄러 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.servletSessionsModule
이 속성은 PMI
servletSessions
데이터의 수집을 활성화합니다.값:
true 또는 false기본값:
true예:
introscope.agent.pmi.enable.servletSessionsModule=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.pmi.enable.systemModule
이 속성은 true로 설정된 경우 PMI 시스템 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.systemModule=false참고:
- 시스템 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.threadPoolModule
이 속성은 true로 설정된 경우 PMI 스레드 풀 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.pmi.enable.threadPoolModule=true참고:
- 스레드 풀 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.transactionModule
이 속성은 PMI 트랜잭션 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.transactionModule=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.pmi.enable.webAppModule
이 속성은 PMI webApp 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.webAppModule=false
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.introscope.agent.pmi.enable.webServicesModule
이 속성은
true
로 설정된 경우 PMI 웹 서비스 데이터의 수집을 활성화합니다.값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.webServicesModule=false
참고:
- 웹 서비스 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.wlmModule
이 속성은 true로 설정된 경우 PMI WLM 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.wlmModule=false
참고:
- WLM 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.enable.wsgwModule
이 속성은 true로 설정된 경우 PMI WSGW 데이터의 수집을 활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.pmi.enable.wsgwModule=false
참고:
- WSGW 데이터 범주는 Introscope 데이터로서 표시되도록 WebSphere에서 켜져 있어야 합니다.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.
introscope.agent.pmi.filter.objrefModule
이 속성은 하드 코딩된 필터를 제어합니다.
objref
필터는 @xxxxx
로 끝나는 이름을 필터링합니다. 여기서 xxxxx
는 숫자입니다.값:
true 또는 false기본값:
false예:
introscope.agent.pmi.filter.objrefModule=false
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.WLDF 메트릭 속성
introscope.agent.wldf.enable
이 속성은 WLDF 메트릭을 수집하도록 설정합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.wldf.enable=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.