sentry-logger-set-time-range

원격 센트리 수집기의 동작 허용 시간대를 설정합니다.

명령어 속성

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

문법

sentry-logger-set-time-range [timeout=INT]

옵션

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

입력 필드

필드	타입	필수 여부	설명
guid	문자열	필수	센트리 고유 식별자
name	문자열	필수	수집기 이름
start_time	문자열	선택	수집 시작 시각(형식: `HH:mm`). `end_time`과 함께 지정해야 합니다.
end_time	문자열	선택	수집 종료 시각(형식: `HH:mm`). `start_time`과 함께 지정해야 합니다.

출력 필드

필드	타입	설명
_error	문자열	오류 발생 시 원본 레코드에 추가되는 오류 메시지

오류 코드

파싱 오류

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

런타임 오류

_error 필드를 통해 오류 내용을 반환합니다.

오류 메시지	설명
guid is null	입력 레코드의 `guid` 필드 값이 null인 경우
guid should be string	입력 레코드의 `guid` 필드 값이 문자열이 아닌 경우
guid should be non empty string	입력 레코드의 `guid` 필드 값이 빈 문자열인 경우
name should be not null	입력 레코드의 `name` 필드 값이 null인 경우
name should be string	입력 레코드의 `name` 필드 값이 문자열이 아닌 경우
name should be non empty string	입력 레코드의 `name` 필드 값이 빈 문자열인 경우
invalid start_time format	`start_time` 필드 값이 유효한 `HH:mm` 형식이 아닌 경우
invalid end_time format	`end_time` 필드 값이 유효한 `HH:mm` 형식이 아닌 경우
start_time is not null but end_time is null	`start_time`이 지정되었으나 `end_time`이 null인 경우
end_time is not null but start_time is null	`end_time`이 지정되었으나 `start_time`이 null인 경우
not connected	센트리가 접속된 상태가 아닌 경우
timeout	RPC 요청 타임아웃 시간을 초과한 경우
disconnected	RPC 요청 처리 중에 연결이 단절된 경우

위에 정의된 오류 메시지 이외에 센트리가 설치된 시스템 상태에 따라 다른 RPC 예외 메시지가 반환될 수 있습니다.

설명

sentry-logger-set-time-range 명령어는 입력 레코드의 guid, name, start_time, end_time 필드를 읽어 해당 센트리 수집기의 동작 허용 시간대를 설정합니다. 비동기 RPC 메시지를 통해 센트리에 설정 변경을 요청합니다.

start_time과 end_time 필드 값이 모두 null이면 대상 수집기의 기존 수집 허용 시간 범위 설정을 제거합니다. 하나만 null이고 다른 하나가 null이 아니면 오류가 발생합니다.

시간 값은 HH:mm 형식의 5자리 문자열이어야 합니다. 시(hour)는 0~24 범위, 분(minute)은 0~60 범위여야 합니다.

이 명령어는 센트리의 RPC 응답 메시지를 수신하는 순서대로 결과를 반환하기 때문에 출력 레코드의 순서는 입력 레코드의 순서와 다를 수 있습니다.

사용 예

특정 수집기의 동작 허용 시간대 설정

sentry
| sentry-loggers
| search name == "weblog"
| eval start_time = "22:00", end_time = "06:00"
| sentry-logger-set-time-range

수집 허용 시간대 설정 제거

sentry
| sentry-loggers
| search name == "weblog"
| eval start_time = null, end_time = null
| sentry-logger-set-time-range

호환성

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