sentry-logger-stop

원격 센트리에서 수집기를 중지합니다.

명령어 속성

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

문법

sentry-logger-stop [timeout=INT]

옵션

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

입력 필드

필드	타입	필수 여부	설명
`guid`	문자열	필수	센트리 고유 식별자
`name`	문자열	필수	센트리 이름 공간에서 유일한 수집기 이름
`interval`	32비트 정수	선택	밀리초 단위의 수집기 중지 대기 시간. 지정하지 않으면 5000밀리초 적용

출력 필드

필드	타입	설명
`_error`	문자열	오류 발생 시 원본 레코드에 추가되는 오류 메시지. 정상 처리 시에는 이 필드가 존재하지 않음

_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` 필드 값이 빈 문자열인 경우
`timeout should be integer`	입력 레코드의 `interval` 필드 값이 정수가 아닌 경우
`not connected`	지정한 센트리가 접속 상태가 아닌 경우
`timeout`	RPC 요청이 타임아웃 시간을 초과한 경우
`disconnected`	RPC 요청 처리 중에 연결이 끊어진 경우

위에 정의된 값 이외에 센트리 환경에 따라 다른 RPC 오류 메시지가 할당될 수 있습니다.

오류 코드

파싱 오류

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

런타임 오류

해당 사항 없음

설명

sentry-logger-stop 명령어는 입력 레코드의 guid와 name 필드를 사용하여 원격 센트리에서 수집기를 중지하는 비동기 RPC 요청을 전송합니다. interval 필드로 수집기 중지 대기 시간을 밀리초 단위로 지정할 수 있으며, 지정하지 않으면 5000밀리초(5초)가 적용됩니다.

비동기 RPC 요청 대기열의 최대 크기는 기본값 100이며, 시스템 속성 logpresso.core.sentry_rpc_parallel로 변경할 수 있습니다. 대기열이 가득 찬 경우 기존 요청이 완료되거나 타임아웃될 때까지 대기한 후 새 요청을 전송합니다.

RPC 응답 수신 순서에 따라 결과가 출력되므로 출력 레코드의 순서는 입력 레코드의 순서와 다를 수 있습니다.

사용 예

모든 수집기 중지

sentry | sentry-loggers | fields guid, name | sentry-logger-stop

특정 수집기를 중지 대기 시간을 지정하여 중지

sentry
| sentry-loggers
| search name == "syslog"
| eval interval = 10000
| fields guid, name, interval
| sentry-logger-stop timeout=60

호환성

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