VMware Cloud Director 셀에 대한 로깅 구성

VMware Cloud Director에는 다양한 로깅 수준이 있습니다. 기본 로깅 구성은 바쁜 환경에서 사용하거나 문제 해결 중 이벤트를 캡처하는 데 충분하지 않을 수 있습니다. 로깅 수준과 보존되는 파일의 크기 및 수까지 변경해야 할 수 있습니다.

중요: VMware 글로벌 지원 팀의 지침 없이 로그 구성을 변경할 때 VMware Cloud Director 서버 그룹의 결과를 알고 있는지 확인합니다. 로깅 수준을 보다 세부적인 수준으로 변경하면 로그가 매우 빠르게 확장되고 VMware Cloud Director 환경의 디스크 공간이 부족할 수 있습니다.

VMware Cloud Director 로그는 /opt/vmware/vcloud-director/logs/ 디렉토리에 있습니다.

VMware Cloud Director 로그 구성 파일은 /opt/vmware/vcloud-director/etc/ 디렉토리에 있습니다. 로그 구성 파일의 이름은 log4j.properties입니다.

log4j.properties 로그 구성 파일을 사용자 지정하는 경우 VMware Cloud Director 업그레이드 전에 log4j.properties의 복사본을 만들고 업그레이드 후에 누락된 섹션을 수동으로 삽입해야 합니다.

로그 보존을 개선하고 VMware Cloud Director 로그가 일정 시간 동안 유지되도록 하려면 Syslog 서버를 사용하는 것이 좋습니다.

표 1. 로깅 수준

로깅 수준	설명
FATAL	이 수준은 애플리케이션이 실패할 수 있는 매우 심각한 오류 이벤트를 기록합니다.
ERROR	이 수준은 애플리케이션이 계속 실행되도록 허용할 수 있는 오류 이벤트를 기록합니다.
WARN	이 수준은 잠재적으로 유해한 상황 및 주의를 기록합니다.
INFO	이 수준은 대략적인 수준에서 애플리케이션의 진행률을 강조 표시하는 정보 메시지를 기록합니다.
DEBUG	이 수준은 세분화된 수준에서 애플리케이션을 디버깅하는 데 가장 유용한 정보 이벤트를 기록합니다.
TRACE	이 수준은 정보 이벤트를 DEBUG 수준 로깅보다 좀 더 세분화된 수준으로 기록합니다.

사전 요구 사항

/opt/vmware/vcloud-director/etc/log4j.properties 파일의 백업 복사본을 만듭니다.

고려

프로시저

1. VMware Cloud Director 콘솔에 root로 직접 로그인하거나 SSH 클라이언트를 사용하여 로그인합니다.
2. 텍스트 편집기에서 /opt/vmware/vcloud-director/etc/log4j.properties 파일을 엽니다.
3. 업데이트할 로그 파일 정의를 찾습니다.

   log4j.appender.Feature.File=logs/File_Name

   예를 들어 # Component appender for container debug 섹션의 로깅 수준을 변경할 수 있습니다. 섹션의 마지막 줄은 파일이 캡처하는 로깅 수준을 구성합니다.
4. 로깅 수준을 원하는 값으로 설정합니다.
   중요: VMware 글로벌 지원 팀의 지침 없이 로그 구성을 변경할 때 VMware Cloud Director 서버 그룹의 결과를 알고 있는지 확인합니다.

   TRACE가 가장 세부적인 수준이며 FATAL이 가장 간결합니다. 다음 예는 가장 세부적인 수준과 일치하도록 줄을 변경합니다.

   log4j.appender.vcloud.system.debug.threshold=TRACE

5. 기록을 보다 세부적인 수준으로 변경하면 로그 백업 수와 로그 파일 크기를 늘려야 할 수 있습니다.
   1. MaxFileSize 및 MaxBackupIndex 줄을 찾습니다.

      log4j.appender.vcloud.system.debug.MaxFileSize=

      log4j.appender.vcloud.system.debug.MaxBackupIndex=

   2. 기본 설정을 변경합니다.
      예를 들어 로그 파일이 롤오버되기 전에 로그 파일을 50MB로 확장하고 마지막 18개 로그를 유지하도록 하려면 다음과 같이 줄을 변경합니다.

      log4j.appender.vcloud.system.debug.MaxFileSize=50000KB

      log4j.appender.vcloud.system.debug.MaxBackupIndex=18

      파일이 선택한 50MB 크기에 도달하면 VMware Cloud Director는 새 파일에 계속 데이터를 기록하고 최대 18개의 백업을 유지합니다.
   중요: 로깅 수준을 보다 세부적인 수준으로 변경하면 로그가 매우 빠르게 확장되고 VMware Cloud Director 환경의 디스크 공간이 부족할 수 있습니다.
6. /opt/vmware/vcloud-director/etc/log4j.properties 파일을 저장합니다.
   VMware Cloud Director는 변경 내용을 즉시 적용합니다. Log4J.properties 파일에는 VMware Cloud Director가 유지하는 로그의 크기 및 양 변경과 관련한 명시적 줄이 없습니다.

VMware Cloud Director에서 API 요청 로깅 제어

VMware Cloud Director에서 수신 요청에 대한 정보를 캡처하고 저장하는 프로세스를 제어할 수 있습니다.

VMware Cloud Director는 VMware Cloud Director 셀에 대한 수신 요청을 요청 로그에 기록합니다. 로그의 이름은 YYYY_MM_DD.request.log 형식입니다. VMware Cloud Director request.log 파일은 /opt/vmware/vcloud-director/logs/ 디렉토리에서 찾을 수 있지만 log4j.properties 파일을 통해 로그를 구성할 수는 없습니다.

명령줄 도구의 manage-config 하위 명령을 사용하여 API 요청 로깅을 제어할 수 있습니다. manage-config 하위 명령은 전체 서버 그룹의 설정을 변경합니다. manage-config 하위 명령 옵션 및 인수에 대한 자세한 내용은 VMware Cloud Director에서 애플리케이션 구성 설정 업데이트에서 참조하십시오.

로그 순환은 하루에 한 번씩 발생할 수 있으며 개별 로그 파일의 크기 또는 모든 로그 파일의 총 크기에 연결되지 않습니다. VMware Cloud Director가 로그를 보관하는 기간(일)을 변경하여 순환 정책을 제어할 수 있습니다.

프로시저

1. VMware Cloud Director 셀의 OS에 root로 직접 로그인하거나 SSH 클라이언트를 사용하여 로그인합니다.
2. 요청 로그의 보존 정책을 변경하려면 셀 관리 도구의 manage-config 하위 명령을 사용합니다.
   보존 정책 값은 VMware Cloud Director가 NCSA(National Center for Supercomputing Applications) 준수 요청 로그를 보존하는 기간(일)을 나타냅니다. 기본값은 0이며 여기서 0은 영구를 의미합니다. 값을 삭제해도 로그가 영구적으로 유지됩니다. 로그를 보관할 수 있는 최소 시간은 1일입니다.

   /opt/vmware/vcloud-director/bin/cell-management-tool manage-config --name "vcloud.http.log.retainDays" --value New_Value

3. 변경 내용을 적용하려면 셀을 다시 시작해야 합니다.
   셀을 다시 시작하면 업데이트된 값을 사용하기 시작합니다. 셀의 일부 또는 모든 셀을 한 번에 다시 시작할 수 있습니다.