16.6. 로그 수집 도구

16.6.1. 로그 수집기

로그 수집 도구는 Red Hat Enterprise Virtualization Manager에 포함되어 있습니다. 이러한 도구를 사용하여 지원 요청 시 Red Hat Enterprise Virtualization 환경에서 관련 로그를 쉽게 수집할 수 있습니다.
로그 수집 명령은 engine-log-collector입니다. root 사용자로 로그인하여 Red Hat Enterprise Virtualization 환경의 관리자 인증 정보를 입력합니다. engine-log-collector -h 명령은 engine-log-collector 명령의 모든 유효한 옵션 목록을 포함하여 사용 방법을 표시합니다.

16.6.2. engine-log-collector 명령 구문

로그 수집 명령의 기본 구문은 다음과 같습니다:
engine-log-collector [options] list [all, clusters, datacenters]
engine-log-collector [options] collect
작업이 지원되는 두 가지 모드는 listcollect입니다.
  • list 매개 변수는 Red Hat Enterprise Virtualization Manager에 연결된 호스트, 클러스터, 데이터 센터를 나열합니다. 나열된 개체에 기반하여 로그 수집을 필터링할 수 있습니다.
  • collect 매개 변수는 Red Hat Enterprise Virtualization Manager에서 로그를 수집합니다. 수집된 로그는 /tmp/logcollector 디렉토리 아래의 아카이브된 파일에 저장됩니다. engine-log-collector 명령은 각 로그를 특정 파일이름으로 지정합니다.
다른 매개 변수를 지정하지 않을 경우 기본적으로 자신이 속한 데이터 센터 및 클러스터와 함께 사용할 수 있는 호스트가 나열됩니다. 특정 로그를 검색하려면 사용자 이름 및 암호를 입력하라는 메세지가 표시됩니다.
engine-log-collector 명령을 상세 지정하기 위한 여러 매개 변수가 있습니다.

일반 옵션

--version
사용 중인 명령의 버전 번호를 표시하고 프롬프트로 돌아갑니다.
-h, --help
명령 사용 정보를 표시하고 프롬프트로 돌아갑니다.
--conf-file=PATH
도구가 사용할 설정 파일로 PATH를 설정합니다.
--local-tmp=PATH
로그가 저장된 디렉토리로 PATH를 설정합니다. 기본 디렉토리는 /tmp/logcollector입니다.
--ticket-number=TICKET
SOS 보고서와 관련된 티켓 또는 기술 문의 번호로 TICKET을 설정합니다.
--upload=FTP_SERVER
FTP를 사용하여 전송되는 검색된 로그의 대상으로 FTP_SERVER를 설정합니다. Red Hat 지원 담당자가 권장하지 않는 한 이 옵션을 사용하지 마십시오.
--log-file=PATH
명령이 로그 출력을 위해 사용할 특정 파일 이름으로 PATH를 설정합니다.
--quiet
콘솔 출력을 최소로 감소시키는 자동 모드 (Quiet mode)를 설정합니다. 기본값으로 자동 모드는 설정 해제되어 있습니다.
-v, --verbose
보다 자세한 콘솔 출력을 표시하는 상세 표시 모드 (Verbose mode)를 설정합니다. 상세 표시 모드는 기본값으로 설정 해제되어 있습니다.

Red Hat Enterprise Virtualization Manager 옵션

이 옵션은 로그 수집을 필터링하고 Red Hat Enterprise Virtualization Manager의 인증 정보를 지정합니다.
이러한 매개 변수는 특정 명령에 결합할 수 있습니다. 예를 들어 engine-log-collector --user=admin@internal --cluster ClusterA,ClusterB --hosts "SalesHost"* 명령은 사용자를 admin@internal로 지정하고 클러스터 AB에 있는 SalesHost 호스트만으로 로그 수집을 제한합니다.
--no-hypervisors
로그 수집에서 가상화 호스트를 제외합니다.
-u USER, --user=USER
사용자 로그인 이름을 설정합니다. USERuser@domain 형식으로 지정되며 여기서 user는 사용자 이름이고 domain은 사용 중인 디렉토리 서비스 도메인입니다. 사용자는 디렉토리 서비스에 존재해야 하며 Red Hat Enterprise Virtualization Manager가 알고 있어야 합니다.
-r FQDN, --rhevm=FQDN
로그를 수집할 Red Hat Enterprise Virtualization Manager 서버의 정규화된 도메인 이름을 설정합니다. 여기서 FQDN은 Manager의 정규화된 도메인 이름으로 변경합니다. 로그 수집기는 Red Hat Enterprise Virtualization Manager와 동일한 로컬 호스트에서 실행되는 것으로 간주되며 기본값은 localhost입니다.
-c CLUSTER, --cluster=CLUSTER
Red Hat Enterprise Virtualization Manager의 로그에 더하여 지정된 CLUSTER에 있는 가상화 호스트에서 로그를 수집합니다. 클러스터를 포함하려면 클러스터 이름 또는 일치하는 패턴 목록을 콤마로 구분하여 지정합니다.
-d DATACENTER, --data-center=DATACENTER
Red Hat Enterprise Virtualization Manager의 로그에 더하여 지정된 DATACENTER에 있는 가상화 호스트의 로그를 수집합니다. 데이터 센터를 포함하려면 데이터 센터 이름 또는 일치하는 패턴 목록을 콤마로 구분하여 지정합니다.
-H HOSTS_LIST, --hosts=HOSTS_LIST
Red Hat Enterprise Virtualization Manager의 로그에 더하여 지정된 HOSTS_LIST에 있는 가상화 호스트에서 로그를 수집합니다. 호스트를 포함하려면 호스트 이름, 정규화된 도메인 이름, IP 주소, 일치하는 패턴 목록을 콤마로 구분하여 지정합니다.

SOS 보고서 옵션

로그 수집기는 JBoss SOS 플러그인을 사용합니다. 다음 옵션을 사용하여 JMX 콘솔에서 데이터 수집을 활성화합니다.
--jboss-home=JBOSS_HOME
JBoss 설치 디렉토리 경로입니다. 기본값은 /var/lib/jbossas입니다.
--java-home=JAVA_HOME
Java 설치 디렉토리 경로입니다. 기본값은 /usr/lib/jvm/java입니다.
--jboss-profile=JBOSS_PROFILE
따옴표 및 공백으로 구분된 서버 프로파일 목록을 표시합니다. 지정된 프로파일로 로그 수집을 제한합니다. 기본값은 'rhevm-slimmed'입니다.
--enable-jmx
Red Hat Enterprise Virtualization의 JBoss JMX 인터페이스에서 런타임 통계 수집을 활성화합니다.
--jboss-user=JBOSS_USER
JBoss JMX를 호출할 수 있는 권한을 갖는 사용자입니다. 기본값은 admin입니다.
--jboss-logsize=LOG_SIZE
검색된 로그 파일의 최대 크기 (MB 단위)입니다.
--jboss-stdjar=STATE
JBoss 표준 JAR의 JAR 통계 수집을 설정합니다. STATEon 또는 off로 변경합니다. 기본값은 on입니다.
--jboss-servjar=STATE
모든 서버 설정 디렉토리에서 JAR 통계 수집을 설정합니다. STATEon 또는 off로 변경합니다. 기본값은 on입니다.
--jboss-twiddle=STATE
twiddle 데이터 수집을 on 또는 off로 설정합니다. Twiddle은 JMX 호출에서 데이터를 수집하기 위해 사용되는 JBoss 도구입니다. STATEon 또는 off로 변경합니다. 기본값은 on입니다.
--jboss-appxml=XML_LIST
XML 설명으로 검색할 애플리케이션 목록을 따옴표 및 공백으로 구분하여 표시합니다. 기본값은 all입니다.

SSH 설정

--ssh-port=PORT
가상화 호스트로 SSH 연결 시 사용할 포트로 PORT를 설정합니다.
-k KEYFILE, --key-file=KEYFILE
가상화 호스트에 액세스하기 위해 사용할 SSH 공개키로 KEYFILE을 설정합니다.
--max-connections=MAX_CONNECTIONS
가상화 호스트에서 로그 수집 시 최대 SSH 동시 연결 수로 MAX_CONNECTIONS을 설정합니다. 기본값은 10입니다.

PostgreSQL 데이터베이스 옵션

데이터베이스 사용자 이름 및 데이터베이스 이름이 기본값에서 변경되어 있을 경우 pg-userdbname 매개변수를 사용하여 지정합니다.
데이터베이스가 로컬 호스트에 없는 경우 pg-dbhost 매개 변수를 사용합니다. pg-host-key 매개 변수 옵션을 사용하여 원격 로그를 수집합니다. 원격 로그 수집을 위해 PostgreSQL SOS 플러그인을 데이터 베이스 서버에 설치해야 합니다.
--no-postgresql
데이터 베이스 수집을 비활성화합니다. --no-postgresql 매개 변수가 지정되어 있지 않을 경우 로그 수집기는 Red Hat Enterprise Virtualization Manager PostgreSQL데이터베이스에 연결하고 로그 보고서에 데이터를 추가해야 합니다.
--pg-user=USER
데이터 서버와의 연결에 사용할 사용자 이름으로 USER를 설정합니다. 기본값은 postgres입니다.
--pg-dbname=DBNAME
데이터 베이스 서버와의 연결에 사용할 데이터 베이스 이름으로 DBNAME을 설정합니다. 기본값은 rhevm입니다.
--pg-dbhost=DBHOST
데이터 베이스 서버의 호스트 이름으로 DBHOST를 설정합니다. 기본값은 localhost입니다.
--pg-host-key=KEYFILE
데이터 베이스 서버의 공개 ID 파일 (개인 키)로 KEYFILE을 설정합니다. 이 값은 기본값으로 설정되어 있지 않습니다. 데이터 베이스가 로컬 호스트에 존재하지 않을 경우에만 필요합니다.

16.6.3. 기본 로그 수집기 사용

추가 매개 변수를 지정하지 않고 engine-log-collector 명령을 실행하면 기본으로 Red Hat Enterprise Virtualization Manager 및 연결된 호스트에서의 모든 로그를 수집합니다. --no-postgresql 매개 변수가 추가되어 있지 않을 경우 데이터 베이스 로그도 수집합니다. 다음 예에서 로그 수집기를 실행하여 Red Hat Enterprise Virtualization Manager 및 세 개의 연결된 호스트에서 모든 로그를 수집합니다.

예 16.9. 로그 수집기 사용

# engine-log-collector
INFO: Gathering oVirt Engine information...
INFO: Gathering PostgreSQL the oVirt Engine database and log files from localhost...
Please provide REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):
About to collect information from 3 hypervisors. Continue? (Y/n):
INFO: Gathering information from selected hypervisors...
INFO: collecting information from 192.168.122.250
INFO: collecting information from 192.168.122.251
INFO: collecting information from 192.168.122.252
INFO: finished collecting information from 192.168.122.250
INFO: finished collecting information from 192.168.122.251
INFO: finished collecting information from 192.168.122.252
Creating compressed archive...
INFO Log files have been collected and placed in /tmp/logcollector/sosreport-rhn-account-20110804121320-ce2a.tar.xz.
The MD5 for this file is 6d741b78925998caff29020df2b2ce2a and its size is 26.7M