system-logs

로그프레소 시스템 로그를 오름차순으로 조회합니다. 클러스터 관리자 권한이 필요합니다.

system-logs [tail=INT] [duration=INT{mon|w|d|h|m|s}] [from=DATE] [to=DATE]

tail=INT: 조회할 최근 시스템 로그의 라인 수. 1 이상 100,000 이하의 정수를 지정합니다. tail 옵션은 duration, from, to 옵션과 함께 사용할 수 없습니다.
duration=INT{mon|w|d|h|m|s}: 현재 시각으로부터 일정 시간 범위 이내의 로그로 한정합니다. mon(월), w(주), d(일), h(시), m(분), s(초) 단위를 사용합니다. 예: 10s는 쿼리 실행 시각을 기준으로 최근 10초를 의미합니다. from과 to 옵션을 모두 지정한 경우에는 duration 옵션을 사용할 수 없습니다.
from=DATE: 조회 범위의 시작 시각. yyyy[MM[dd[HH[mm[ss]]]]] 형식으로 입력합니다. 월, 일 등을 입력하지 않으면 가능한 첫 시각으로 설정됩니다. 시작 시각은 조회 결과에 포함됩니다.
to=DATE: 조회 범위의 끝 시각. yyyy[MM[dd[HH[mm[ss]]]]] 형식으로 입력합니다. 월, 일 등을 입력하지 않으면 가능한 첫 시각으로 설정됩니다. 끝 시각은 조회 결과에 포함되지 않습니다.

필드	타입	설명
_time	날짜	로그를 수신하거나 생성한 시각
class	문자열	로그를 생성한 클래스의 이름
level	문자열	로그의 심각도 수준 (DEBUG, TRACE, INFO, WARN, ERROR, FATAL)
msg	문자열	로그 메시지 본문

오류 코드	메시지	설명
95020	읽기 권한이 없습니다. 클러스터 관리자 권한이 필요합니다.	클러스터 관리자 권한이 없는 경우
95021	tail 값은 1이상 100,000이하의 정수여야 합니다. (입력값: [value])	`tail` 옵션 값이 1 미만이거나 100,000 초과이거나 정수가 아닌 경우
95022	tail 옵션은 duration, from, to 옵션과 별도로 사용해 주세요.	`tail` 옵션을 `duration`, `from`, `to` 옵션과 함께 사용한 경우
95023	from 옵션과 to 옵션을 모두 지정하였을 때에는 duration 옵션을 사용할 수 없습니다.	`from`과 `to`를 모두 지정한 상태에서 `duration`을 사용한 경우
95030	from 값이 유효하지 않습니다.	`from` 옵션 값을 날짜로 파싱할 수 없는 경우
95031	to 값이 유효하지 않습니다.	`to` 옵션 값을 날짜로 파싱할 수 없는 경우
95032	from 값이 유효하지 않습니다.	`to` 값이 `from` 값보다 이전인 경우

해당 사항 없음

system-logs 명령어는 로그프레소 시스템의 내부 로그 파일(araqne.log)을 읽어 시스템 로그를 조회합니다. 로그는 기본적으로 오름차순(오래된 로그부터)으로 반환됩니다.

tail 옵션을 사용하면 가장 최근의 로그부터 역순으로 읽어 지정된 라인 수만큼 반환합니다. tail 옵션은 duration, from, to 옵션과 동시에 사용할 수 없습니다.

from과 to 옵션을 사용하면 해당 시간 범위의 로그 파일만 선택적으로 읽습니다. duration 옵션은 from 또는 to 옵션과 조합하여 시간 범위를 지정할 수 있지만, from과 to를 모두 지정한 경우에는 사용할 수 없습니다.

오류 로그만 필터링

system-logs duration=1d | search level == "ERROR"

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