system-loggers
현재 설정되어 있는 모든 로그 수집기의 상태를 조회합니다. 클러스터 관리자 권한이 필요합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 권한 |
| 라이선스 사용량 | 집계 안 함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
system-loggers
옵션
옵션 없음
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| namespace | 문자열 | 수집기가 속한 노드의 이름. local, 원격 노드의 이름, 또는 센트리의 이름(GUID)으로 반환됩니다. |
| name | 문자열 | 수집기의 이름 |
| factory_namespace | 문자열 | 수집기 팩토리가 속한 노드의 이름 |
| factory_name | 문자열 | 수집기 팩토리의 이름 |
| status | 문자열 | 수집기의 실행 상태. running 또는 stopped |
| interval | 32비트 정수 | 수집기 실행 주기 (단위: 밀리초) |
| cron_schedule | 문자열 | 예약된 실행 일정 (cron 표현식) |
| log_count | 64비트 정수 | 현재까지 수집된 로그 건수 |
| drop_count | 64비트 정수 | 드롭된 로그 건수 |
| log_volume | 64비트 정수 | 수집된 로그 데이터의 전체 용량 (단위: 바이트) |
| drop_volume | 64비트 정수 | 드롭된 로그 데이터의 전체 용량 (단위: 바이트) |
| last_start_at | 날짜 | 수집기가 가장 최근에 시작된 시각 |
| last_run_at | 날짜 | 수집기가 가장 최근에 실행된 시각 |
| last_log_at | 날짜 | 마지막 로그가 유입된 시각 |
| last_write_at | 날짜 | 마지막 로그가 기록된 시각 |
| failure | 문자열 | 일시적 오류 메시지. 오류가 없으면 null을 반환합니다. |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 95010 | 읽기 권한이 없습니다. 클러스터 관리자 권한이 필요합니다. | 클러스터 관리자 권한이 없는 경우 |
런타임 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 95020 | 읽기 권한이 없습니다. 클러스터 관리자 권한이 필요합니다. | 클러스터 관리자 권한이 없는 경우 |
| 95011 | 로거를 읽어오는데 실패했습니다.(msg:[msg]) | 수집기 상태를 조회하는 중 오류가 발생한 경우 |
설명
system-loggers 명령어는 로그프레소에 설정된 모든 로그 수집기의 현재 상태를 조회합니다. 수집기별로 실행 상태, 수집 건수, 드롭 건수, 실행 주기, 최근 실행 시각 등의 정보를 반환합니다.
수집기 실행 중에 일시적 오류가 발생한 경우 failure 필드에 오류 메시지가 반환됩니다. 오류가 없으면 failure 필드는 null입니다.
사용 예
-
전체 수집기 상태 조회
system-loggers -
실행 중인 수집기만 조회
system-loggers | search status == "running" -
수집기별 수집 건수 기준으로 정렬
system-loggers | sort -log_count -
오류가 발생한 수집기 조회
system-loggers | search isnotnull(failure)
호환성
system-loggers 명령어는 소나 4.0 이전 버전부터 제공되었습니다.