sonar-dashboards

로그프레소 소나에 등록된 모든 대시보드 목록을 조회합니다. 각 대시보드의 GUID, 이름, 테마, 표시 옵션, 소유자, 공유 대상 등 속성을 함께 반환합니다.

명령어 속성

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

문법

sonar-dashboards

옵션

옵션 없음

출력 필드

필드	타입	설명
guid	문자열	대시보드 GUID
name	문자열	대시보드 이름
description	문자열	대시보드 설명
theme	문자열	대시보드 테마
is_titleless	불리언	제목 표시줄을 감추는지 여부
is_bezeless	불리언	테두리를 감추는지 여부
is_controless	불리언	컨트롤(조작 버튼)을 감추는지 여부
owner_guid	문자열	대시보드 소유자 GUID
owner_name	문자열	대시보드 소유자 이름
shared_users	배열	공유된 사용자 목록. 각 항목은 `guid`, `name`, `type`, `read_only`, `created` 필드를 가진 객체이며, `created`는 날짜 값이 아니라 `yyyy-MM-dd HH:mm:ssZ` 형식의 문자열입니다
shared_groups	배열	공유된 사용자 그룹 목록. 각 항목은 `guid`, `name`, `type`, `read_only`, `created` 필드를 가진 객체이며, `created`는 날짜 값이 아니라 `yyyy-MM-dd HH:mm:ssZ` 형식의 문자열입니다
app_code	문자열	대시보드가 속한 앱의 코드. 앱과 무관하게 직접 생성한 대시보드는 null입니다
created	날짜	생성일
updated	날짜	마지막 수정일

오류 코드

파싱 오류

오류 코드	메시지	설명
300170	대시보드 목록을 볼 권한이 없습니다	관리자 권한이 없는 계정으로 실행한 경우

런타임 오류

해당 사항 없음

설명

sonar-dashboards 명령어는 필터 없이 같은 회사(테넌트)에 속한 모든 대시보드를 조회 대상으로 삼습니다. 관리자 권한으로 실행하므로 소유자나 공유 여부와 관계없이 전체 대시보드가 반환되며, 특정 대시보드만 확인하려면 뒤에 search나 fields 명령어를 연결해 필터링해야 합니다.

shared_users, shared_groups 필드는 대시보드 공유 설정에 등록된 사용자·그룹 GUID와 이름을 포함하는 객체 배열입니다.

조회한 대시보드를 복제하려면 sonar-clone-dashboards 명령어를 사용하세요.

사용 예

전체 대시보드 목록 조회
```
sonar-dashboards
```
시스템에 등록된 모든 대시보드의 속성을 반환합니다.
이름과 소유자만 선택하여 최근 생성순으로 정렬
```
sonar-dashboards
| fields guid, name, owner_name, created
| sort -created
```
대시보드의 GUID, 이름, 소유자만 선택하고 최근에 생성된 순서로 정렬합니다.
특정 앱에 속한 대시보드만 조회
```
sonar-dashboards
| search app_code == "threat-intel"
```
app_code가 threat-intel인 앱에서 생성한 대시보드만 필터링합니다.

변경 이력

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

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