sentry-logger-remove
원격 센트리에서 수집기를 삭제합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 가공 쿼리 |
| 필요 권한 | 관리자 |
| 라이선스 사용량 | 해당 없음 |
| 병렬 실행 | 지원 |
| 분산 실행 | 미지원 |
문법
sentry-logger-remove [timeout=INT]
옵션
timeout=INT- 초 단위 RPC 타임아웃. 1 이상 600 이하의 값을 지정할 수 있습니다. (기본값:
30)
입력 필드
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
guid | 문자열 | 필수 | 센트리 고유 식별자 |
name | 문자열 | 필수 | 센트리 이름 공간에서 유일한 수집기 이름 |
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
_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 필드 값이 빈 문자열인 경우 |
not connected | 지정한 센트리가 접속 상태가 아닌 경우 |
timeout | RPC 요청이 타임아웃 시간을 초과한 경우 |
disconnected | RPC 요청 처리 중에 연결이 끊어진 경우 |
위에 정의된 값 이외에 센트리 환경에 따라 다른 RPC 오류 메시지가 할당될 수 있습니다.
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 23100 | 센트리 RPC 호출 권한이 없습니다. | 관리자 권한이 없는 세션에서 명령어를 실행한 경우 |
| 23101 | 유효하지 않은 센트리 RPC 타임아웃 옵션 값입니다. 1부터 600 사이의 값을 사용하세요. | timeout 옵션 값이 정수가 아니거나 1~600 범위를 벗어난 경우 |
런타임 오류
해당 사항 없음
설명
sentry-logger-remove 명령어는 입력 레코드의 guid와 name 필드를 사용하여 원격 센트리에서 수집기를 삭제하는 비동기 RPC 요청을 전송합니다. RPC 요청이 성공하면 로그프레소 서버에 등록된 관리 대상 수집기 정보도 함께 삭제합니다.
비동기 RPC 요청 대기열의 최대 크기는 기본값 100이며, 시스템 속성 logpresso.core.sentry_rpc_parallel로 변경할 수 있습니다. 대기열이 가득 찬 경우 기존 요청이 완료되거나 타임아웃될 때까지 대기한 후 새 요청을 전송합니다.
RPC 응답 수신 순서에 따라 결과가 출력되므로 출력 레코드의 순서는 입력 레코드의 순서와 다를 수 있습니다.
Caution
수집기 삭제는 되돌릴 수 없습니다. 쿼리의 마지막 명령어를 `# sentry-logger-remove`로 주석 처리하여 삭제 대상을 먼저 확인하세요.
사용 예
-
특정 수집기 일괄 삭제
sentry | sentry-loggers | search name == "wtmp_linux" | sentry-logger-remove -
RPC 타임아웃을 지정하여 수집기 삭제
sentry | sentry-loggers | search name == "syslog" | sentry-logger-remove timeout=60
호환성
sentry-logger-remove 명령어는 소나 4.0 이전 버전부터 제공되었습니다.