.NET 에이전트 속성 구성

대부분의 에이전트 작업은 IntroscopeAgent.profile 파일 내의 속성을 사용하여 구성됩니다. 이 단원에서는 가장 일반적으로 설정하는 에이전트 속성에 대해 설명합니다. 대부분의 속성이 사용 환경에 적합할 수 있습니다. 추가 속성에 대한 자세한 내용은 를 참조하십시오. 각 에이전트 버전에 대해 서로 다른 속성이나 서로 다른 기본값을 사용할 수도 있습니다.
apmdevops104kr
대부분의 에이전트 작업은 IntroscopeAgent.profile 파일 내의 속성을 사용하여 구성됩니다. 이 단원에서는 가장 일반적으로 설정하는 에이전트 속성에 대해 설명합니다. 대부분의 속성이 사용 환경에 적합할 수 있습니다. 추가 속성에 대한 자세한 내용은 .NET 에이전트 속성 참조를 참조하십시오. 각 에이전트 버전에 대해 서로 다른 속성이나 서로 다른 기본값을 사용할 수도 있습니다.
백업 Enterprise Manager 및 장애 조치 속성 구성
에이전트를 설치할 때는 에이전트에서 기본적으로 연결할 Enterprise Manager의 호스트 이름 및 포트 번호를 지정합니다. 필요한 경우 백업 Enterprise Manager를 하나 이상 지정할 수도 있습니다. 에이전트와 기본 Enterprise Manager 사이의 연결이 끊어지면 에이전트는 백업 Enterprise Manager에 연결을 시도할 수 있습니다.
에이전트가 백업 Enterprise Manager에 연결할 수 있게 하려면 에이전트 프로필에 Enterprise Manager의 통신 속성을 지정하십시오. 기본 Enterprise Manager를 사용할 수 없으면 에이전트는 허용되는 연결 목록의 다음 Enterprise Manager에 연결을 시도합니다. 첫 번째 백업 Enterprise Manager와 연결할 수 없으면 목록의 다음 Enterprise Manager에 연결을 시도합니다. 에이전트는 연결에 성공할 때까지 이런 식으로 목록의 각 Enterprise Manager에 대해 연결을 시도하며, 어떠한 Enterprise Manager에도 연결할 수 없는 경우에는 10초 동안 기다렸다가 다시 시도합니다.
다음 단계를 따르십시오.
  1. IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.
  2. 대체 Enterprise Manager 통신 채널을 하나 이상 지정합니다.
    각 백업 Enterprise Manager에 대한 에이전트 프로필에 다음 속성을 추가합니다.
    introscope.agent.enterprisemanager.transport.tcp.host.
    NAME
    introscope.agent.enterprisemanager.transport.tcp.port.
    NAME
    Introscope.agent.enterprisemanager.transport.tcp.socketfactory.
    NAME
    여기서
    NAME
    은 새 Enterprise Manager 채널의 식별자로 바꿉니다. 새 채널을 생성할 때는 DEFAULT나 기존 채널 이름을 사용하지 마십시오. 다음은 백업 Enterprise Manager를 두 개 생성하기 위한 예입니다.
    introscope.agent.enterprisemanager.transport.tcp.host.BackupEM1=paris
    introscope.agent.enterprisemanager.transport.tcp.port.BackupEM1=5001
    Introscope.agent.enterprisemanager.transport.tcp.socketfactory.BackupEM1=com.custom.postofficehub.link.net.DefaultSocketFactory
    introscope.agent.enterprisemanager.transport.tcp.host.BackupEM2=voyager
    introscope.agent.enterprisemanager.transport.tcp.port.BackupEM2=5002
    introscope.agent.enterprisemanager.transport.tcp.socketfactory.BackupEM2=com.wily.isengard.postofficehub.link.net.DefaultSocketFactory
  3. introscope.agent.enterprisemanager.connectionorder
     속성을 찾습니다. 이 속성을 기본 및 백업 Enterprise Manager의 식별자를 포함하는 쉼표로 구분된 목록으로 설정합니다. 목록 내의 식별자 순서에 따라 Enterprise Manager의 연결 순서가 정의됩니다. 예:
    introscope.agent.enterprisemanager.connectionorder=DEFAULT,BackupEM1,BackupEM2
  4. 변경 사항을 저장하고 IntroscopeAgent.profile 파일을 닫습니다.
  5. 응용 프로그램을 다시 시작합니다.
응용 프로그램에 대한 에이전트 프로필 지정
기본적으로 웹 응용 프로그램을 모니터링하는 .NET 에이전트는 응용 프로그램 가상 디렉터리나 컨텍스트 경로에 기반하여 이름이 자동으로 할당됩니다. 웹에 기반하지 않은 응용 프로그램을 모니터링하는 에이전트는 응용 프로그램 도메인 이름을 기준으로 이름이 할당됩니다. 가급적 자동 에이전트 명명 기능을 사용하는 것이 좋습니다. 그러나 필요한 경우 에이전트에 이름을 명시적으로 할당할 수도 있습니다. 예를 들어 .NET 에이전트 인스턴스가 여러 개 있는 경우에는 인스턴스를 개별적으로 관리하고 수동으로 이름을 할당할 수 있습니다.
에이전트 이름을 수동으로 할당하려면 다음 작업을 수행하십시오.
  • 각 에이전트 인스턴스와 응용 프로그램에 대해 별도의 에이전트 프로필을 만듭니다.
  • 각 프로필에 프로세스 및 에이전트 이름 속성을 정의합니다.
  • 특정 응용 프로그램 및 에이전트 인스턴스의 에이전트 프로필 위치를 설정합니다.
참고:
Introscope는 다음 규칙에 따라 에이전트 이름 구성에 사용되는 정보를 편집합니다.
  • 파이프, 콜론 또는 퍼센트 기호와 같은 문자는 밑줄로 바뀝니다.
  • 영문자 이외의 문자로 시작하는 이름 앞에는 문자 "A"가 붙습니다.
  • 빈 이름은 "UnknownAgent" 조건과 구별할 수 있도록 "UnnamedAgent"로 바뀝니다.
예:
원래 이름
표시 이름
" 선행 또는 후행 공백 "
"공백 없음"
"44 에이전트 이름"
"A44 에이전트 이름"
"""
"UnmanagedAgent"
"에이전트 이름-123"
"에이전트 이름-123"
각 응용 프로그램에 대해 별도의 프로필 생성
특정 .NET 응용 프로그램을 모니터링하는 에이전트 인스턴스에 이름을 명시적으로 할당할 수 있습니다. 이 경우 각 응용 프로그램에 대해 개별적으로 IntroscopeAgent.profile을 생성해야 합니다. 각 에이전트 인스턴스와 응용 프로그램에 개별 프로필을 사용하면 프로세스와 에이전트 이름을 제어하고 다른 속성을 필요에 맞게 사용자 지정할 수 있습니다.
다음 단계를 따르십시오.
  1. <Agent_Home>
    디렉터리에 있는 기존 IntroscopeAgent.profile 파일을 복사합니다.
  2. 복사한 프로필을 새 디렉터리에 붙여 넣습니다.
  3. (선택 사항) 에이전트 인스턴스 프로필로 식별할 수 있도록 프로필 이름을 변경합니다. 예:
    IntroscopeAgentCalc1.profile
    .
에이전트 이름 정의
사용자 지정 프로세스 이름과 에이전트 이름을 사용하면 특정 응용 프로그램을 모니터링하는 에이전트 인스턴스를 식별할 수 있습니다. 필요에 따라 인스턴스의 다른 속성을 수정할 수도 있습니다.
다음 단계를 따르십시오.
  1. 에이전트 인스턴스와 응용 프로그램에 대해 만든 IntroscopeAgent.profile을 텍스트 편집기에서 엽니다. 예를 들어 이름이 IntroscopeAgentCalc1.profile인 사용자 지정 프로필을
    C:\NetApps\wily
    디렉터리에 생성한 경우 해당 파일을 텍스트 편집기에서 엽니다.
  2. Custom Process Name
    섹션을 찾습니다.
  3. introscope.agent.customProcessName
     속성을 사용하여 표시할 사용자 지정 프로세스 이름을 지정합니다. 예:
    introscope.agent.customProcessName=ArcadeCaclcProcess
  4. introscope.agent.AutoNamingEnabled
    속성을 사용하여 자동 에이전트 이름 지정 기능을 비활성화합니다. 예:
    introscope.agent.agentAutoNamingEnabled=false
  5. introscope.agent.agentName
     속성을 사용하여 표시할 사용자 지정 에이전트 이름을 지정합니다. 예:
    introscope.agent.agentName=ArcadeCalcAgent
  6. 업데이트된 사용자 지정 프로필을 저장하고 닫습니다.
특정 응용 프로그램 및 에이전트 인스턴스의 에이전트 프로필 위치 설정
기본적으로 IntroscopeAgent.profile 파일은
<에이전트 홈>
디렉터리에 설치됩니다. 예를 들어 기본 위치는 C:\Program Files\CA APM\Introscope<버전>\wily입니다. 특정 응용 프로그램을 모니터링하는 에이전트 인스턴스에 대해 개별 프로필을 생성할 경우 해당 응용 프로그램과 에이전트 인스턴스의 프로필 위치를 지정하는 구성 파일을 생성해야 합니다.
다음 단계를 따르십시오.
  1. <에이전트 홈>
    \Sample.exe.config 파일을 텍스트 편집기에서 엽니다.
  2. Sample.exe.config 파일에서 샘플
    <configSections>
    <com.wily.introscope.agent>
    섹션을 모두 복사합니다.
  3. .NET 응용 프로그램의
    web.config
    파일 또는 IIS가 아닌 응용 프로그램 실행 파일의 독립 실행형 구성 파일을 엽니다.
    응용 프로그램 실행 파일의 구성 파일을 만드는 데 대한 자세한 내용은 응용 프로그램별 구성을 참조하십시오.
  4. <env.parameters>
    섹션에서 에이전트 프로필 위치를 수정합니다. 예:
    <env.parameters>
       <add key="com.wily.introscope.agentProfile" value="C:\\NETApps\\wily\\IntroscopeAgentCalc1.profile" />
    </env.parameters>
  5. web.config 또는 독립 실행형 구성 파일을 저장합니다.
  6. 관리되는 응용 프로그램을 다시 시작합니다.
성능 모니터 데이터 수집 및 사용자 지정
기본적으로 .NET 에이전트는 별도의 Windows 서비스인 Performance Monitor Collection Agent를 배포합니다. 이 에이전트는 모든 Windows 성능 모니터 개체, 카운터 및 인스턴스에서 메트릭을 수집합니다. Windows 서비스는 IIS 서버에서 실행되는 모든 에이전트 인스턴스와 프로세스를 위해 이 정보를 보고합니다. 설치를 진행하는 동안 이 서비스를 자동으로 시작할지 아니면 수동으로 시작할지 여부를 지정할 수 있습니다. 설치 후에는 서비스 제어판을 사용하여 서비스를 관리할 수 있습니다. 예를 들면 서비스 제어판을 통해 성능 모니터 카운터의 수집을 일시 중지하고 계속하거나 시작 유형을 변경할 수 있습니다.
에이전트 프로필에 포함된 속성을 수정하면 Performance Monitor Collection Agent가 수집하는 데이터를 사용자 지정할 수 있습니다. 예를 들어, 다음을 수행할 수 있습니다.
  • 수집할 특정 메트릭을 정규식을 통해 필터링합니다.
  • 반환되는 총 성능 모니터 메트릭 수를 제어합니다.
  • 성능 모니터 카운터를 확인하는 빈도를 제어합니다.
  • Performance Monitor Collection Agent가 새 성능 모니터 개체를 확인하는 빈도를 제어합니다.
  • Performance Monitor Collection Agent가 새 성능 모니터 개체를 확인하지 않도록 방지합니다.
참고
Investigator에서 데이터를 사용할 수 있으려면 Performance Monitor Collection Agent를 실행하는 계정이 성능 모니터 카운터에 액세스할 수 있는 권한을 가지고 있어야 합니다. 기본적으로 Performance Monitor Collection Agent 서비스는 성능 모니터 카운터에 대한 액세스 권한이 있는 로컬 시스템 계정으로 실행됩니다. 그러나 서비스 제어판을 통해 서비스를 실행할 다른 사용자 계정과 암호를 지정할 수 있습니다. 적절한 권한 설정에 대한 자세한 내용은 IIS 작업자 프로세스의 사용자 권한 확인을 참조하십시오.
정규식을 사용하여 메트릭 수집 필터링
.NET 에이전트의
perfmon.metric.filterPattern
 속성은 에이전트가 읽는 성능 모니터 카운터를 지정합니다. 기본 설정은 다음과 같습니다.
introscope.agent.perfmon.metric.filterPattern=|Processor|*|*,|.NET Data Provider*|*|*,|.NET CLR*|{osprocessname}|*,|.NET CLR Data|*|*,|Process|{osprocessname}|*,|ASP.NET|*
필터는
|Object|Instance|Counter
또는
|Object|Counter
(인스턴스가 없는 경우) 형식이며 각각 다음을 의미합니다.
  • Object
    는 Memory, Processor 또는 Process 같은 성능 모니터 범주를 나타냅니다.
  • Instance
    는 지정한 개체의 특정 인스턴스를 나타냅니다. Memory 같은 일부 개체에는 인스턴스가 없습니다.
  • Counter
    는 Object|Instance에 대해 수집할 특정 메트릭 유형을 나타냅니다. 예를 들어 .NET CLR Memory 성능 모니터 개체의 카운터로는 # Bytes in all heaps, Gen 0 heap size, # GC handles 및 % time in GC가 있습니다.
기본 필터에는
{osprocessname}
자리 표시자도 포함됩니다. Investigator에서
{osprocessname}
자리 표시자는 모니터링되는 독립 실행형 응용 프로그램의 인스턴스나
w3wp(BusinessServiceAppPool)
같이 IIS 작업자 프로세스의 응용 프로그램 풀 이름을 나타내도록 대체됩니다.
중요!
|*|* 필터를 사용하는 것은 모든 카운터를 인스턴스 없이 열거하도록 성능 모니터에 지정하는 것과 같으며, 이 경우 특정 카운터에서 문제가 발생할 수 있습니다.
introscope.agent.perfmon.metric.filterPattern
속성의 값을 수정하면 .NET 에이전트가 수집하는 성능 모니터 데이터를 조정할 수 있습니다. 예를 들어 기본 필터를 수정하여 보고되는 데이터를 늘리거나 줄일 수 있습니다. 응용 프로그램에 사용자 지정 성능 모니터 카운터를 정의한 경우, 해당 카운터를 포함할 수도 있습니다.
일부 성능 모니터 메트릭은 Microsoft에서 향후 구현하기 위해 예약되어 있습니다. 이러한 메트릭은 성능 모니터에서
NotDisplayed
로 태그가 지정되어 있습니다. Introscope Investigator에서 이러한 메트릭을 보면 자리 표시자 태그가 표시됩니다.
총 메트릭 수의 제한 설정
기본적으로 Performance Monitor Collection Agent는 사용 가능한 모든 성능 모니터 개체, 인스턴스 및 카운터에 대해 성능 모니터 데이터를 수집합니다. 필요한 경우 보고되는 총 성능 모니터 메트릭 수의 상한을 설정하여 데이터의 전체 범위를 제한할 수 있습니다
.
성능 모니터 메트릭의 최대 수를 설정하면 모니터링 대상 서버에서 Performance Monitor Collection Agent의 오버헤드를 줄일 수 있습니다.
다음 단계를 따르십시오.
  1. IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.
  2. perfmon.metric.limit
    속성을 찾은 후 각 간격당 허용할 성능 모니터 메트릭의 최대 수로 설정합니다. 예:
    introscope.agent.perfmon.metric.limit=100
  3. IntroscopeAgent.profile 파일을 저장하고 닫습니다.
성능 모니터 데이터를 수집하는 빈도 제어
기본적으로 Performance Monitor Collection Agent는 모든 성능 모니터 개체, 인스턴스 및 카운터에서 15초마다 메트릭 값을 확인합니다. 이 폴링 간격을 사용하면 이미 발견된 성능 모니터 개체에 대해 최신 데이터가 보고됩니다
.
Performance Monitor Collection Agent는 데이터를 수집할 새로운 성능 모니터 개체도 주기적으로 확인합니다. 기본적으로 이와 같은 검색은 오버헤드 없이 사용 가능한 개체를 검색하고 오래된 개체를 제거할 수 있도록 10분 간격으로 실행됩니다. 이러한 두 가지 간격 모두 에이전트 프로필에서 수정할 수 있습니다.
다음 단계를 따르십시오.
  1. IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.
  2. introscope.agent.perfmon.metric.pollIntervalInSeconds
     속성을 찾은 후 Performance Monitor Collection Agent의 폴링 간격을 구성합니다. 여기에 설정하는 값은 Performance Monitor Collection Agent가 메트릭 값을 확인하는 빈도를 제어합니다. 예:
    introscope.agent.perfmon.metric.pollingIntervalInSeconds=20
  3. introscope.agent.perfmon.category.browseIntervalInSeconds
    속성을 찾은 후 Performance Monitor Collection Agent의 검색 간격을 구성합니다. 여기에 설정하는 값은 Performance Monitor Collection Agent가 새 성능 모니터 개체나 사용되지 않는 성능 모니터 개체를 확인하는 빈도를 제어합니다. 예:
    introscope.agent.perfmon.category.browseIntervalInSeconds=900
  4. IntroscopeAgent.profile 파일을 저장하고 닫습니다.
성능 모니터 개체를 탐색하지 않도록 설정
Performance Monitor Collection Agent는 성능 모니터 개체를 주기적으로 쿼리하여 사용 가능한 모든 서비스가 포함되었는지 확인합니다. 이를 통해 에이전트는 새로운 카운터를 발견하거나, 필요한 경우 사용하지 않는 카운터를 제거할 수 있습니다. 이 기능은 기본적으로 사용하도록 설정되며 기본 쿼리 간격은 600초(10분)로 설정됩니다.
시스템 오버헤드를 줄이기 위해 Performance Monitor Collection Agent가 새 카운터나 사용되지 않는 카운터를 확인하지 않도록 할 수도 있습니다.
다음 단계를 따르십시오.
  1. IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.
  2. introscope.agent.perfmon.category.browseEnabled
     속성을 찾아
    false
    로 설정합니다. 예:
    introscope.agent.perfmon.category.browseEnabled=false
  3. IntroscopeAgent.profile 파일을 저장하고 닫습니다.
성능 모니터 데이터의 수집 시작
.NET 에이전트는 CA APM PerfMon 수집기 서비스라는 외부 서비스를 배포하여 성능 모니터 메트릭을 수집하고 보고합니다. 이 서비스를 사용하면 각 .NET 에이전트가 아니라 컴퓨터 수준에서 메트릭을 수집할 수 있습니다. .NET 에이전트의 이 인스턴스만 PerfMon 시스템 리소스를 사용합니다.
참고
이 서비스는 응용 프로그램 서버에 .NET 에이전트를 배포한 후에 실행하십시오.
다음 단계를 따르십시오.
  1. Windows 관리 콘솔에 관리자로 로그인합니다.
  2. CA APM PerfMon 수집기 서비스
    로 이동합니다.
  3. 서비스를 마우스 오른쪽 단추로 클릭하고
    시작
    을 클릭합니다.
성능 모니터 데이터의 수집 중지
.NET 응용 프로그램 관리에 필요하지 않은 성능 모니터 데이터를 수집하지 않도록 모든 성능 모니터 카운터 수집을 중지할 수 있습니다.
다음 단계를 따르십시오.
  1. 서비스 제어판을 엽니다.
  2. 서비스 이름 목록에서
    Performance Monitor Collector Service
    를 찾습니다.
  3. Performance Monitor Collector Service
    를 선택한 후 마우스 오른쪽 단추를 클릭하고
    속성
    을 선택합니다.
  4. 중지
    를 클릭합니다.
  5. "시작 유형"으로
    수동
    또는
    사용 안 함
    을 선택합니다.
  6. "확
    인"을 클릭합니다.
시작 시간 제어
IIS를 사용하는 대부분의 조직에서는 각 응용 프로그램 도메인에 대해 .NET 응용 프로그램 풀을 재사용하기 위해 IIS 서비스를 주기적으로 다시 시작합니다. IIS를 재시작할 때마다 .NET 에이전트도 함께 호출되어 각 응용 프로그램 풀에 속해 있는 응용 프로그램을 계측합니다. 초기 시작 시간은 다음과 같은 조건에 따라 달라질 수 있습니다.
  • 모니터링하는 응용 프로그램 및 클래스의 수
  • 에이전트 프로필 구성
  • 사용자 지정 PBD 존재 여부
NativeProfiler를 통해 계측되는 에이전트의 기본 설정을 사용하면 에이전트와 응용 프로그램 서버를 시작하는 데 적절한 시간이 소요됩니다. 몇 가지 선택적인 단계를 수행하여 시작 성능을 개선할 수 있습니다.
.NET 에이전트의 시작 시간을 단축하려면 다음 작업을 수행하십시오.
  • 에이전트 프로필에서 introscope.nativeprofiler.directivematching.cache.max.size 속성의 값을 변경합니다.
    기본적으로 에이전트는 이전에 찾은 지시문 그룹의 캐시를 메모리 내에 생성하는데, 여기에는 모니터링되는 클래스가 포함됩니다. 에이전트는 사용자가 IIS를 시작할 때 이전에 발견된 클래스의 캐시를 생성합니다. 이 캐시는 응용 프로그램 코드가 새로운 클래스를 모니터링함에 따라 시간이 지나면서 크기가 증가합니다. 메모리 내 캐시에는 기본적으로 최대 5000개의 클래스 이름이 저장됩니다. 캐시 크기가 이 제한에 도달하면 에이전트는 캐시가 가득 찼음을 나타내는 항목을 NativeProfiler 로그 파일에 기록합니다.
    IntroscopeAgent.profile 파일에서 introscope.nativeprofiler.directivematching.cache.max.size 속성을 사용하여 캐시 크기를 늘리거나 줄일 수 있습니다. 캐시에 저장된 클래스 이름이 5000개를 초과하는 경우 값을 늘리면 시작 시간을 단축시킬 수 있습니다. 하지만 값을 늘리면 에이전트의 메모리 오버헤드가 증가할 수 있습니다. 속성 값을 줄이면 에이전트의 메모리 오버헤드도 감소합니다. 모니터링하는 클래스 수가 5000개 미만이거나 크기가 큰 지시문 그룹의 모니터링을 중지할 경우에는 이 값을 줄이는 것이 좋습니다.
  • 사용자 지정 PBD 파일에서 클래스와 지시문을 식별한 방법을 확인합니다.
    같은 그룹에 속해 있는 클래스에
    IdentifyInheritedAs
    지시문을 사용하면 에이전트가 상속 계층을 가장 효과적으로 사용할 수 있습니다.
In-Process Side-by-Side 실행 사용
.NET Framework 4에서는 서로 다른 .NET Framework 버전을 사용하는 응용 프로그램을 같은 프로세스에서 실행할 수 있습니다. 이 경우 이전 구성 요소는 이전 .NET Framework 버전을 계속 사용하고 새 구성 요소는 새로운 .NET Framework 버전을 사용합니다.
.NET 에이전트는 기본적으로 호스트 프로세스에 먼저 로드되는 응용 프로그램에서 사용하는 .NET Framework를 계측합니다. 예를 들어, 시작하는 첫 번째 응용 프로그램이 .NET Framework 2.0을 사용하면 기본적으로 .NET Framework 2.0 구성 요소만 계측됩니다.
com.wily.introscope.nativeprofiler.monitor.inprocsxs.multiple.clrs
 속성을 사용하면 .NET 에이전트가 같은 프로세스에서 여러 .NET Framework 버전의 구성 요소를 계측할 수 있습니다.
com.wily.introscope.nativeprofiler.monitor.inprocsxs.multiple.clrs
 속성을 사용하면 모니터링할 .NET Framework 인스턴스를 지정할 수 있습니다. 예를 들어 .NET Framework 4만 모니터링하도록 이 속성을 설정하면 .NET Framework 4에서 실행되는 구성 요소의 메트릭만 보고됩니다.
com.wily.introscope.nativeprofiler.monitor.inprocsxs.multiple.clrs
속성을 사용하면 In-Process Side-by-Side 실행을 통해 .NET Framework 4 응용 프로그램과 .NET Framework 2 응용 프로그램을 모두 모니터링하고 메트릭을 보고할 수 있습니다.
다음 단계를 따르십시오.
  1. IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.
  2. com.wily.introscope.nativeprofiler.monitor.inprocsxs.multiple.clrs
     속성을 찾습니다.
  3. 모니터링할 .NET Framework 버전을 표시하기 위해 다음 예와 같이 이 속성을 쉼표로 구분하여 설정합니다.
    com.wily.introscope.nativeprofiler.monitor.inprocsxs.multiple.clrs=v2,v4
  4. 파일을 저장하고 닫습니다.
  5. 관리되는 응용 프로그램을 다시 시작합니다.
에이전트 부하 분산 구성
작업 부하가 주로 에이전트에 의해 보고되는 메트릭인 클러스터에서는 MOM 에이전트 부하 분산을 구성하여 전체 클러스터 수용 능력을 최적화할 수 있습니다.
가상 트랜잭션 감지 구성
가상 트랜잭션 모니터링의 구성 설정은
introscope.agent.synthetic.header.names
매개 변수를 사용하여 지정할 수 있습니다.
introscope.agent.synthetic.header.names
매개 변수 값은 모니터링된 HTTP 요청이 가상 트랜잭션의 일부인지 여부를 확인하는 데 사용되는 HTTP 헤더 매개 변수를 나열합니다. 개별 매개 변수 이름은 쉼표로 구분됩니다. 이 매개 변수를 정의하지 않거나 값을 비워 두면 가상 트랜잭션이 감지되지 않습니다. HTTP 헤더 매개 변수 이름을 여러 개 정의할 경우, 매개 변수를 지정한 순서대로 검토가 이루어집니다. 값이 지정된 첫 번째 HTTP 매개 변수가 가상 트랜잭션 정의에 사용됩니다.
가상 트랜잭션이 보고되는 노드는 다음과 같이 각 트랜잭션을 감지하는 데 사용되는 특정 HTTP 헤더 매개 변수에 따라 결정됩니다.
  • 매개 변수 값이
    x-wtg-info
    이외의 값이면 HTTP 매개 변수 값 자체가 노드 이름으로 사용됩니다. 유효한 노드 이름이 사용되도록 적절한 수정 작업이 수행됩니다.
  • 매개 변수 값이
    x-wtg-info
    인 경우 HTTP 헤더 매개 변수 값에 이름-값 쌍의 시퀀스가 포함된 것으로 간주됩니다. 각 쌍은 앰퍼샌드 기호로 구분되며 각 쌍 내에서 특성 이름과 값은 등호로 구분됩니다. 가상 트랜잭션 노드 이름은
    group
    ,
    name
    ,
    ipaddress
    request_id
    의 값을 노드 구분 기호 |로 구분하여 구성됩니다.
예를 들어 매개 변수가 다음과 같은 경우:
introscope.agent.synthetic.header.names=Synthetic_Transaction,x-wtg-info
다음의
x-wtg-info
헤더를 사용할 경우 SampleGroup|sample|172.24.36.107|start라는 노드 아래에 메트릭이 보고됩니다.
clear synthetic=true&instance=ewing&name=sample&group=SampleGroup&version=4.1.0&ipaddress=172.24.36.107&sequencenumber=1&request_id=start&executiontime=1226455047
x-wtg-info
HTTP 헤더 매개 변수 값에 정의되지 않은 모든 특성에는 다음과 같은 기본값이 사용됩니다.
  • group
    =unknownGroup
  • name
    =unknownScript
  • ipaddress
    =0.0.0.0
  • request_id
    =Action
introscope.agent.synthetic.header.names
를 정의하지 않으면 다음과 같은 구성 매개 변수가 무시됩니다.
introscope.agent.synthetic.node.name=Synthetic Users
가상 트랜잭션으로 인식된 트랜잭션이 보고되는 노드입니다. 이 노드는
Frontends(프런트엔드)|Apps(응용 프로그램)|<WebAppName>
에 위치하며, 여기서
<WebAppName>
은 웹 응용 프로그램 이름입니다. 이 값은 기본적으로 Synthetic Users입니다.
introscope.agent.non.synthetic.node.name=Real Users
가상 트랜잭션으로 인식되지 않은 트랜잭션이 보고되는 노드입니다. 이 노드는
Frontends(프런트엔드)|Apps(응용 프로그램)|<WebAppName>
에 위치하며, 여기서
<WebAppName>
은 웹 응용 프로그램 이름입니다. 정의하지 않을 경우
<WebAppName>
아래에 노드가 추가로 생성되지 않습니다.
introscope.agent.synthetic.user.name=Synthetic_Trace_By_Vuser
해당 값이 가상 사용자 이름으로 사용되는 HTTP 헤더 매개 변수의 이름입니다. 가상 사용자 이름은 서로 다른 가상 트랜잭션을 구분하기 위해 사용됩니다. 각 가상 사용자 이름에 해당하는 노드가
Synthetic User
노드 아래에 생성됩니다. 이 구성 매개 변수가 정의되고 동일한 이름의 HTTP 헤더 매개 변수가 존재하면 가상 트랜잭션 메트릭이 보고됩니다. 트랜잭션은
<Synthetic Users>|<Synthetic User>
노드 아래에 보고됩니다.
  • introscope.agent.synthetic.node.name
     속성이
    <Synthetic User>
    노드 이름을 결정합니다.
  • HTTP 헤더 매개 변수 값이
    <Synthetic User>
    노드 이름을 결정합니다.
참고:
이러한 속성의 변경 내용은 즉시 적용되며 관리되는 응용 프로그램을 다시 시작할 필요가 없습니다.
TagScript 유틸리티 사용
CA TagScript 유틸리티를 HP Vugen과 함께 사용하여 가상 사용자 정보의 추출을 지정할 수 있습니다.
TagScript 유틸리티를 사용하려면
  1. TagScript 유틸리티를 엽니다.
    Windows:
    <Agent_Home>\tools\TagScript.bat
    UNIX:
    <Agent_Home>/tools/TagScript.sh
    어느 환경을 대상으로 스크립트를 수정할지 묻는 메시지가 표시됩니다.
  2. 다음 옵션 중 하나를 클릭합니다.
    • Performance Testing
      (성능 테스트) - HP Loadrunner 스크립트의 경우
    • Production
      (프로덕션) - HP Business Process Monitor 또는 Sitescope 스크립트의 경우
    • Un-tag
      (태그 해제) - 태그 지정 프로세스 되돌리기
  3. HP Vugen 스크립트가 저장되어 있는 디렉터리로 이동한 후 각 .c 스크립트를 두 번 클릭하여 엽니다.
    HP Vugen script.c 파일이 모두 백업되고 수정된 버전으로 대체됩니다.
  4. HP Vugen이 열려 있고 유틸리티가 실행 중이면 수정된 스크립트를 다시 로드하라는 메시지가 나타납니다. 이 메시지가 표시되면
    Yes to All
    (모두 예)을 클릭하십시오.
  5. TagScript 유틸리티를 닫거나, 파일 선택 대화 상자에서
    Cancel
    (취소) 단추를 클릭합니다. TagScript 유틸리티를 반드시 닫아야 하는 것은 아니며, 대부분의 사용자는 HP Vugen을 사용하는 동안 이 유틸리티를 열어 둡니다. 스크립트가 수정되거나 새로운 스크립트가 생성된 경우, 유틸리티를 열어 두면 프로세스가 더 간단합니다.
  6. 다음과 같은 위치에서 스크립트 태그가 지정되었는지 확인합니다.
    • 각 스크립트의 시작 부분에 HP Vugen 코드의 신규 단락이 삽입되었는지 확인합니다.
    • 모든 lr_start_transaction 및 lr_end_transaction 전과 스크립트 맨 마지막에 태그가 표시되는지 확인합니다.
  7. (선택 사항) 개별 Blame 스택 집합을 사용하여 각 가상 사용자를 HP LoadRunner 성능 테스트를 통해 추적합니다. 각 사용자를 추적하려면 스크립트 시작 부분의 선언 단락에서 다음 행에 대한 주석 처리를 제거합니다.
    web_add_auto_header(“Synthetic_Trace_By_Vuser”,vuserOverview)
    참고:
    "Production"(프로덕션) 태그 지정 스크립트에 대해 이 옵션의 주석 처리를 제거하면 .NET 에이전트가 각 상호 접속 위치 또는 가상 트랜잭션 생성기에 대해 개별 Blame 스택 집합을 생성합니다.
차이 분석 비활성화 또는 조정
WebAPI 및 MVC 컨트롤러의 경우 기본적으로 차이 분석이 활성화되어 있습니다. 하지만 관리자는 다음을 수행할 수 있습니다.
  • 차이 분석 비활성화
  • 간격당 트랜잭션 수 제한
다음 단계를 따르십시오.
  1. IntroscopeAgent.profile 파일을 텍스트 편집기에서 엽니다.
  2. 다음 속성을 찾습니다.
    # Enabled the DA trigger feature.
    #introscope.agent.da.trace.enabled=true
    # Limit the number of transactions that are analyzed per 15-second interval
    #introscope.agent.da.trace.maxTransactionsAnalyzedPerInterval=4
  3. 구성할 속성의 주석 처리를 제거하고 값을 지정합니다.
    • 차이 분석 비활성화:
      introscope.agent.da.trace.enabled=false
      값: true/false
      기본값: true
    • 간격당 트랜잭션 수 제한:
      introscope.agent.da.trace.maxTransactionsAnalyzedPerInterval=3
      값: 음이 아닌 정수
      기본값: 4
  4. 파일을 저장하고 닫습니다.