sentry-bundles

원격 센트리에서 번들 목록을 조회합니다.

명령어 속성

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

문법

sentry-bundles [timeout=INT]

옵션

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

입력 필드

필드타입필수 여부설명
guid문자열필수센트리 고유 식별자

출력 필드

필드타입설명
guid문자열센트리 고유 식별자
bundle_id64비트 정수번들 ID
symbolic_name문자열번들 심볼릭 이름
version문자열번들 버전
state문자열번들 상태
last_modified날짜마지막 변경 일시
integrity문자열무결성 상태
_error문자열오류 발생 시 오류 메시지

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

값설명
ACTIVE번들이 정상적으로 시작됨
INSTALLED번들의 의존성이 확보되지 않음
RESOLVED번들의 의존성이 확보되었으나 시작되지 않음
STARTING번들을 시작하는 중
STOPPING번들을 정지하는 중
UNINSTALLED번들이 삭제됨

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

값설명
no signature디지털 서명된 해시 값이 존재하지 않음
hash error번들 파일에 대한 SHA-512 해시 실패 (I/O 오류 등)
verified디지털 서명된 해시 값과 일치함
modified디지털 서명된 해시 값과 일치하지 않음 (변조됨)

오류 코드

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

guid 필드 값에 따라 _error 필드에 다음 오류 메시지가 할당될 수 있습니다.

오류 메시지설명
guid is null입력 레코드의 guid 필드 값이 null인 경우
guid should be string입력 레코드의 guid 필드 값이 문자열이 아닌 경우
guid should be non empty string입력 레코드의 guid 필드 값이 빈 문자열인 경우
not connected센트리가 접속된 상태가 아닌 경우
timeoutRPC 요청 타임아웃 시간을 초과한 경우
disconnectedRPC 요청 처리 중에 연결이 단절된 경우

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

설명

sentry-bundles 명령어는 입력 레코드의 guid 필드를 기반으로 원격 센트리에 번들 목록 정보를 요청하는 비동기 RPC 메시지를 전송합니다. 센트리로부터 응답을 수신하면 입력 레코드에 번들 정보를 추가하여 출력합니다.

비동기 RPC 요청 대기열의 최대 길이는 기본값 100이며, 로그프레소 환경 변수 logpresso.core.sentry_rpc_parallel로 조정할 수 있습니다. 대기열이 가득 찬 상태에서 일부 센트리가 응답하거나 타임아웃되면 대기열에 빈 자리가 생기는 만큼 추가로 RPC 메시지를 전송합니다.

센트리의 RPC 응답 메시지를 수신하는 순서대로 결과를 출력하므로, 출력 레코드의 순서는 입력 레코드의 순서와 다를 수 있습니다.

클러스터 환경에서 모든 수집 노드의 결과를 한 번에 조회하려면 sonar-sentry-bundles 명령어를 사용하세요.

사용 예

  1. 모든 센트리의 번들 목록 조회

    system-sentries | fields guid | sentry-bundles

  2. 특정 센트리에서 ACTIVE 상태인 번들만 조회

    system-sentries | fields guid | sentry-bundles | search state == "ACTIVE"

호환성

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