system-loggers

현재 설정되어 있는 모든 로그 수집기의 상태를 조회합니다. 클러스터 관리자 권한이 필요합니다.

명령어 속성

항목설명
명령어 유형드라이버 쿼리
필요 권한클러스터 관리자 권한
라이선스 사용량집계 안 함
병렬 실행미지원
분산 실행미지원

문법

system-loggers

옵션

옵션 없음

출력 필드

필드타입설명
namespace문자열수집기가 속한 노드의 이름. local, 원격 노드의 이름, 또는 센트리의 이름(GUID)으로 반환됩니다.
name문자열수집기의 이름
factory_namespace문자열수집기 팩토리가 속한 노드의 이름
factory_name문자열수집기 팩토리의 이름
status문자열수집기의 실행 상태. running 또는 stopped
interval32비트 정수수집기 실행 주기 (단위: 밀리초)
cron_schedule문자열예약된 실행 일정 (cron 표현식)
log_count64비트 정수현재까지 수집된 로그 건수
drop_count64비트 정수드롭된 로그 건수
log_volume64비트 정수수집된 로그 데이터의 전체 용량 (단위: 바이트)
drop_volume64비트 정수드롭된 로그 데이터의 전체 용량 (단위: 바이트)
last_start_at날짜수집기가 가장 최근에 시작된 시각
last_run_at날짜수집기가 가장 최근에 실행된 시각
last_log_at날짜마지막 로그가 유입된 시각
last_write_at날짜마지막 로그가 기록된 시각
failure문자열일시적 오류 메시지. 오류가 없으면 null을 반환합니다.

오류 코드

파싱 오류
오류 코드메시지설명
95010읽기 권한이 없습니다. 클러스터 관리자 권한이 필요합니다.클러스터 관리자 권한이 없는 경우
런타임 오류
오류 코드메시지설명
95020읽기 권한이 없습니다. 클러스터 관리자 권한이 필요합니다.클러스터 관리자 권한이 없는 경우
95011로거를 읽어오는데 실패했습니다.(msg:[msg])수집기 상태를 조회하는 중 오류가 발생한 경우

설명

system-loggers 명령어는 로그프레소에 설정된 모든 로그 수집기의 현재 상태를 조회합니다. 수집기별로 실행 상태, 수집 건수, 드롭 건수, 실행 주기, 최근 실행 시각 등의 정보를 반환합니다.

수집기 실행 중에 일시적 오류가 발생한 경우 failure 필드에 오류 메시지가 반환됩니다. 오류가 없으면 failure 필드는 null입니다.

사용 예

  1. 전체 수집기 상태 조회

    system-loggers
    
  2. 실행 중인 수집기만 조회

    system-loggers | search status == "running"
    
  3. 수집기별 수집 건수 기준으로 정렬

    system-loggers | sort -log_count
    
  4. 오류가 발생한 수집기 조회

    system-loggers | search isnotnull(failure)
    

호환성

system-loggers 명령어는 소나 4.0 이전 버전부터 제공되었습니다.