sentry-loggers

원격 센트리에서 수집기 목록을 조회합니다.

명령어 속성

항목	설명
명령어 유형	가공 쿼리
필요 권한	관리자
라이선스 사용량	해당 없음
병렬 실행	지원
분산 실행	미지원

문법

sentry-loggers [timeout=INT]

옵션

timeout=INT: 초 단위 RPC 타임아웃. 1에서 600 사이의 값을 지정할 수 있습니다. (기본값: 30)

입력 필드

필드	타입	필수 여부	설명
guid	문자열	필수	센트리 고유 식별자

출력 필드

필드	타입	설명
guid	문자열	센트리 고유 식별자
name	문자열	수집기 이름
description	문자열	수집기 설명
factory_name	문자열	수집기 유형 식별자
status	문자열	수집기 상태. `running` 또는 `stopped`
interval	32비트 정수	수집 주기(단위: 밀리초)
cron_schedule	문자열	크론 형식 수집 일정
transformer	문자열	트랜스포머 식별자
stop_reason	문자열	수집기 중지 사유
log_count	64비트 정수	수집 건수
drop_count	64비트 정수	버린 건수
log_volume	64비트 정수	수집 용량(단위: 바이트)
drop_volume	64비트 정수	버린 용량(단위: 바이트)
last_start_at	날짜	수집기를 활성화한 최근 시각
last_run_at	날짜	수집을 실행한 최근 시각
last_log_at	날짜	마지막으로 수집된 로그의 시각
last_write_at	날짜	로그를 기록한 최근 시스템 시각
start_time	문자열	수집 시작 시각(형식: `HH:mm`)
end_time	문자열	수집 종료 시각(형식: `HH:mm`)
failure	문자열	수집 중 기록된 수집기 중지 사유
configs	맵	수집기 설정

오류 코드

파싱 오류

오류 코드	메시지	설명
23100	센트리 RPC 호출 권한이 없습니다.	관리자 권한이 없는 세션에서 명령어를 실행한 경우
23101	유효하지 않은 센트리 RPC 타임아웃 옵션 값입니다. 1부터 600 사이의 값을 사용하세요.	`timeout` 값이 숫자가 아니거나 1~600 범위를 벗어난 경우

런타임 오류

해당 사항 없음

설명

sentry-loggers 명령어는 입력 레코드의 guid 필드를 기반으로 원격 센트리에 비동기 RPC 요청을 전송하여 수집기 목록을 조회합니다. 센트리 버전이 3.8.0 이상이면 getLoggers2 RPC 메서드를 호출하고, 그 미만이면 getLoggers 메서드를 호출합니다.

비동기 RPC 요청 대기열의 크기는 시스템 속성 logpresso.core.sentry_rpc_parallel로 조정할 수 있으며, 기본값은 100입니다. 대기열이 가득 차면 기존 요청이 완료되거나 타임아웃될 때까지 새 요청을 보류합니다.

RPC 응답을 수신하는 순서대로 결과를 출력하므로, 출력 레코드의 순서는 입력 레코드의 순서와 다를 수 있습니다.

입력 레코드의 guid 필드가 null이거나, 문자열이 아니거나, 빈 문자열이거나, 해당 센트리가 접속 상태가 아니면 _error 필드에 오류 메시지를 할당하고 원본 레코드를 그대로 출력합니다. RPC 타임아웃이 발생하면 _error 필드에 timeout을 할당합니다.

클러스터 환경에서 모든 수집 노드의 결과를 한 번에 조회하려면 sonar-sentry-loggers 명령어를 사용하세요.

사용 예

모든 센트리의 수집기 목록 조회

system-sentries | fields guid | sentry-loggers

타임아웃을 60초로 지정하여 조회

system-sentries | fields guid | sentry-loggers timeout=60

호환성

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