sentry-logger-connect
원격 센트리 수집기의 로그를 수신하도록 설정합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 가공 쿼리 |
| 필요 권한 | 관리자 |
| 라이선스 사용량 | 해당 없음 |
| 병렬 실행 | 지원 |
| 분산 실행 | 미지원 |
문법
sentry-logger-connect [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 필드 값이 빈 문자열인 경우 |
| 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-connect 명령어는 입력 레코드의 guid 필드로 센트리를 식별하고, name 필드로 지정된 수집기의 로그를 수신하도록 원격 RPC 호출(connectRemoteLogger)로 설정합니다.
입력 필드 값이 유효하지 않거나 센트리가 접속 상태가 아닌 경우, 원본 레코드에 _error 필드를 추가하여 출력합니다. RPC 응답이 타임아웃 시간 내에 도착하지 않으면 해당 레코드에 _error: timeout을 설정합니다.
최대 100개의 RPC 요청을 동시에 처리합니다. logpresso.core.sentry_rpc_parallel 시스템 속성으로 동시 처리 한도를 변경할 수 있습니다.
사용 예
-
수집기 로그 수신 설정
system-sentries | eval name = "local\\\\syslog" | sentry-logger-connect | search isnull(_error) | fields guid, name -
타임아웃을 지정하여 수집기 로그 수신 설정
system-sentries | eval name = "local\\\\syslog" | sentry-logger-connect timeout=60 | fields guid, name, _error
호환성
sentry-logger-connect 명령어는 소나 4.0 이전 버전부터 제공되었습니다.