.NET 에이전트 속성 참조
.NET 에이전트 속성 파일은 IntroscopeAgent.profile(에이전트 프로필)이라는 이름으로 <.NET 홈> 디렉터리에 있습니다.
apmdevops104kr
.NET 에이전트 속성 파일은 IntroscopeAgent.profile(에이전트 프로필)이라는 이름으로 <
.NET 홈
> 디렉터리에 있습니다.참고:
모든 .NET 에이전트 속성은 온-프레미스 CA APM에 적용되고, 일부만 Application Performance Management(CA의 Digital Experience Insights)에 적용됩니다..NET 에이전트 프로필은
com.wily.introscope.agentProfile
환경 변수를 사용하여 에이전트 프로필 위치를 에이전트에 전달합니다.다음은 세 가지 주요 .NET 환경 변수입니다.
- com.wily.introscope.agentProfile=%{INSTALL_DIRECTORY}%\wily\IntroscopeAgent.profile이 변수는 .NET 에이전트 프로필 위치를 지정합니다.
- Cor_Enable_Profiling=0x1이 변수는 COR 프로파일링을 활성화합니다.
- COR_PROFILER={5F048FC6-251C-4684-8CCA-76047B02AC98}이 변수는 네이티브 COM 프로파일러 DLL의 GUID를 지정합니다. CLR EE는 레지스트리를 사용하여 프로파일러를 조회합니다.
2
2
.NET 에이전트와 Enterprise Manager 사이의 연결
이 속성은 에이전트가 SSL을 사용하여 Enterprise Manager에 연결하는 방법을 제어합니다.
agentManager.url.1
이 속성은 다음 설정을 지정합니다.
- 에이전트가 기본적으로 연결되는 Enterprise Manager를 실행하는 컴퓨터의 호스트 이름
- Enterprise Manager를 호스트하는 컴퓨터에서 에이전트로부터의 연결을 수신 대기하는 포트 번호
- SSL(통신 채널)
기본값:
localhost SSL(Secure Socket Layer) 프로토콜을 사용하는 경우 에이전트 연결을 수신 대기하는 기본 포트는 5443입니다.
예:
agentManager.url.1=ssl://localhost:5443
참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작하십시오.에이전트 장애 조치
에이전트와 기본 Enterprise Manager 사이의 연결이 끊어질 경우 다음 속성은 에이전트가 연결을 시도하는 백업 Enterprise Manager를 지정합니다. 또한 에이전트가 기본 Enterprise Manager에 대한 재연결을 시도하는 빈도도 지정합니다.
introscope.agent.enterprisemanager.connectionorder
이 속성은 에이전트와 기본 Enterprise Manager 간의 연결이 끊어질 경우 에이전트에서 사용하는 백업 Enterprise Manager의 연결 순서를 지정합니다.
속성 설정
에이전트가 연결할 수 있는 다른 Enterprise Manager의 이름
기본값:
DEFAULT 호스트 이름, 포트 번호 및 소켓 팩터리 속성으로 정의된 Enterprise Manager예:
introscope.agent.enterprisemanager.connectionorder=DEFAULT
참고:
- 쉼표로 구분된 목록을 사용하십시오.
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.agent.enterprisemanager.failbackRetryIntervalInSeconds
이 속성은 거부된 에이전트가 허용되는 Enterprise Manager에 재연결을 시도하는 시간 간격(초)을 지정합니다.
- 에이전트 프로필introscope.agent.enterprisemanager.connectionorder속성 값에 구성된 순서를 기반으로 하는 Enterprise Manager
- loadbalancing.xml 구성을 기반으로 하는 허용되는 모든 Enterprise Manager
에이전트는 Enterprise Manager에 연결할 수 없는 경우 다음과 같은 방식으로 연결을 처리합니다.
- 허용되는 다음 Enterprise Manager에 연결을 시도합니다.
- 허용되지 않는 Enterprise Manager에는 연결하지 않습니다.
참고:
loadbalancing.xml 구성 및 에이전트와 Enterprise Manager 간의 연결 구성에 대한 자세한 내용은 MOM 에이전트 부하 분산 구성을 참조하십시오.기본값
기본 간격은 120초입니다.
예:
introscope.agent.enterprisemanager.failbackRetryIntervalInSeconds=120
참고
이 속성의 변경 사항이 적용되도록 관리되는 응용 프로그램을 다시 시작하십시오.
이 속성은 기본적으로 주석으로 처리되어 있습니다.
이 속성은 에이전트가 다음 CA APM 구성 요소를 통과하여 연결할 수 있는 환경에 유용합니다.
- 클러스터
- 수집기 및 독립 실행형 Enterprise Manager
- 클러스터, 수집기 및 독립 실행형 Enterprise Manager의 조합
에이전트가 다른 클러스터의 Enterprise Manager에 연결할 수 있다고 가정하십시오. 다음 예에서는 이 속성이 설정되어 있지 않은 경우에 발생하는 결과를 보여 줍니다.
- 클러스터 1의 Enterprise Manager에 연결된 에이전트가 연결이 끊어집니다.
- 에이전트는 클러스터 2의 Enterprise Manager에 허용되지 않는 모드로 연결합니다.
- 에이전트는 클러스터 1의 허용되는 Enterprise Manager를 사용할 수 있게 되는 시기를 알 수 없습니다.
이 속성은 Enterprise Manager에 연결할 수 있게 될 때까지 에이전트가 허용되는 Enterprise Manager에 계속 연결을 시도하도록 합니다.
에이전트 메트릭 만료 처리 속성
에이전트 메트릭 만료 처리는 사용되지 않는 메트릭을 주기적으로 에이전트 메모리 캐시에서 제거합니다. 사용되지 않는 메트릭은 구성된 시간 동안 새 데이터를 보고하지 않은 메트릭입니다. 오래된 메트릭을 제거하면 에이전트 성능을 향상하고 발생할 수 있는 메트릭 급증을 방지할 수 있습니다.
참고:
에이전트가 시스템에서 처리할 수 있는 것보다 많은 메트릭을 보고하도록 구성된 경우 메트릭이 급증합니다. 너무 많은 메트릭이 보고되면 응용 프로그램 서버의 성능에 영향을 미칠 수 있습니다. 심한 경우 에이전트로 인해 서버가 작동하지 않게 될 수도 있습니다.그룹에 속한 메트릭은 그룹의 모든 메트릭이 제거 후보에 해당하는 경우에만 제거됩니다. 현재 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 인스턴스를 사용하십시오.에이전트 메트릭 만료 처리 구성
에이전트 메트릭 만료 처리는 기본적으로 사용됩니다. introscope.agent.metricAging.turnOn 속성을 사용하여 이 기능을 해제할 수 있습니다. 이 속성을 IntroscopeAgent.profile에서 제거하면 에이전트 메트릭 만료 처리가 기본적으로 해제됩니다.
에이전트 메트릭 만료 처리는 에이전트의 하트비트에 실행됩니다. 하트비트는 introscope.agent.metricAging.heartbeatInterval 속성을 사용하여 구성됩니다. 하트비트 빈도를 낮게 유지해야 합니다. 하트비트가 높으면 에이전트와 Introscope의 성능에 영향을 미칩니다.
각 하트비트 동안 특정 메트릭 집합이 확인됩니다. introscope.agent.metricAging.dataChunk 속성을 사용하여 메트릭 집합을 구성하십시오. 이 값이 높으면 성능에 영향을 미치므로 이 값을 낮게 유지하십시오. 기본값은 하트비트당 메트릭을 500개 확인합니다. 메트릭 500개 각각을 확인하여 제거 후보에 해당하는지 확인합니다. 예를 들어 에이전트 메모리의 메트릭이 총 10,000개 있는 경우 이 속성을 하트비트당 메트릭 500개 단위의 청크를 확인하도록 설정할 수 있습니다. 그러면 메트릭 10,000개를 모두 확인하는 데 더 오랜 시간이 걸리지만 성능에 미치는 영향은 적습니다. 반면, 이 속성을 더 높은 값으로 설정하면 10,000개의 메트릭 전체가 더 빨리 확인되지만 오버헤드는 높아질 수 있습니다.
메트릭에 새 데이터가 수신되지 않은 채 일정 기간이 지나면 해당 메트릭은 제거 후보가 됩니다. 이 기간은 introscope.agent.metricAging.numberTimeslices 속성을 사용하여 구성할 수 있습니다. 이 속성은 기본적으로 180000으로 설정됩니다. 메트릭이 제거 조건을 충족하면 해당 그룹의 모든 메트릭이 메트릭 제거 후보인지 확인하기 위한 검사가 수행됩니다. 이 요구 사항이 충족된 경우 메트릭이 제거됩니다.
introscope.agent.metricAging.turnOn
에이전트 메트릭 만료 처리를 설정하거나 해제합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.metricAging.turnOn=true참고:
이 속성의 변경 사항은 즉시 적용되며 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.introscope.agent.metricAging.heartbeatInterval
이 속성은 제거할 메트릭을 확인하는 시간 간격을 초 단위로 지정합니다.
기본값:
1800예:
introscope.agent.metricAging.heartbeatInterval=1800참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.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*참고:
이 속성의 변경 사항은 즉시 적용되며 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.에이전트 메트릭 클램프 속성
에이전트가 Enterprise Manager로 전송되는 메트릭의 수를 대략적으로 클램프하도록 구성할 수 있습니다. 생성된 메트릭 수가 속성 값을 초과하면 에이전트는 새 메트릭의 수집 및 전송을 중지합니다.
introscope.agent.metricClamp
이 속성은 에이전트가 Enterprise Manager로 전송되는 메트릭의 수를 대략적으로 클램프하도록 구성합니다.
기본값
5000
예:
introscope.agent.metricClamp=5000
참고
- 속성을 설정하지 않으면 기본적으로 50000개의 메트릭과 새 메트릭의 에이전트 클램프가 보고되지 않습니다.
- 속성 변경 사항이 적용되도록 관리되는 응용 프로그램을 다시 시작하십시오.
- 이 클램프 속성은 apm-events-thresholds-config.xml 파일에 있는 introscope.enterprisemanager.agent.metrics.limit 속성과 함께 작동합니다.introscope.enterprisemanager.agent.metrics.limit 클램프 값이 introscope.agent.metricClamp 값보다 먼저 트리거되면 Enterprise Manager가 에이전트 메트릭을 읽기는 하지만 Investigator 메트릭 브라우저 트리에서 해당 메트릭을 보고하지는 않습니다.introscope.agent.metricClamp 클램프 값이 introscope.enterprisemanager.agent.metrics.limit 클램프 값보다 먼저 트리거되면 에이전트에서 Enterprise Manager로의 메트릭 전송이 중지됩니다.
introscope.agent.simpleInstanceCounter.referenceTrackingLimit
SimpleInstanceCounter 메트릭은 각 클래스에 대해 생성되는 인스턴스 수를 추적합니다. 인스턴스 수가 너무 많으면 .NET 에이전트의 오버헤드가 크게 증가할 수 있습니다. 이 속성을 사용하면 각 클래스의 추적된 인스턴스 수를 제한할 수 있습니다.
값
정수
기본값
25000
예:
introscope.agent.simpleInstanceCounter.referenceTrackingLimit=25000
참고
이 속성에 대한 변경 사항은 즉시 적용되므로 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
에이전트 메모리 오버헤드 속성
상당한 에이전트 메모리 오버헤드는 극단적인 몇몇 경우에만 발생합니다. 일반적으로 메모리 소비를 줄이면 대신 응답 시간이 늘어날 수 있습니다. 그러나 각 응용 프로그램은 고유하며 메모리 사용량과 응답 시간 사이의 균형도 응용 프로그램 자체에 따라 달라질 수 있습니다.
introscope.agent.reduceAgentMemoryOverhead
이 속성은 사용할 에이전트 구성을 지정합니다. 에이전트 메모리 오버헤드를 줄이려면 주석 처리를 제거하십시오.
값:
true 또는 false기본값:
주석 처리됨, true예:
introscope.agent.reduceAgentMemoryOverhead=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.에이전트 이름 지정
에이전트 및 로그 파일의 자동 이름 지정 및 이름 지정과 관련된 작업을 제어할 수 있습니다.
introscope.agent.agentAutoNamingEnabled
이 속성은 .NET 에이전트 이름을 지정할 때 에이전트 자동 이름 지정을 사용할지 여부를 지정합니다.
값:
True 또는 False기본값:
True예:
introscope.agent.agentAutoNamingEnabled=true
참고
- 이 속성의 변경 사항을 적용하기 위해 관리되는 응용 프로그램을 다시 시작할 필요는 없습니다.
introscope.agent.agentAutoNamingMaximumConnectionDelayInSeconds
이 속성은 에이전트가 Enterprise Manager에 연결하기 전에 이름 지정 정보를 가져오기 위해 기다리는 최대 시간(초)을 지정합니다.
속성 설정
초 단위의 지연 시간을 나타내는 양의 정수입니다.
기본값
120초.
예:
introscope.agent.agentAutoNamingMaximumConnectionDelayInSeconds=120
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.agent.agentAutoRenamingIntervalInMinutes
이 속성은 에이전트 이름이 변경되었는지 여부를 확인하기 위해 에이전트를 검사하는 빈도를 지정합니다. 지정된 간격마다 에이전트는 이름이 변경되었는지 확인합니다.
속성 설정
해당 간격의 시간(분)을 나타내는 양의 정수입니다.
기본값
10분.
예:
introscope.agent.agentAutoRenamingIntervalInMinutes=10
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.agent.disableLogFileAutoNaming
이 속성은 에이전트 로그 파일의 자동 이름 지정을 비활성화할지 여부를 지정합니다. 기본적으로 에이전트가 자동 이름 지정을 사용하도록 구성된 경우, 해당 로그 파일 이름도 에이전트 이름 또는 타임스탬프를 사용하여 자동으로 지정됩니다. 이 속성을 true로 설정하면 기본 동작이 사용되지 않습니다.
속성 설정
참 또는 거짓
기본값
False
예:
introscope.agent.disableLogFileAutoNaming=false
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.agent.agentName
이 속성은 다른 모든 에이전트 이름 지정 방법이 실패하는 경우 에이전트에 사용할 이름을 지정합니다. 이 속성 값이 유효하지 않거나 프로필에서 속성이 삭제된 경우 기본 에이전트 이름은
Unknown Agent
입니다. 이 속성은 기본적으로 주석으로 처리되어 있습니다. 이 속성의 주석 처리를 제거하여 다른 에이전트 이름 지정 방법이 실패할 때 사용할 기본 에이전트 이름을 지정할 수 있습니다.속성 설정
다른 모든 방법으로 에이전트 이름을 결정할 수 없을 때 에이전트 이름으로 사용할 텍스트 문자열입니다.
기본값
AgentName
예:
introscope.agent.agentName=AgentName
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.agent.clonedAgent
이 속성은 동일한 컴퓨터에서 응용 프로그램의 동일한 복사본을 실행할 수 있도록 합니다. 동일한 컴퓨터에서 응용 프로그램의 동일한 복사본이 실행 중인 경우에는 이 속성을 true로 설정하십시오.
값:
true 또는 false기본값:
false예:
introscope.agent.clonedAgent=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.introscope.agent.display.hostName.as.fqdn
이 속성은 에이전트 이름이 FQDN(정규화된 도메인 이름)으로 표시되는지 여부를 지정합니다. FQDN을 사용하도록 설정하려면 이 속성 값을 'true'로 설정하십시오. 기본적으로 에이전트는 호스트 이름을 표시합니다.
속성 설정:
true 또는 false기본값:
false예:
introscope.agent.display.hostName.as.fqdn=false참고:
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
- Catalyst가 통합된 경우 이 속성을 'true'로 설정하십시오.
introscope.agent dotnet.appnaming.sitename.enabled
이 속성은 .NET 에이전트가 적절한 응용 프로그램 이름을 결정할 수 없는 경우에 한해 응용 프로그램 이름에 웹 사이트 이름을 사용할지 여부를 지정합니다. .NET 응용 프로그램이 루트 컨텍스트에 배포된 경우 응용 프로그램 도메인 이름은 루트 컨텍스트가 아니라 사이트 이름으로 결정됩니다.
속성 설정:
true 또는 false기본값:
trueintroscope.agent.dotnet.naming.sitename.enabled
이 속성은 에이전트 이름이 웹 사이트 이름과 동일하도록 합니다. 에이전트가 적절한 이름을 결정할 수 없는 경우 에이전트는 이 속성 값에 상관없이 웹 사이트 이름을 사용합니다.
속성 설정:
true 또는 false기본값:
false에이전트 기록(비즈니스 기록) 속성
에이전트에서 비즈니스 트랜잭션 기록을 처리하는 방식을 제어할 수 있습니다.
introscope.agent.bizRecording.enabled
이 속성은 에이전트의 비즈니스 트랜잭션 기록을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
true예:
introscope.agent.bizRecording.enabled=true참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.에이전트 스레드 우선 순위
에이전트 스레드의 우선 순위를 제어할 수 있습니다.
introscope.agent.thread.all.priority
이 속성은 에이전트 스레드의 우선 순위를 지정합니다.
속성 설정
값은 0(낮음)부터 4(높음)까지 설정할 수 있습니다
기본값
2
예:
introscope.agent.thread.all.priority=2
응용 프로그램 심사 맵 속성
에이전트 및 응용 프로그램 심사 맵 데이터를 위한 비즈니스 트랜잭션 기록을 구성할 수 있습니다.
introscope.agent.appmap.enabled
이 속성은 응용 프로그램 심사 맵의 모니터링 대상 코드 추적을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
false예:
introscope.agent.appmap.enabled=falseintroscope.agent.appmap.metrics.enabled
이 속성은 응용 프로그램 심사 맵 노드의 메트릭 추적을 활성화하거나 비활성화합니다.
값:
true 또는 false기본값:
주석 처리됨, false예:
introscope.agent.appmap.metrics.enabled=falseintroscope.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로 설정하면 에이전트 성능이 저하될 수 있습니다.
응용 프로그램 심사 맵 및 Catalyst 통합 속성
Catalyst 통합에 맞게 응용 프로그램 심사 맵을 구성할 수 있습니다.
정보 전송 기능 구성
이 속성은 Catalyst와의 통합을 위해 에이전트에서 추가 정보를 보내는 기능을 사용하거나 사용하지 않도록 설정합니다.
다음 단계를 따르십시오.
- 기본 IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.introscope.agent.appmap.catalystIntegration.enabled=<false|true> 행을 찾아 값을 다음과 같이 설정합니다.
- true이 설정은 Catalyst와의 통합을 위해 에이전트에서 추가 정보를 보내는 기능을 활성화합니다.
- false이 설정은 구성을 비활성화합니다.다음 예에서는 형식을 보여 줍니다.introscope.agent.appmap.catalystIntegration.enabled=false
참고:이 속성은 기본적으로 주석으로 처리되어 있습니다. - 파일을 저장하고 닫습니다.에이전트가 이 구성을 사용하도록 설정됩니다.
사용 가능한 네트워크 목록 구성
introscope.agent.primary.net.interface.name 속성은 Catalyst 통합을 위해 에이전트에서 사용하는 호스트 컴퓨터의 기본 네트워크 인터페이스 이름을 지정합니다. 이 속성의 구성을 변경할 수 있으며 변경 사항은 자동으로 적용됩니다.
참고
에이전트 로깅 수준이 DEBUG로 설정된 경우 구성에 사용할 수 있는 네트워크 인터페이스 이름에 대한 정보가 로그 파일에 나타납니다. 또는 이 속성에 대해 기본 네트워크 인터페이스 이름을 결정하기 위해 네트워크 인터페이스 유틸리티를 사용할 수 있습니다.다음 단계를 따르십시오.
- 기본 IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.
- introscope.agent.primary.net.interface.name= 행을 찾아 이름 값을 지정합니다.다음 예는 이름 형식을 나타냅니다.introscope.agent.primary.net.interface.name=eth4참고기본값은 정의되어 있지 않습니다. 이 속성이 설정되지 않은 경우 에이전트는 첫 번째 사용 가능한 네트워크 인터페이스를 기본 인터페이스로 지정합니다. 이 속성의 이름 값을 결정하기 위해 네트워크 인터페이스 유틸리티를 사용할 수 있습니다.
- (옵션) 하위 인터페이스 번호(0부터 시작)를 지정하여 여러 네트워크 주소를 사용할 수 있습니다.다음 예는 하위 인터페이스 번호 형식을 나타냅니다.introscope.agent.primary.net.interface.name=eth4.1
- 파일을 저장하고 닫습니다.프로필이 구성을 사용하도록 설정됩니다.
응용 프로그램 심사 맵 비즈니스 트랜잭션 POST 매개 변수 속성
POST 매개 변수와 대조하여 보다 복잡한 모니터링을 수행할 수 있도록 Local Product Shorts를 구성할 수 있습니다.
참고:
속성을 구성하기 전에 에이전트 기록이 작동하는 방식을 숙지하십시오.introscope.agent.bizdef.matchPost
이 속성은 POST 매개 변수와 일치되는 시기를 결정합니다.
속성 설정
이 속성의 유효한 설정은
never
, before
또는 after
입니다.- 에이전트 기능을 모두 사용하고 성능을 향상시키려는 경우에는 이 속성을never로 설정하십시오. 이 설정을 사용하면 응용 프로그램이 URL, 쿠키 또는 헤더 매개 변수를 사용하여 모든 비즈니스 트랜잭션을 식별할 수 있지만, POST 매개 변수를 통해서만 식별되는 비즈니스 트랜잭션은 매칭할 수 없습니다.
- 최대의 에이전트 성능을 얻으려면 이 속성을before로 설정하십시오. 이 설정을 사용하면 응용 프로그램에서 POST 매개 변수를 사용하여 일부 또는 모든 비즈니스 트랜잭션을 식별할 수 있지만, HTTP 양식 요청을 위해 서블릿 스트림에 직접 액세스할 수는 없습니다. 이 속성이before로 설정되어 있으면 새로 배포되는 응용 프로그램에서도 표준 API를 따라야 합니다.중요!이 속성을before로 설정하면 응용 프로그램에 악영향을 줄 수도 있습니다. 구현 전에 CA Technologies 담당자와 함께 이 속성 설정을 검토하십시오.
- 비즈니스 트랜잭션을 POST 매개 변수와 안전하게 일치시키되 에이전트 기능을 제한하려면 이 속성을after로 설정하십시오. 이 속성이after로 설정되어 있으면 에이전트는 프로세스에서 POST 매개 변수로 식별된 비즈니스 트랜잭션을 매핑하거나 이러한 비즈니스 트랜잭션에 대한 전체 메트릭 집합을 생성할 수 없습니다. 또한 이 설정은 다른 옵션에 비해 CPU 시간을 좀 더 소비하지만, POST 매개 변수 기능이 필요한 경우에는 가장 안전한 설정으로 간주됩니다. 이 설정을 사용하면 응용 프로그램에서 POST 매개 변수를 사용하여 일부 또는 모든 비즈니스 트랜잭션을 식별할 수 있지만, 서블릿 스트림에 대한 직접 액세스를 항상 금지할 수는 없습니다.
예:
introscope.agent.bizdef.matchPost=after
참고
- never- POST 매개 변수를 대조하지 않습니다. 이는 가장 빠른 옵션이지만 비즈니스 트랜잭션 구성 요소 일치가 부정확하게 될 수 있습니다.
- before- 서블릿이 실행되기 전에 POST 매개 변수를 대조합니다.
- after- 서블릿이 실행된 후에 POST 매개 변수 패턴을 대조합니다. 크로스 프로세스 매핑과 일부 메트릭은 사용할 수 없습니다. 이 매개 변수의 기본 설정입니다.
알려진 제한 사항
에이전트 기록을 사용하여 정의된 메트릭은 Investigator의 응용 프로그램 심사 맵에 표시됩니다. 에이전트 기록을 구성할 경우 정규식 사용과 관련하여 몇 가지 알려진 제한 사항이 있습니다. 대부분의 제한 사항은 POST 매개 변수와 관련이 있습니다.
알려진 제한 사항은 다음과 같습니다.
- POST 매개 변수 값에는 행 마침 표시(.)를 사용할 수 없습니다.
- POST 매개 변수 정의가 비즈니스 트랜잭션 정의에 종속된 경우 비즈니스 트랜잭션 구성 요소에 세 가지 메트릭만 제공됩니다. 해당 메트릭은 다음과 같습니다.
- 평균 응답 시간
- Responses Per Interval(간격당 응답 수)
- Errors Per Interval(간격당 오류 수)
- POST 매개 변수 정의가 비즈니스 트랜잭션 정의에 종속된 경우 트랜잭션 추적 구성 요소의 비즈니스 구성 요소 이름은 비즈니스 서비스, 비즈니스 트랜잭션 및 비즈니스 트랜잭션 구성 요소의 특정 이름이 아니라 일반 이름입니다. 이 내용은 일치하지 않는 POST 매개 변수 정의에 종속된 비즈니스 트랜잭션 정의에도 적용됩니다.
AutoProbe
에이전트가 AutoProbe와 상호 작용하는 방식을 제어할 수 있습니다.
중요:
다음 속성은 필수 매개 변수입니다. AutoProbe 속성을 설정하지 않거나 값이 올바르지 않으면 Introscope가 제대로 작동하지 않습니다.introscope.autoprobe.directivesFile
이 속성은 배포할 ProbeBuilder 지시문 파일(
.pbd
) 및 ProbeBuilder 목록 파일(.pbl
)을 지정합니다. 이 속성에 대해 나열된 파일에 따라 계측 대상 구성 요소가 결정됩니다. 이 속성은 필수 항목입니다.속성 설정
단일 항목 또는 쉼표로 구분된 항목 목록입니다. 목록에는 다음 정보의 조합이 포함될 수 있습니다.
- ProbeBuilder 지시문 파일(.pbd) 이름
- ProbeBuilder 목록 파일(.pbl) 이름
- hotdeploy디렉터리 이름(hotdeploy디렉터리에 있는.pbd파일은 에이전트 프로필을 편집하지 않아도 자동으로 로드됨)
목록에 추가하는 파일 이름의 절대 경로를 지정하거나,
IntroscopeAgent.profile
파일의 위치에 상대적인 경로를 사용하여 파일 이름을 지정할 수 있습니다.기본값
기본값 항목은 에이전트를 설치할 때 선택한 옵션에 따라 달라집니다.
예:
introscope.autoprobe.directivesFile=default-full.pbl,hotdeploy
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.autoprobe.enable
이 속성이 false로 설정되는 경우 다음과 같은 조건이 존재합니다.
- AutoProbe가 비활성화되었습니다.
- .NET 에이전트가 Enterprise Manager에 연결하지 않습니다.
- .NET 에이전트가 Investigator에 표시되지 않습니다.
- .NET 에이전트가 메트릭을 보고하지 않습니다.
속성 설정
값
true 또는 false
기본값
true
예:
introscope.autoprobe.enable=true
참고:
변경 내용을 적용하려면 에이전트를 다시 시작해야 합니다.introscope.autoprobe.logfile
계측 로그 파일의 이름과 위치입니다. 로그 파일의 위치를 기본값 이외의 다른 위치로 이동하려면 이 속성을 설정하십시오.
속성 설정
계측 로그 파일의 절대 또는 상대 경로입니다.
기본값
기본 위치는
디렉터리에 상대적인
logs\AutoProbe.log입니다.예:
introscope.autoprobe.logfile=logs/AutoProbe.log
로깅을 사용하지 않도록 설정하려면 로그 파일에서 다음과 같이 주석 처리하십시오.
introscope.autoprobe.logfile=logs/AutoProbe.log
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
CA CEM 에이전트 프로필 속성
CA CEM 관련 IntroscopeAgent.profile속성을 구성할 수 있습니다.
introscope.autoprobe.directivesFile
directivesFile 속성 구성을 통해 ServletHeaderDecorator / HTTPHeaderDecorator 및 CEMTracer를 사용하도록 설정해야 합니다.
지시문 파일 속성은 AutoProbe용 지시문 파일(PBD) 또는 지시문 목록(PBL)을 찾을 위치를 지정합니다.
AutoProbe는 응용 프로그램을 활성화하고 에이전트가 Enterprise Manager에 보고하는 메트릭을 결정하기 위해 지시문을 사용합니다.
설정
설치된 에이전트 응용 프로그램 서버에 따라 다르며, 형식은
<응용 프로그램 서버>
-full.pbl 또는 <응용 프로그램 서버>
-typical.pbl입니다.기본값
default-typical.pbl
예:
introscope.autoprobe.directivesFile=weblogic-typical.pbl
참고
단순히 이 속성 목록의 끝에 "ServletHeaderDecorator.pbd" 또는 "httpheaderdecorator.pbd"를 추가해도 되지만 다음 단계를 따르는 것이 더 좋습니다.
- 속성에 지정된 PBL 파일(위 예의 경우 weblogic-typical.pbl)을 찾습니다.
- PBL 파일을 텍스트 편집기에서 엽니다.
- Java 에이전트의 경우 ServletHeaderDecorator.pbd 행의 주석 처리를 제거하여 이 행을 활성화합니다.
- .NET 에이전트의 경우 httpheaderdecorator.pbd 행의 주석 처리를 제거하여 이 행을 활성화합니다.
- PBL 파일의 변경 사항을 저장합니다.
introscope.agent.decorator.enabled
이 부울 값이 true로 설정되어 있으면 에이전트가 HTTP 응답 헤더에 추가적인 성능 모니터링 정보를 추가하도록 구성됩니다. ServletHeaderDecorator / HTTPHeaderDecorator는 각 트랜잭션에 GUID를 연결하고 이 GUID를 HTTP 헤더 x-apm-info에 삽입합니다.
이렇게 하면 CA CEM과 Introscope 사이의 트랜잭션 상관 관계가 형성됩니다.
설정
true 또는 false
기본값
- Java 에이전트의 경우 false
- .NET 에이전트의 경우 false
참고:
이 속성은 Java 에이전트에 대한 핫 구성 속성입니다.예:
introscope.agent.decorator.enabled=false
introscope.agent.decorator.security
이 속성에 따라 CA CEM으로 전송되는 데코레이트된 HTTP 응답 헤더의 형식이 결정됩니다.
설정
- clear - 일반 텍스트 인코딩
- encrypted - 헤더 데이터가 암호화됨
기본값
암호화됨
예:
introscope.agent.decorator.security=encrypted
참고:
지원되는 버전은 제품 호환성 표를 참조하십시오.ChangeDetector 구성 속성
로컬 에이전트가 ChangeDetector와 함께 작동하는 방식을 제어할 수 있습니다.
introscope.changeDetector.enable
이 속성은 ChangeDetector의 활성화 여부를 지정합니다. ChangeDetector가 사용되도록 설정하려면 이 속성을 true로 설정합니다. 주석 처리되어 기본적으로 false로 설정되어 있습니다. ChangeDetector가 사용되도록 설정한 경우 ChangeDetector 관련 추가 속성도 설정해야 합니다.
속성 설정
참 또는 거짓
기본값
False
예:
introscope.changeDetector.enable=false
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.changeDetector.agentID
이 속성은 로컬 에이전트를 식별하기 위해 ChangeDetector가 사용하는 텍스트 문자열을 지정합니다. 이 속성은 기본적으로 주석으로 처리되어 있습니다. ChangeDetector를 활성화하는 경우 이 속성의 주석 처리를 제거하고 적절한 값으로 설정해야 합니다.
기본값
기본값은
SampleApplicationName
입니다.예:
introscope.changeDetector.agentID=SampleApplicationName
introscope.changeDetector.rootDir
이 속성은 ChangeDetector 파일의 루트 디렉터리를 지정합니다. 루트 디렉터리는 ChangeDetector가 해당 로컬 캐시 파일을 생성하는 폴더입니다.
속성 설정
ChangeDetector 파일의 루트 디렉터리에 대한 전체 경로를 나타내는 텍스트 문자열입니다.
기본값
기본 경로는 c:\\sw\\AppServer\\<
Agent_Home
>\\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
참고
백슬래시를 사용하여 백슬래시 문자를 이스케이프 처리하십시오.
크로스 프로세스 트랜잭션 추적
테일 필터로 인해 발생한 다운스트림 추적을 자동으로 수집하도록 설정할 수 있습니다. 이 속성을 사용하도록 설정한 상태에서 테일 필터가 포함된 트랜잭션 추적 세션을 오랫동안 실행하면 원치 않는 추적이 Enterprise Manager에 필요 이상으로 전송됩니다.
introscope.agent.transactiontracer.tailfilterPropagate.enable
테일 필터가 있을 경우 다운스트림 에이전트에서 자동 추적 수집이 트리거되는지 여부를 제어합니다. 이 속성은 헤드 필터 전달로 인한 자동 다운스트림 추적의 수집에는 영향을 주지 않습니다. 이 속성을 활성화한 상태에서 테일 필터가 포함된 트랜잭션 추적 세션을 오랫동안 실행하면 원치 않는 추적이 Enterprise Manager에 필요 이상으로 전송됩니다.
참고:
이 속성에 대한 자세한 내용은 TEC1219994를 참조하십시오.값:
true 또는 false기본값:
true예:
introscope.agent.transactiontracer.tailfilterPropagate.enable=false참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.기본 도메인 구성
기본 도메인이 Enterprise Manager에 연결하는 방법을 제어할 수 있습니다.
introscope.agent.dotnet.enableDefaultDomain
이 속성은 기본 도메인에 연결된 에이전트가 Enterprise Manager에 연결하는지 여부를 결정합니다.
속성 설정
참 또는 거짓
기본값
False
예:
introscope.agent.dotnet.enableDefaultDomain=false
참고
이 속성은 IntroscopeAgent.profile에 추가해야만 사용할 수 있습니다.
이 속성을 true로 설정하면 기본 도메인을 모니터링하는 에이전트도 Investigator에 함께 보고됩니다.
차이 분석
Web API 및 MVC 컨트롤러의 경우 기본적으로 차이 분석이 활성화되어 있습니다. 관리자는 다음을 수행할 수 있습니다.
- 차이 분석 비활성화
- 간격당 트랜잭션 수 제한
introscope.agent.da.trace.enabled
이 속성은 차이 분석을 활성화하거나 비활성화합니다.
속성 설정
참 또는 거짓
기본값
True
예:
introscope.agent.da.trace.enabled=false
introscope.agent.da.trace.maxTransactionsAnalyzedPerInterval
15초 간격당 분석되는 트랜잭션의 수를 제한합니다.
속성 설정
음이 아닌 정수
기본값
4
예:
introscope.agent.da.trace.maxTransactionsAnalyzedPerInterval=3
동적 계측 속성
사용자 지정 PBD를 작성하거나 응용 프로그램 서버를 다시 시작하거나 에이전트를 다시 시작하지 않고도 클래스 및 메서드를 동적으로 계측할 수 있도록 설정할 수 있습니다.
introscope.agent.remoteagentdynamicinstrumentation.enabled
이 속성은 동적 계측의 원격 관리를 사용하거나 사용하지 않도록 설정합니다.
속성 설정
참 또는 거짓
기본값
True
예:
introscope.agent.remoteagentdynamicinstrumentation.enabled=true
참고
- 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작합니다.
- 동적 계측은 CPU를 많이 사용하는 작업입니다. 계측되는 클래스를 최소화하는 구성을 사용하십시오.
- 동적 계측을 사용하도록 설정한 경우 In-Process Side-by-Side 실행과 같이 동일한 프로세스 내에서 여러 CLR를 모니터링하는 기능은 작동하지 않습니다. 자세한 내용은 com.wily.introscope.nativeprofiler.monitor.inprocsxs.multiple.clrs 속성을 참조하십시오.
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
이 속성은 에이전트가 로드할 모든 확장의 위치를 지정합니다. 디렉터리의 절대 또는 상대 경로를 지정할 수 있습니다. 절대 경로를 지정하지 않을 경우, 지정한 값은 IntroscopeAgent.profiles 파일의 위치를 기준으로 확인됩니다.
기본값:
/ext 디렉터리의 e
xt 디렉터리 예:
introscope.agent.extensions.directory=../ext참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.필터링된 매개 변수
필터링된 매개 변수 수집을 활성화할 수 있습니다.
introscope.agent.asp.disableHttpProperties
기본적으로 .NET 에이전트는 추적하는 트랜잭션의 URL만 보고합니다. 개별 HTTP 속성을 보고하는 기능은 트랜잭션 추적이 시스템 오버헤드에 미치는 영향을 최소화하도록 제한됩니다.
필터링을 사용하려면 먼저 이 속성을 false로 설정하여 HTTP 속성의 수집을 설정해야 합니다.
이 속성은 응용 프로그램 이름, 세션 ID, 컨텍스트 경로, 서버 이름, URL, 컨텍스트 경로, 정규화된 URL, HTTP 헤더, HTTP 매개 변수, HTTP 특성의 수집을 활성화합니다.
속성 설정
값
참 또는 거짓
기본값
False
예:
#introscope.agent.asp.disableHttpProperties=false
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
HTTP 백엔드 경로 그룹 속성
이 섹션의 속성은 백엔드 메트릭을 위한 HTTP 백엔드 경로 그룹을 구성하는 데 사용됩니다.
introscope.agent.backendpathgroup.keys
경로 그룹은 HTTP 백엔드 URL 경로 접두사를 사용하여 정의한 웹 서비스 HTTP 클라이언트 요청의 그룹입니다.
경로 그룹 메트릭을 검사하여 HTTP 백엔드에서 호출된 요청의 수를 확인하는 방법으로 성능 문제를 진단할 수 있습니다.
기본적으로 모든 HTTP 백엔드 URL 경로는
Default
그룹에 할당됩니다. HTTP 백엔드 경로 그룹 키는 메트릭 브라우저에 표시할 HTTP 백엔드 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
이 속성은 경로 그룹에 대한 응답 시간 메트릭이 생성될 때 사용되는 이름을 결정합니다. 일반적으로
introscope.agent.backendpathgroup.group.default.format
속성은 경로의 이름으로 텍스트 문자열을 할당하는 데 사용됩니다. 기본값:
default예:
introscope.agent.backendpathgroup.group.default.format=Default참고:
이 속성에 대한 변경 내용은 즉시 적용되므로 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.HTTP Header Decorator
CA CEM의 통합 솔루션의 일부인 Servlet Header Decorator를 사용할 수 있습니다.
introscope.agent.decorator.enabled
이 부울 값이 true로 설정되어 있으면 에이전트가 HTTP 응답 헤더에 추가적인 성능 모니터링 정보를 추가하도록 구성됩니다.
HTTPHeaderDecorator는 각 트랜잭션에 GUID를 연결하고 해당 GUID를 HTTP 헤더인 x-wily-info에 삽입합니다. 이렇게 하면 CA CEM과 Introscope 사이의 트랜잭션 상관 관계가 형성됩니다.
속성 설정
참 또는 거짓
기본값
False
예:
introscope.agent.decorator.enabled=false
로깅
introscope.agent.log.config.path
이 속성은 Log4Net 구성 파일을 가리킵니다.
속성 설정
기본값
logging.config.xml
예:
introscope.agent.log.config.path=logging.config.xml
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
NativeProfiler
다음 속성을
IntroscopeAgent.profile
에 설정하여 NativeProfiler 작업을 제어할 수 있습니다. 이러한 속성은 Native Image Generator를 사용하여 만든 응용 프로그램의 모니터링, 클래스 이름을 저장할 메모리 내 캐시의 크기 및 NativeProfiler 로그 파일의 위치와 내용을 제어합니다.introscope.nativeprofiler.clrv4.transparency.checks.disabled
.NET 4 CLR은 프로파일러에 의해 계측된 코드를 무료화할 수 있는 transparent 어셈블리를 검사합니다. 이 검사를 비활성화하려면 이 속성의 값을 “true”로 설정하십시오.
속성 설정
true 또는 false
기본값
true
예:
#introscope.nativeprofiler.clrv4.transparency.checks.disable=true
참고:
이 값을 적용하려면 IIS를 다시 설정해야 합니다.introscope.nativeprofiler.logfile
NativeProfiler가 읽는 지시문 및 NativeProfiler가 계측하는 메서드에 대한 정보를 기록하는 로그 파일의 경로를 설정합니다.
속성 설정
파일 위치의 절대 또는 상대 경로입니다.
기본값
logs/nativeprofiler.log
예:
introscope.nativeprofiler.logfile=logs/nativeprofiler.log
참고
NativeProfiler는 읽을 대상 PBD 및 PBL에서 활성 상태의 모든 지시문에 대한 정보를 기록하고, 계측된 구체적인 메서드도 참조용으로 기록합니다.
introscope.nativeprofiler.logBytecode
NativeProfiler가 계측된 바이트 코드를 나열할지 여부를 결정합니다. 이 속성이 true로 설정되어 있으면 NativeProfiler 로그 파일에 계측된 바이트 코드가 나열됩니다. 이 속성은 기본적으로 false로 설정되고 주석 처리되어 있습니다.
속성 설정
참 또는 거짓
기본값
False
예:
#introscope.nativeprofiler.logBytecode=false
참고
이 속성은 기본적으로 주석으로 처리되어 있습니다.
introscope.nativeprofiler.logAllMethodsNoticed
이 속성이 사용되도록 설정된 경우 계측되지 않은 메서드를 비롯하여 NativeProfiler가 인식하는 모든 메서드를 로깅합니다.
속성 설정
참 또는 거짓
기본값
False
예:
introscope.nativeprofiler.logAllMethodsNoticed=false
참고
기본적으로 사용되지 않도록 설정됩니다.
introscope.nativeprofiler.directivematching.cache.max.size
이 속성은 에이전트의 메모리 내 캐시에 저장되는 클래스 이름의 최대 수를 지정합니다. 기본적으로 에이전트는 모니터링할 클래스가 포함된 지시문 그룹을 찾으면 해당 지시문 그룹의 캐시를 메모리 내에 생성합니다. 에이전트는 사용자가 IIS를 시작할 때마다 이전에 발견된 클래스의 캐시를 생성합니다. 모니터링할 새로운 클래스를 응용 프로그램 코드에서 사용함에 따라 캐시가 증가합니다. 메모리 내 캐시에는 기본적으로 최대 5000개의 클래스 이름이 저장됩니다.
이 속성의 값을 늘리면 캐시에 클래스 이름을 5000개 이상 저장해야 할 경우 시작 시간을 개선할 수 있습니다. 하지만 값을 늘리면 에이전트에 필요한 메모리 오버헤드가 증가할 수 있습니다. 속성 값을 줄이면 에이전트의 메모리 오버헤드도 감소합니다. 5000개보다 적은 클래스를 모니터링할 경우 값을 줄이는 것이 좋습니다.
참고:
이 캐시에는 클래스 개체가 저장되지 않습니다.기본값
기본적으로 클래스 이름을 최대 5000개까지 저장할 수 있는 캐시가 설정됩니다.
예:
introscope.nativeprofiler.directivematching.cache.max.size=5000
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.nativeprofiler.generic.agent.trigger.enabled
이 속성을 사용하면 일반 트리거를 통해 .NET 에이전트를 시작할 수 있습니다. 이 속성을 사용하도록 설정하면 에이전트는 첫 번째 사용자 코드가 실행된 후 일반 트리거를 사용하여 시작됩니다. 이 작업은 제한 가능한 기본 도메인 프로브를 시작합니다. 이 속성을 사용하지 않도록 설정하면 에이전트는 IIS가 실행 중일 때 기본 메서드 또는 시작 메서드를 사용하여 시작됩니다.
속성 설정
참 또는 거짓
기본값
False
예:
introscope.nativeprofiler.generic.agent.trigger.enabled=true
참고
- 이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
- ProcSxS에서는 에이전트 이름이 다음과 같이 나타납니다.<ProcessName>_<ApplicationDomainName>
com.wily.introscope.nativeprofiler.monitor.inprocsxs.multiple.clrs
CLR(공용 언어 런타임) 버전이 여러 개인 경우에 에이전트가 모니터링 작업을 처리하는 방법을 제어합니다. 기본적으로 에이전트는 가장 먼저 로드된 CLR 버전에 따라 .NET Framework 버전을 하나만 모니터링합니다. 이 속성을 사용하면 기본 동작을 수정하고 .NET Framework 4 구성 요소를 모니터링할지 여부를 지정할 수 있습니다.
속성 설정
유효한 값은 다음과 같습니다.
- 없음 --기본 동작을 사용하고 모니터링할 .NET Framework 버전을 먼저 로드된 CLR에 따라 선택하도록 지정합니다.
- V4-- .NET Framework 4 구성 요소만 모니터링하도록 지정합니다. v4.0.3031과 같이 CLR 버전 번호를 지정할 수도 있습니다.
기본값
없음
이 값은 .NET Framework 버전 하나만 모니터링함을 나타냅니다. 모니터링되는 .NET Framework 버전은 먼저 로드된 응용 프로그램에 따라 결정됩니다.
예:
com.wily.introscope.nativeprofiler.monitor.inprocsxs.multiple.clrs=v4
참고
이 속성의 변경 내용을 적용하려면 응용 프로그램을 다시 시작해야 합니다.
성능 모니터 데이터 수집
성능 모니터 카운터에서 데이터를 수집하는 작업을 제어하도록 속성을 구성할 수 있습니다.
introscope.agent.perfmon.metric.filterPattern
이 속성은 모니터링할 성능 모니터 카운터와 일치하는 간단한 문자열을 지정합니다.
속성 설정
일치하는 성능 모니터 카운터 이름을 찾기 위한 텍스트 문자열입니다. 프로세스별 스레드 메트릭 같은 새로운 카운터를 추가하려면 목록 맨 끝에 새 문자열을 쉼표로 구분하여 추가합니다. 허용되는 유일한 와일드카드는 별표(*)입니다. 예:
...,|Thread|{osprocessname}*|*
기본값
기본 필터는 프로세서, .NET Data Provider, .NET CLR 및 ASP.NET 성능 모니터 카운터, 개체 및 인스턴스를 모니터링합니다.
예:
introscope.agent.perfmon.metric.filterPattern=|Processor|*|*,|.NET Data Provider*|*|*,|.NET CLR*|{osprocessname}|*,|.NET CLR Data|*|*,|Process|{osprocessname}|*,|ASP.NET|*
참고
|*|* 필터를 사용하면 모든 카운터를 인스턴스가 없는 것으로 열거하도록 성능 모니터에 지시하는 것과 같습니다. 일부 카운터에 대해서는 이 설정을 사용할 수 없습니다.
이 속성은 기본 LongCounter 메트릭 유형 대신 LongAverage 메트릭 유형을 사용하여 성능 모니터 메트릭에 대한 성능 카운터 이름 패턴을 지정합니다.
성능 모니터 메트릭은 LongCounter로 보고되며, 시간별로 집계될 경우 해당 기간에서 가장 높은 값이 집계 값으로 사용됩니다. 이 동작은 "Processor:% Processor Time"(프로세서: % 프로세서 시간)과 같은 일부 성능 모니터 메트릭에는 비직관적입니다. IntroscopeAgent.profile의 에이전트 속성 introscope.agent.perfmon.metric.filterPattern.average를 사용하면 이러한 메트릭을 평균 값으로 집계하도록 지정할 수 있습니다.
속성 설정
일치하는 성능 카운터 이름을 찾기 위한 텍스트 문자열 식입니다. 이 속성은 평균 값으로 보고할 성능 모니터 메트릭에 대한 성능 카운터 이름 식을 지정합니다. 와일드카드는 처음 또는 끝에서만 사용할 수 있습니다. 예를 들어 */sec는 "/sec"로 끝나는 모든 성능 카운터 이름을 찾습니다. 프로세스별 스레드 메트릭에 대한 카운터 이름과 같이 새로운 성능 카운터 이름을 추가하려면 목록 맨 끝에 새 식을 쉼표로 구분하여 추가하십시오. 예: ...,|Thread|{osprocessname}*|*
기본값
기본 속성 값은 이름에 "Avg"(평균)가 포함된 카운터와 같이, 해당 메트릭 이름에 대한 평균 값을 가져야 하는 일부 성능 모니터 카운터에 대한 이름 식을 지정합니다. 이 속성은 기본적으로 사용하지 않도록 설정됩니다.
예:
introscope.agent.perfmon.metric.filterPattern.average=*/sec,Avg*,%*,*Length,Connections*,*Connections,*Rate,*Time,*Current Bandwidth,*Free Megabytes,*Running
참고
|*|* 필터를 사용하면 모든 카운터를 인스턴스가 없는 것으로 열거하도록 성능 모니터에 지시하는 것과 같습니다. 일부 카운터에 대해서는 이 설정을 사용할 수 없습니다.
introscope.agent.perfmon.metric.limit
이 속성은 각 간격에 보고할 수 있는 성능 모니터 메트릭의 최대 수를 지정합니다.
기본값
기본값은 메트릭 1000개입니다.
예:
introscope.agent.perfmon.metric.limit=1000
introscope.agent.perfmon.metric.pollIntervalInSeconds
이 속성은 Performance Monitor Collection Agent가 성능 모니터 개체, 카운터 및 인스턴스에서 새 메트릭 값을 확인하는 빈도를 지정합니다. 기본 폴링 간격은 15초이며 모든 메트릭 값을 확인합니다.
기본값
기본 간격은 15초입니다.
예:
introscope.agent.perfmon.metric.pollIntervalInSeconds=15
introscope.agent.perfmon.category.browseEnabled
이 속성은 새 성능 모니터 카운터에 대한 검색을 활성화하거나 비활성화합니다.
속성 설정
참 또는 거짓
기본값
True(사용)
예:
introscope.agent.perfmon.category.browseEnabled=true
참고:
w3wp.exe는 이 속성의 예외입니다.introscope.agent.perfmon.category.browseIntervalInSeconds
Performance Monitor Collection Agent가 새 성능 모니터 개체를 검색하는 빈도를 결정합니다.
속성 설정
간격(초)을 나타내는 양의 정수입니다.
기본값
기본 간격은 600초(10분)입니다.
예:
introscope.agent.perfmon.category.browseIntervalInSeconds=600
프로세스 이름
프로세스 이름을 정의하도록 속성을 구성할 수 있습니다.
introscope.agent.customProcessName
이 속성은 Enterprise Manager와 Workstation에 표시할 프로세스 이름을 지정합니다. 이 속성의 주석 처리를 제거하고 Enterprise Manager 및 Workstation에 나타나는 사용자 지정 이름으로 프로세스 이름을 정의합니다.
기본값
CustomProcessName
예:
#introscope.agent.customProcessName=CustomProcessName
참고
이 속성은 기본적으로 주석으로 처리되어 있습니다.
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
introscope.agent.defaultProcessName
사용자 지정 프로세스 이름이 정의되지 않았고 에이전트가 기본 응용 프로그램 클래스의 이름을 확인할 수 없으면 기본 프로세스 이름이 사용됩니다.
기본값
.NET 프로세스
예:
introscope.agent.defaultProcessName=.NET Process
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
계측 구성 제한
프로세스 또는 실행 파일 대상 집합에 대한 계측을 구성할 수 있습니다.
introscope.agent.dotnet.monitorApplications
이 속성은 계측할 프로세스 및 응용 프로그램을 지정합니다.
옵션
정규화된 경로는 지원되지 않습니다. 응용 프로그램 실행 파일의 프로세스 이미지 이름만 사용하십시오. 이름은 대소문자를 구분하며 Windows 프로세스 관리에 보고되는 이름과 정확히 일치해야 합니다.
기본값
w3wp.exe,aspnet_wp.exe
예:
introscope.agent.dotnet.monitorApplications=w3wp.exe,aspnet_wp.exe,dllhost.exe
introscope.agent.dotnet.monitorAppPools
이 속성은 계측할 응용 프로그램 풀을 지정합니다.
옵션
이 속성의 주석 처리를 제거하고 계측할 IIS 응용 프로그램 풀을 지정합니다.
기본값
"NULL","DefaultAppPool","AppPool1","AppPool2"
예:
#introscope.agent.dotnet.monitorAppPools= "NULL","DefaultAppPool","AppPool1","AppPool2"
참고
- 응용 프로그램 풀 이름은 따옴표로 묶어야 합니다. 어떠한 응용 프로그램 풀에서도 실행되지 않도록 응용 프로그램을 지정하려면 "NULL"을 사용하십시오.
- 주석 처리된 상태로 두어 모든 응용 프로그램 풀을 계측하거나, 주석 처리를 제거하고 계측하려는 응용 프로그램 풀만 나열하십시오.
소켓 메트릭
다음 속성은 소켓 메트릭의 생성을 제어합니다.
introscope.agent.sockets.reportRateMetrics
이 속성은 개별 소켓의 입력/출력 대역폭 속도 메트릭을 보고하도록 설정합니다.
속성 설정
참 또는 거짓
기본값
True
예:
introscope.agent.sockets.reportRateMetrics=true
참고
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.
SQL 에이전트
다음은 SQL 에이전트에 사용되는 속성입니다.
introscope.agent.sqlagent.sql.maxlength
Investigator 트리에 SQL 에이전트 메트릭에 대해 표시되는 SQL 문의 바이트 단위 크기를 제한합니다.
기본값
기본 제한은 990바이트입니다.
예:
introscope.agent.sqlagent.sql.maxlength=990
참고
이 속성은 기본적으로 IntroscopeAgent.profile에 표시되지 않습니다. 속성을 에이전트 프로필에 추가하여 값을 변경할 수 있습니다.
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.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로 설정되어 있으면 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.normalizer.regex.matchFallThrough
이 속성은 정규식 SQL 문 노멀라이저를
introscope.agent.sqlagent.normalizer.extension
속성과 함께 설정합니다. 이 속성이 true로 설정되어 있으면 SQL 문자열이 모든 regex 키 그룹과 비교하여 평가됩니다.구현은 체인으로 연결됩니다. 예를 들어 SQL이 여러 키 그룹과 일치하는 경우 group1의 정규화된 SQL 출력이 group2에 대한 입력으로 제공되는 방식으로 처리됩니다.
이 속성이 false로 설정되어 있으면 키 그룹이 일치하는 즉시 해당 그룹의 정규화된 SQL 출력이 반환됩니다.
값:
true 또는 false기본값:
false예:
introscope.agent.sqlagent.normalizer.regex.matchFallThrough=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
이 속성은 에이전트에서 Enterprise Manager로 보다 적은 메트릭을 전송하기 위해 SQL 문 메트릭을 해제할 수 있는지 여부를 지정합니다. 이 속성 값이 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"
지체 메트릭
다음 섹션에서는 지체 메트릭과 관련된 속성을 정의합니다.
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.agent.crossprocess.compression
크로스 프로세스 트랜잭션 추적 데이터의 크기를 줄입니다.
값:
lzma, gzip, 없음기본값:
lzma예:
introscope.agent.crossprocess.compression=lzma참고:
- 이 옵션을 사용하면 에이전트 CPU 오버헤드가 늘어나지만 프로세스 간 헤더의 크기는 줄어듭니다.
- lzma압축이gzip보다 효율적이지만 CPU를 더 많이 사용할 수 있습니다.
- .NET 에이전트는gzip옵션을 지원하지 않으므로 상호 운용성이 필요한 경우에는gzip을 사용하면 안 됩니다.
- 이 속성은 동적 속성입니다. 런타임 동안 이 속성의 구성을 변경할 수 있으며, 변경 사항은 자동으로 선택됩니다.
introscope.agent.crossprocess.correlationid.maxlimit
이 속성은 크로스 프로세스 매개 변수 데이터의 최대 허용 크기를 지정합니다.
크로스 프로세스 매개 변수 데이터의 총 크기가 이 제한보다 큰 경우에는 압축을 적용한 후에도 일부 데이터가 드롭되고 일부 크로스 프로세스 상관 관계 기능이 제대로 작동하지 않습니다.
그러나 이 설정을 사용하면 너무 큰 헤더 크기로 인해 사용자 트랜잭션이 네트워크 전송 시 실패하지 않도록 보호됩니다.
기본값:
4096예:
introscope.agent.crossprocess.correlationid.maxlimit=4096참고:
- introscope.agent.crossprocess.compression 및 introscope.agent.crossprocess.compression.minlimit 속성과 함께 사용됩니다.
- 이 속성은 동적 속성입니다. 런타임 동안 이 속성의 구성을 변경할 수 있으며, 변경 사항은 자동으로 선택됩니다.
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.transactiontrace.componentCountClamp
트랜잭션 추적에서 허용되는 구성 요소 수를 제한합니다.
기본값:
5000중요!
클램프 크기가 늘어나면 메모리 요구 사항도 높아집니다.예:
introscope.agent.transactiontrace.componentCountClamp=5000참고:
- 클램프를 초과하는 트랜잭션 추적은 에이전트에서 삭제되고 에이전트 로그 파일에 경고 메시지가 로깅됩니다.
- 이 속성은 동적 속성입니다. 런타임 동안 이 속성의 구성을 변경할 수 있으며, 변경 사항은 자동으로 선택됩니다.
- 설정된 제한에 도달하면 로그에 경고가 나타나고 추적이 중지됩니다.
- 0은 올바른 값이아닙니다. introscope.agent.transactiontrace.componentCountClamp를 0으로 설정하지마십시오.
introscope.agent.transactiontrace.headFilterClamp
이 속성은 헤드 필터링에 허용되는 최대 구성 요소 수준을 지정합니다. 헤드 필터링은 전체 트랜잭션을 수집하기 위해 트랜잭션의 시작을 검사하는 프로세스입니다. 헤드 필터링 기능은 첫 번째 Blame 관련 구성 요소가 나타날 때까지 각 구성 요소를 검사합니다. 매우 깊은 심층 호출 스택을 사용하는 트랜잭션의 경우 클램프가 적용되지 않으면 구성 요소의 깊이가 너무 깊을 때 문제가 될 수 있습니다. 클램프 값은 에이전트가 고정된 수준까지 조회하도록 하여 이 동작이 메모리 및 CPU 사용률에 미치는 영향을 제한합니다.
기본값:
30경고!
클램프 크기가 늘어나면 메모리 요구 사항도 높아집니다. 이 경우 가비지 수집 동작이 영향을 받으므로 응용 프로그램 전체 성능에 영향을 줍니다.예:
introscope.agent.transactiontrace.headFilterClamp=30참고:
- 이 속성의 변경 사항은 즉시 적용되며 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
- 수집할 트랜잭션을 선택하기 위한 다른 메커니즘이 활성화된경우에는가능한 수집에 대해 클램프를 초과하는 수준의 트랜잭션 추적만 검사됩니다. 다른 메커니즘에는 샘플링이나 사용자가 시작한 트랜잭션 추적 등이 포함됩니다.
introscope.agent.transactiontracer.parameter.httprequest.headers
이 속성은 캡처할 HTTP 요청 헤더 데이터를 쉼표로 구분된 목록으로 지정합니다. 쉼표로 구분된 목록을 사용하십시오.
기본값:
주석 처리됨, User-Agent예:
introscope.agent.transactiontracer.parameter.httprequest.headers=User-Agentintroscope.agent.transactiontracer.parameter.httprequest.parameters
이 속성은 캡처할 HTTP 요청 매개 변수 데이터를 쉼표로 구분된 목록으로 지정합니다.
기본값:
주석 처리됨, 일반 매개 변수예:
introscope.agent.transactiontracer.parameter.httprequest.parameters=parameter1,parameter2introscope.agent.transactiontracer.parameter.httpsession.attributes
이 속성은 캡처할 HTTP 세션 특성 데이터를 쉼표로 구분된 목록으로 지정합니다.
기본값:
주석 처리됨, 일반 매개 변수예:
introscope.agent.transactiontracer.parameter.httpsession.attributes=attribute1,attribute2
introscope.agent.transactiontracer.sampling.enabled
이 속성은 트랜잭션 추적 프로그램 샘플링을 활성화하거나 비활성화합니다.
값:
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참고:
이 속성의 변경 사항을 적용하려면 관리되는 응용 프로그램을 다시 시작해야 합니다.세션 ID 수집 구성
introscope.agent.transactiontracer.parameter.capture.sessionid 속성은 트랜잭션 추적 프로그램 데이터에서 세션 ID 수집을 사용하거나 사용하지 않도록 설정합니다. 기본적으로 이 속성은 트랜잭션 추적 프로그램 데이터에서 사용하도록 설정되고 기록됩니다. 이 속성을 사용하지 않을 경우 필터에 데이터를 사용할 수 없습니다.
다음 단계를 따르십시오.
- IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.다음 행을 찾습니다.# Uncomment the following property to disable sessionid capture in TransactionTracer data.# By default, it is enabled and recorded in the TT Data.# introscope.agent.transactiontracer.parameter.capture.sessionid=true
- 지시에 따라 행을 주석으로 처리하거나 주석 처리를 제거하여 속성을 사용하거나 사용하지 않도록 설정합니다.# introscope.agent.transactiontracer.parameter.capture.sessionid=true
- 파일을 저장하고 닫은 다음 에이전트를 다시 시작합니다.에이전트 구성이 세션 ID 수집에 대해 지정된 값을 사용하도록 설정됩니다.
introscope.agent.transactiontracer.userid.key
이 속성은 사용자 정의된 키 문자열을 지정합니다.
기본값:
주석 처리됨, 일반 매개 변수예:
#introscope.agent.transactiontracer.parameter.httpsession.attributes=attribute1,attribute2참고:
사용 환경에서 HttpServletRequest.getHeader
또는 HttpServletRequest.getValue
를 사용하여 사용자 ID에 액세스하는 경우 이 값을 제공하는 것은 선택 사항입니다.introscope.agent.transactiontracer.userid.method
이 속성은 사용자 ID를 반환하는 메서드를 지정합니다.
값:
- HttpContext.User.Identity.Name
- HttpContext.Request.Uri.UserInfo
- HttpRequest.Headers.Get
- HttpContext.Session.Contents
기본값:
주석 처리됨예:
IntroscopeAgent.profile에는 허용 가능한 각 값에 대한 주석 처리된 속성 정의가 포함되어 있습니다. 사용할 속성의 주석 처리를 제거할 수 있습니다.
introscope.agent.transactiontracer.userid.method=HttpContext.User.Identity.Name#introscope.agent.transactiontracer.userid.method=HttpContext.Request.Uri.UserInfo#introscope.agent.transactiontracer.userid.method=HttpRequest.Headers.Get#introscope.agent.transactiontracer.userid.method=HttpContext.Session.Contents
URL 그룹화
다음은 프런트엔드 메트릭을 위한 URL 그룹을 구성하는 데 사용되는 속성입니다.
introscope.agent.urlgroup.keys
이 속성은 프런트엔드 이름 지정에 대한 구성 설정을 지정합니다.
기본값:
default예:
introscope.agent.urlgroup.keys=defaultintroscope.agent.urlgroup.group.default.pathprefix
이 속성은 프런트엔드 이름 지정에 대한 구성 설정을 지정합니다.
기본값:
*
예:
introscope.agent.urlgroup.group.default.pathprefix=*introscope.agent.urlgroup.group.default.format
이 속성은 프런트엔드 이름 지정에 대한 구성 설정을 지정합니다.
기본값:
default예:
introscope.agent.urlgroup.group.default.format=default