sonar-apps

로그프레소 소나에 등록된 앱 목록을 조회합니다. keywords 옵션으로 앱 이름 또는 설명을 기준으로 필터링할 수 있습니다.

명령어 속성

항목	설명
명령어 유형	드라이버 쿼리
필요 권한	관리자
라이선스 사용량	집계함
병렬 실행	미지원
분산 실행	미지원

문법

sonar-apps [keywords=STR]

옵션

[keywords=STR]: 앱 이름 또는 설명에서 검색할 키워드. 공백으로 구분해 여러 낱말을 지정하면 한 필드(이름 또는 설명) 안에 모든 낱말이 포함된 앱만 반환합니다. 검색에 쓰이는 이름·설명은 이 명령어가 내부적으로 사용하는 세션의 로케일(영어로 고정됨) 기준이므로, 실제로는 앱의 영어 이름·영어 설명과 대소문자 구분 없이 비교됩니다

출력 필드

필드	타입	설명
code	문자열	앱 코드
name	문자열	앱 이름
bundle_symbolic_name	문자열	OSGi 번들 심볼릭 이름
version	문자열	앱 버전
description	문자열	앱 설명
built_at	날짜	빌드 시각
installed_at	날짜	설치 시각
enabled	불리언	앱 활성화 여부

오류 코드

파싱 오류

오류 코드	메시지	설명
300181	앱 목록 조회는 관리자 권한이 필요합니다.	관리자 권한이 없는 계정으로 실행한 경우

런타임 오류

해당 사항 없음

설명

sonar-apps 명령어는 keywords 옵션을 지정하지 않으면 등록된 모든 앱을 반환합니다. keywords를 지정하면 공백으로 구분한 각 낱말이 앱 이름에 모두 포함되거나, 앱 설명에 모두 포함되는 앱을 반환합니다(이름과 설명 중 한쪽만 조건을 만족해도 포함됨).

이 비교는 세션 로케일에 따라 달라지는 다국어 이름·설명을 기준으로 하는데, 이 명령어가 만드는 세션은 로케일을 지정하지 않아 기본값인 영어로 처리됩니다. 반면 출력 필드 name은 앱의 기본 이름을 그대로 반환하므로, 앱에 한국어 기본 이름이 설정되어 있으면 화면에 보이는 이름과 keywords 검색에 실제로 쓰이는 영어 이름이 서로 다를 수 있습니다. 따라서 keywords에는 한국어보다 앱의 영어 이름·영어 설명에 포함된 낱말을 지정해야 안정적으로 일치합니다.

사용 예

전체 앱 목록 조회
```
sonar-apps
```
등록된 모든 앱의 코드, 이름, 버전, 활성화 여부 등을 반환합니다.
키워드로 앱 필터링
```
sonar-apps keywords="sample"
```
영어 이름 또는 설명에 sample이 포함된 앱만 반환합니다. keywords는 세션 로케일(영어 고정) 기준으로 비교되므로, 한국어 키워드를 지정하면 화면에 한국어 이름으로 표시되는 앱이라도 일치하지 않을 수 있습니다.
비활성화된 앱만 조회
```
sonar-apps
| search enabled == false
```
현재 비활성화 상태인 앱만 필터링합니다.

변경 이력

sonar-apps 명령어는 소나 4.0.2609.0 버전부터 사용 가능합니다.

이 명령어는 실험실(Lab) 앱이 제공하던 것을 소나 코어에 내장한 것입니다(SNR#3463). 내장되지 않은 버전에서는 실험실 앱을 설치해 사용할 수 있습니다.