sentry-processes

원격 센트리에서 프로세스 목록을 조회합니다.

sentry-processes [timeout=INT]

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

pid, cpu_usage, working_set 필드의 값과 타입은 센트리가 설치된 운영체제에 따라 다음과 같이 다릅니다.

운영체제	pid	cpu_usage	working_set
리눅스	32비트 정수	CPU 사용률을 측정하지 않으므로 항상 `0`(32비트 정수)	`/proc/[pid]/status`의 VmSize 값, 즉 가상 메모리 크기를 바이트로 환산한 값(64비트 정수)
윈도우	32비트 정수	약 0.1초 동안 잰 CPU 사용률(%)을 프로세서 수로 나누고 소수점 이하를 버린 값(32비트 정수). 사용률을 재지 못한 프로세스는 null	워킹 셋 크기(64비트 정수)
AIX, Solaris	문자열	`ps` 명령 출력의 %CPU 열 값(문자열)	`ps` 명령 출력의 VSZ 열 값, 즉 KB 단위의 가상 메모리 크기에 1024를 곱한 값(32비트 정수)

name 필드에는 리눅스 센트리가 /proc/[pid]/status의 Name 값을, 윈도우 센트리가 확장자를 포함한 실행 파일 이름을, AIX·Solaris 센트리가 ps 명령 출력의 comm 열 값을 할당합니다.

HP-UX 센트리는 프로세스 목록을 조회하지 못하며, 결과 레코드의 _error 필드에 오류 메시지가 할당됩니다.

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

_error 필드를 통해 오류 내용을 반환합니다.

오류 메시지	설명
guid is null	입력 레코드의 `guid` 필드 값이 null인 경우
guid should be string	입력 레코드의 `guid` 필드 값이 문자열이 아닌 경우
guid should be non empty string	입력 레코드의 `guid` 필드 값이 빈 문자열인 경우
not connected	센트리가 접속된 상태가 아닌 경우
timeout	RPC 요청 타임아웃 시간을 초과한 경우
disconnected	RPC 요청을 보낼 때 센트리 연결이 이미 끊어져 있는 경우

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

sentry-processes 명령어는 입력 레코드의 guid 필드를 읽어 해당 센트리에 비동기 RPC 메시지를 전송하고, 실행 중인 프로세스 목록을 조회합니다.

이 명령어는 센트리의 RPC 응답 메시지를 수신하는 순서대로 결과를 반환하기 때문에 출력 레코드의 순서는 입력 레코드의 순서와 다를 수 있습니다.

비동기 RPC 요청 대기열의 최대 길이는 기본값 100이며, 로그프레소 환경 변수 logpresso.core.sentry_rpc_parallel로 조정할 수 있습니다.

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

메모리 크기 기준으로 정렬하여 조회

sentry | fields guid | sentry-processes | sort -working_set

타임아웃을 60초로 설정하여 조회

sentry | fields guid | sentry-processes timeout=60

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