sentry-logger-configs

원격 센트리에서 각 수집기의 설정을 조회합니다.

명령어 속성

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

문법

sentry-logger-configs [timeout=INT]

옵션

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

입력 필드

필드	타입	필수 여부	설명
`guid`	문자열	필수	센트리 고유 식별자
`name`	문자열	필수	설정을 조회할 수집기 이름

출력 필드

입력 레코드의 모든 필드를 유지하며, 아래 필드를 추가합니다.

필드	타입	설명
`configs`	맵	수집기 설정 키-값 쌍
`_error`	문자열	오류 발생 시 원본 레코드에 추가되는 오류 메시지

_error 필드에 할당될 수 있는 값은 다음과 같습니다:

오류 메시지	설명
guid is null	입력 레코드의 `guid` 필드 값이 null인 경우
guid should be string	입력 레코드의 `guid` 필드 값이 문자열이 아닌 경우
guid should be non empty string	입력 레코드의 `guid` 필드 값이 빈 문자열인 경우
not connected	지정된 센트리가 접속 상태가 아닌 경우
name should be not null	입력 레코드의 `name` 필드 값이 null인 경우
name should be string	입력 레코드의 `name` 필드 값이 문자열이 아닌 경우
name should be non empty string	입력 레코드의 `name` 필드 값이 빈 문자열인 경우
timeout	RPC 응답이 타임아웃 시간 내에 도착하지 않은 경우
disconnected	RPC 호출 도중 센트리 접속이 끊어진 경우

오류 코드

파싱 오류

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

런타임 오류

해당 사항 없음

설명

sentry-logger-configs 명령어는 입력 레코드의 guid 필드로 센트리를 식별하고, name 필드로 지정된 수집기의 설정을 원격 RPC 호출(getLoggerConfigs)로 조회합니다. 조회 결과는 configs 필드에 맵으로 할당하여 입력 레코드와 합쳐 출력합니다.

입력 필드 값이 유효하지 않거나 센트리가 접속 상태가 아닌 경우, 원본 레코드에 _error 필드를 추가하여 출력합니다. RPC 응답이 타임아웃 시간 내에 도착하지 않으면 해당 레코드에 _error: timeout을 설정합니다.

최대 100개의 RPC 요청을 동시에 처리합니다. logpresso.core.sentry_rpc_parallel 시스템 속성으로 동시 처리 한도를 변경할 수 있습니다.

사용 예

수집기 설정 조회

system-sentries
| eval name = "local\\\\syslog"
| sentry-logger-configs
| fields guid, name, configs

타임아웃을 지정하여 수집기 설정 조회

system-sentries
| eval name = "local\\\\syslog"
| sentry-logger-configs timeout=60
| fields guid, name, configs

호환성

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