이전 항목: 문제 해결 및 팁다음 항목: .NET 에이전트 속성

문제 해결 및 팁 › 에이전트 확장의 버전 정보 수정

에이전트 확장의 버전 정보 수정

.NET 에이전트 및 선택적 확장 설치 시기에 따라 확장의 버전 번호와 .NET Agent의 버전 번호가 다를 수 있습니다. 대부분의 경우 .NET 에이전트와 확장 간의 버전 정보가 다르면 에이전트가 로그에 오류 메시지를 기록하고 확장이 올바르게 작동하지 못합니다. 이 경우 버전 정보를 수동으로 업데이트하여 이 유형의 문제를 해결할 수 있습니다. 사용 중인 환경에 따라 다음 중 하나를 수행하십시오.

중요: 하나의 옵션만 선택하고 두 옵션을 모두 수행하지는 마십시오.

개별 응용 프로그램의 버전 정보를 구성하려면

  1. 설치하려는 확장이 일반 .exe인 경우 <Extension_Name>.exe.config라는 파일을 만들어 원래 .exe와 동일한 디렉터리에 저장합니다.
  2. 확장이 IIS 응용 프로그램인 경우 w3wp.exe.config라는 파일을 생성하고 w3wp.exe와 동일한 디렉터리에 배치합니다. 이것은 기본 도메인인 경우의 해결 방법입니다.
  3. 확장이 IIS 응용 프로그램인 경우 각각의 개별 응용 프로그램에 대해 web.config에 다음 항목을 추가합니다. 
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
   <dependentAssembly>
      <assemblyIdentity name="..." .../>
      <bindingRedirect oldVersion="0.0.0.0 - 65535.65535.65535.65535" newVersion="<AGENT.VERSION.NUMBER>"/>
   </dependentAssembly>
</assemblyBinding>

    assemblyIdentity 이름을 입력하고 에이전트 버전 번호를 .NET 에이전트 버전 번호로 바꿉니다. 버전 정보는 네 자리 숫자로 구성되어야 합니다. 예를 들어 9.0.7 버전의 .NET 에이전트를 설치한 경우 다음을 추가할 수 있습니다.

    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
   <dependentAssembly>
      <assemblyIdentity name="wily.Agent"   publicKeyToken="2B41FDFB6CD662A5"/>
      <bindingRedirect oldVersion="9.0.5.0 - 65535.65535.65535.65535" newVersion="9.0.7.0" />
   </dependentAssembly>
</assemblyBinding>

참고: 위 파일이 이미 있는 경우 <assemblyBinding> 노드를 <runtime> 아래에 추가하십시오.

모든 응용 프로그램을 전역적으로 구성하려면

참고: machine.config에 코드 조각을 추가하면 전역적으로 모든 응용 프로그램에 영향을 미칩니다.

hotdeploy 디렉터리의 사용 여부 선택

hotdeploy 디렉터리는 IntroscopeAgent.profile을 편집하지 않고 대개는 관리되는 응용 프로그램을 다시 시작할 필요 없이 새로운 지시문을 배포하는 데 사용됩니다. 그러나 이 기능을 사용할 때는 상당한 주의가 요구됩니다. 사용자 지정 PBD 파일이 잘못된 구문을 포함하거나 메트릭을 너무 많이 수집하도록 구성되어 있으면 그 영향이 더 빠르게 나타납니다. 잘못된 PBD를 사용하면 NativeProfiler가 종료될 수 있으며 PBD가 너무 많은 메트릭을 수집하는 경우에는 응용 프로그램 성능이 저하될 수 있습니다.

이러한 문제를 해결하기 위해 다음과 같이 하는 것이 좋습니다.

새 PBD를 hotdeploy 디렉터리에 배치하면 .NET 에이전트가 해당 PBD를 자동으로 배포합니다. 그러나 이미 실행 중인 클래스와 응용 프로그램의 경우에는 해당 응용 프로그램을 다시 시작해야만 새 PBD나 변경된 PBD의 내용이 적용됩니다.

참고: PBD 파일만 hotdeploy 디렉터리에 배포할 수 있습니다. 에이전트는 이 디렉터리에 있는 모든 ProbeBuilder 목록(PBL)은 무시합니다.

잘못된 PBD 파일이 자동으로 배포되지 않도록 하려면 hotdeploy 디렉터리를 사용하지 않도록 설정할 수 있습니다.

hotdeploy 디렉터리를 사용하지 않게 설정하려면

  1. hotdeploy 디렉터리에 저장되어 있는 모든 사용자 지정 PBD 파일을 <Agent_Home> 디렉터리로 이동합니다.
  2. IntroscopeAgent.profile을 텍스트 편집기에서 엽니다.
  3. introscope.autoprobe.directivesFile 속성에서 hotdeploy를 제거합니다.
  4. 사용할 사용자 지정 PBD를 introscope.autoprobe.directivesFile에 추가합니다. 예: 
    introscope.autoprobe.directivesFile=default-typical.pbl,custom1.pbd,custom2.pbd,custom3.pbd
  5. IntroscopeAgent.profile을 저장하고 에이전트를 다시 시작합니다.