.NET 에이전트 로깅 옵션 구성

다음 단원에서는 .NET 에이전트를 세부 정보 표시 모드에서 실행하고 에이전트의 로그 파일 옵션을 설정하는 방법을 설명합니다. Introscope용 .NET 에이전트는 Log4net 기능을 사용하여 이와 같은 기능을 수행합니다. 다른 Log4net 기능을 사용하려면 http://logging.apache.org/log4net/release/features.html 페이지에서 Log4net 문서를 참조하십시오.

세부 정보 표시 모드로 .NET 에이전트 실행

.NET 에이전트를 세부 정보 표시 모드로 실행하면 많은 세부 정보가 로그 파일에 기록되어 디버그할 때 도움이 됩니다.

세부 정보 표시 모드로 .NET 에이전트를 실행하려면

.NET 에이전트를 중지합니다.
logging.config.xml 파일을 엽니다.

level value 특성을 VERBOSE로 변경합니다. 기본값은 INFO입니다.

<root>
<level value="VERBOSE" />
<appender-ref ref="logfile" />
<appender-ref ref="console" />
</root>

logging.config.xml 파일을 저장하고 .NET 에이전트를 다시 시작합니다.

.NET 에이전트 로그 파일 위치 변경

로그 파일은 기본적으로 C:\Program Files\CA Wily\Introscope<version>\wily\logs 아래의 <Agent_Home>\logs 디렉터리에 기록되며 여기에서 <version>은 설치되어 있는 Introscope 버전입니다. 로그 파일을 좀 더 쉽게 사용할 수 있도록 .NET 에이전트 로그 파일의 위치를 변경할 수 있습니다.

.NET 에이전트 로그 파일의 위치를 변경하려면

.NET 에이전트를 중지합니다.
logging.config.xml 파일을 엽니다.
다음과 같이 file value 특성을 로그 파일의 원하는 위치로 변경합니다.
```
<file value="c:\introscope_logs\IntroscopeAgent.log" />
```
logging.config.xml 파일을 저장합니다.
.NET 에이전트를 다시 시작합니다.

에이전트의 이름을 구성한 경우에는 이름이 지정된 에이전트 로그가 기본 위치 또는 방금 지정한 새 위치의 logs 디렉터리에 기록됩니다.

.NET 에이전트 로그 파일 및 자동 에이전트 이름 지정

기본적으로 .NET 에이전트의 이름은 자동으로 지정됩니다. .NET 에이전트 이름이 자동으로 검색되면 해당 에이전트와 관련된 로그 파일의 이름도 동일한 정보를 사용하여 자동으로 지정됩니다. 에이전트가 생성하는 로그 파일에는 계측 프로세스 동안 삽입된 프로브 및 사용된 PBD에 대한 정보가 기록됩니다. 기본적으로 자동 이름 지정 기능을 사용하면 파일 이름에 타임스탬프를 사용하여 로그 파일이 처음 생성됩니다. 예:

AutoProbe20060928-175024.log

그런 후 에이전트 이름을 사용할 수 있게 되면 해당 에이전트 이름을 포함하도록 로그 파일 이름이 변경됩니다. 예를 들어 에이전트 이름이 MyDomain//MyAgent이고, 여기에서 MyDomain이 도메인이고 MyAgent가 인스턴스인 경우 로그 파일 이름은 다음과 같습니다.

AutoProbeMyDomain_MyStuff.log

로그의 실제 이름이 아니라 타임스탬프 이름이 사용된 로그 파일이 있는 경우에는 에이전트 이름을 확인하기 전에 프로세스 시간이 초과된 것일 수 있습니다. 또한 고급 Log4Net 기능을 사용할 경우에는 자동 이름 지정 기능이 제대로 작동하지 않을 수 있습니다.

참고: 클래스 경로에 있는 리소스에서 .NET 에이전트 프로필을 로드하면 IntroscopeAgent.profile 파일이 리소스 내에 위치하기 때문에 NativeProfiler가 로그 파일에 정보를 기록할 수 없습니다.

로그 파일 자동 이름 지정 기능을 사용하지 않으려면 에이전트 프로필에서 introscope.agent.disableLogFileAutoNaming 속성을 true로 설정하십시오.

기본 도메인 로그

기본 도메인은 메트릭을 보고하기 위해 Enterprise Manager에 연결하지 않으며 자체적으로 응용 프로그램을 실행하지도 않습니다. 그러나 기본 도메인에 속한 .NET 에이전트가 기본 도메인에 호스트되는 모든 응용 프로그램 도메인에 대한 모든 바이트 코드 계측을 처리하기 때문에 로그 파일은 생성됩니다. 이러한 파일 중 하나인 AutoProbe.DefaultDomain.log에는 기본 도메인 내에서 발생하는 바이트 코드 계측에 대한 정보가 포함됩니다. 모든 바이트 코드 계측은 기본 도메인에서 이루어지기 때문에 이러한 로그 파일에는 계측과 관련된 중요 정보가 들어 있습니다.

기본 도메인에서는 .NET 에이전트에 대해 IntroscopeAgent.DefaultDomain.log 파일도 생성됩니다.