오류 로그 및 추적 로그

목차
casso12kr
목차
웹 에이전트 로깅 기능을 사용하여 웹 에이전트 및 정책 서버와의 통신 성능을 모니터링할 수 있습니다. 로깅 기능은 성능을 분석하고 문제를 해결하기 위한
Single Sign-On
프로세스 작업에 대한 정확하고 포괄적인 정보를 제공합니다.
로그는 프로그램 실행 중에 발생하는 이벤트의 레코드입니다. 로그는 각각 프로그램 실행 중에 발생한 몇 가지 이벤트를 설명하는 일련의 로그 메시지로 구성됩니다. 로그 메시지는 로그 파일에 기록됩니다.
참고
IIS 에이전트는 첫 번째 사용자 요청이 제출된 후에만 로그 파일을 생성합니다. 또한 Apache 2.0 웹 에이전트는 Apache 서버가 시작될 때 로그 파일을 생성합니다.
웹 에이전트에서는 다음과 같은 로그 파일을 사용합니다.
  • 오류 로그
    프로그램 및 작업 수준 오류를 포함합니다. 웹 에이전트가 정책 서버와 통신할 수 없는 경우를 예로 들 수 있습니다. 이 로그의 경우 세부 출력 수준을 사용자 지정할 수 없습니다. 오류 로그에는 다음과 같은 유형의 메시지가 포함됩니다.
    • 오류 메시지
      네트워크 오류와 같은 외부 문제로 인해 기능이 예상대로 작동하지 않는 경우 또는 잘못되었거나 비정상적인 프로그램 동작을 나타내는 프로그램 수준 오류를 포함합니다. 작업 수준 오류도 포함됩니다. 이 유형의 오류는 파일 열기 또는 사용자 인증과 같은 작업이 실패하는 경우입니다.
    • 정보 메시지
      서버 시작 또는 중지와 같은 일부 이벤트가 실행되었거나 작업이 수행되었음을 사용자 또는 관리자에게 알려 주는 메시지를 포함합니다.
    • 경고 메시지
      비정상적이거나 잠재적 문제를 나타내는 이벤트 및 상태가 있음을 사용자 또는 관리자에게 알려 주는 경고를 포함합니다. 경고 메시지는 문제가 발생했음을 나타내는 것은 아닙니다.
  • 추적 로그
    직접 구성할 수 있는 자세한 경고 및 정보 메시지를 포함합니다. 예를 들면 추적 메시지와 흐름 상태 메시지입니다. 이 파일에는 헤더 정보 및 쿠키 변수와 같은 데이터도 포함됩니다. 추적 로그에는 다음과 같은 메시지가 포함됩니다.
    • 추적 메시지
      추적 및 디버깅에 사용할 목적으로 프로그램 작업과 관련된 자세한 정보를 제공합니다. 일반적으로 정상 작업 중에는 추적 메시지가 해제됩니다. 정보, 경고 및 오류 메시지와 달리 추적 메시지는 원본 코드에 포함되며 쉽게 지역화할 수 없습니다. 또한 추적 메시지는 메시지 자체뿐만 아니라 현재 사용자 또는 영역 이름과 같은 중요한 데이터를 포함할 수 있습니다.
웹 에이전트를 구성할 때 오류 로그 파일과 추적 로그 파일의 위치를 둘 다 지정합니다. 오류 및 추적 로그는 웹 에이전트가 올바로 작동하지 않는 경우 문제를 해결하는 데 유용합니다.
참고:
Windows 플랫폼에 설치된 에이전트의 경우 웹 에이전트 로그를 생성하려면 EnableWebAgent 매개 변수를 yes로 설정해야 합니다. EnableWebAgent가 기본값인 no로 설정된 상태에서 로깅 매개 변수를 설정하면 UNIX 플랫폼의 에이전트에 대해서만 에이전트 로그가 생성됩니다.
로그 파일에 표시되는 매개 변수 값
웹 에이전트는 구성 매개 변수 및 매개 변수 값을 웹 에이전트 오류 로그 파일에 나열하지만 기존 에이전트와 프레임워크 에이전트의 처리 방식에 차이가 있습니다.
프레임워크 에이전트는 구성 매개 변수 및 매개 변수 값을 에이전트 구성 개체 또는 로컬 구성 파일에 입력한 그대로 로그 파일에 기록합니다. 즉, 잘못된 값이 지정된 매개 변수를 포함하여 모든 매개 변수가 로그 파일에 기록됩니다.
기존 에이전트는 매개 변수 값을 먼저 처리한 후 기록합니다. 즉, 매개 변수의 값이 올바르면 해당 매개 변수와 값이 로그 파일에 기록됩니다. 잘못된 값이 지정된 매개 변수는 로그 파일에 기록되지
않습니다
.
오류 로깅 설정 및 사용
오류 로그에는 다음과 같은 설정이 필요합니다.
  • 로깅을 사용할 수 있어야 합니다.
  • 로그 파일 위치를 지정해야 합니다.
오류 로깅을 설정하고 옵션(예: 로그 데이터 추가)을 결정하는 매개 변수는 정책 서버의 에이전트 구성 개체 또는 로컬 구성 파일에 정의됩니다.
IIS 또는 Apache 웹 서버에 설치된 에이전트에서는 로컬 구성 파일에 로컬로 설정된 로그 매개 변수를 동적으로 구성할 수 없습니다. 에이전트를 다시 시작하면 변경 내용이 적용됩니다. 그러나 이러한 로그 설정을 정책 서버의 에이전트 구성 개체에서 동적으로 저장하고 업데이트할 수 있습니다.
IIS 에이전트는 첫 번째 사용자 요청이 제출된 후에만 로그 파일을 생성합니다. 또한 Apache 2.0 웹 에이전트는 Apache 서버가 시작될 때 로그 파일을 생성합니다.
다음 단계를 수행하십시오.
  1. 로그 파일이 없는 경우 로그 파일 및 관련 디렉터리를 생성합니다.
  2. LogFile 매개 변수의 값을 yes로 설정합니다.
    casso12kr
    참고
    웹 서버의 로컬 구성 파일에서 이 매개 변수의 값을 yes로 설정하면 정책 서버에 정의된 로깅 설정이 무시됩니다. 예를 들어 LocalConfig.conf 파일에서 이 매개 변수의 값이 yes로 설정되어 있다고 가정해 봅니다. 에이전트는 해당 에이전트 구성 개체의 AllowLocalConfig 매개 변수 값이 no로 설정된 경우에도 로그 파일을 생성합니다. 또한 LocalConfig.conf 파일에서 관련 로깅 매개 변수를 설정하여 에이전트 구성 개체의 다른 설정을 무시할 수도 있습니다.
  3. 다음 매개 변수를 사용하여 오류 파일의 이름을 포함한 전체 경로를 지정합니다.
    • casso12kr
      LogFileName
      로그 파일의 이름을 포함한 전체 경로를 지정합니다.
      기본값:
      No
      예:
      (Windows)
      web_agent_home
      \log\WebAgent.log
      예:
      (UNIX/LInux) /export/iPlanet/servers/https-jsmith/logs/WebAgent.log
    • casso12kr
      LogFileName32
      32 비트 응용 프로그램을 보호하는 64 비트 Windows 운영 환경에서 IIS용
      Single Sign-On
      웹 에이전트에 대한 로그 파일의 전체 경로를 지정합니다. 64 비트 Windows 운영 환경에서는 32 비트 응용 프로그램이 Wow64 모드에서 실행됩니다. 로깅하도록 설정된 경우 이 매개 변수가 설정되지 않으면 IIS용 웹 에이전트에서 로그 파일 이름에 _32를 추가합니다.
      기본값
      : No
      제한
      : Windows 64 비트 운영 환경에만 적용됩니다. 경로 끝에 파일 이름을 지정하십시오.
      : (Wow64 모드를 사용하는 Windows 64 비트 운영 환경)
      web_agent_home
      \log\WebAgent32.log
  4. (선택 사항) 정책 서버의 에이전트 구성 개체 또는 로컬 구성 파일에서 다음 매개 변수를 설정합니다.
    • casso12kr
      LogAppend
      새 로그 정보를 기존 로그 파일의 끝에 추가합니다. 이 매개 변수가 no로 설정되면 로깅을 호출할 때마다 전체 로그 파일이 다시 작성됩니다.
      기본값:
      No
    • casso12kr
      LogFileSize
      로그 파일 크기 제한(MB)을 지정합니다. 현재 로그 파일의 크기가 이 값이 되면 새 로그 파일이 생성됩니다. 새 로그 파일의 이름은 다음과 같은 명명 규칙을 사용하여 지정됩니다.
      • 프레임워크 에이전트의 경우 원래 이름에 시퀀스 번호를 추가하여 새 로그 파일 이름을 지정합니다. 예를 들어 myfile.log라는 로그 파일은 크기 제한에 도달하면 myfile.log.1로 이름이 바뀝니다.
      • 기존 에이전트의 경우 원래 이름에 날짜 및 타임스탬프를 추가하여 새 로그 파일 이름을 지정합니다. 예를 들어 myfile.log라는 로그 파일은 크기 제한에 도달하면 myfile.log.09-18-2003-16-07-07로 이름이 바뀝니다.
      이전 파일은 수동으로 보관하거나 제거하십시오.
      기본값:
      0(롤오버 안 함)
      예:
      80
    • casso12kr
      LogLocalTime
      로그에 GMT(그리니치 표준시)를 사용할지 아니면 로컬 시간을 사용할지를 지정합니다. GMT를 사용하려면 이 설정을 no로 변경하십시오. 이 매개 변수가 없으면 기본 설정이 사용됩니다.
      기본값:
      Yes
      로컬 구성 파일을 사용하는 경우 다음과 같이 설정됩니다.
      LogFile="yes" LogFileName="/export/iPlanet/servers/https-myserver/logs/errors.log" LogAppend="no" LogFileSize="80" LogLocalTime="yes"
    오류 로깅을 사용할 수 있습니다.
TLI 로깅 사용
에이전트와 정책 서버 간의 연결을 검사하려는 경우 전송 계층 인터페이스 로깅이 사용되도록 설정합니다.
TLI 로깅이 사용되도록 설정하려면
  1. 다음 환경 변수를 웹 서버에 추가합니다.
    SM_TLI_LOG_FILE
  2. 다음과 같이 디렉터리 및 로그 파일 이름을 변수 값으로 지정합니다.
    directory_name
    /log_file_name.log
  3. 에이전트가 사용되도록 설정되었는지 확인합니다.
  4. 웹 서버를 다시 시작합니다.
    TLI 로깅을 사용할 수 있습니다.
저장되는 로그 파일의 수 제한
에이전트에 유지되는 로그 파일의 수를 제한할 수 있습니다. 예를 들어 에이전트 로그가 저장되는 시스템의 디스크 공간을 절약하려면 다음 매개 변수를 사용하여 로그 파일의 수를 제한할 수 있습니다.
LogFilesToKeep
유지되는 에이전트 로그 파일의 수를 지정합니다. 다음 경우에 새 로그 파일이 생성됩니다.
  • 에이전트가 시작되는 경우
  • LogFileSize 매개 변수 값에 지정된 로그 파일의 크기 제한에 도달하는 경우
이 매개 변수의 값을 변경해도 유지하려는 개수를 초과하는 기존 로그 파일이 자동으로 삭제되지는
않습니다
. 예를 들어 시스템에 500개의 로그 파일이 저장되어 있는데 그 중 50개만 유지하려는 경우 에이전트가 나머지 450개의 파일을 삭제하지
않습니다
.
이 매개 변수의 값을 0으로 설정하면 모든 로그 파일이 유지됩니다.
기본값
: 0
다음 단계를 수행하십시오.
시스템의 기존 로그 파일을 보관하거나 삭제합니다.
LogAppend 매개 변수의 값을 no로 설정합니다.
LogFilesToKeep 매개 변수 값을 유지할 로그 파일의 수로 변경합니다.