sonar-address-groups
로그프레소 소나에 등록된 주소 그룹 목록을 조회합니다. keywords 옵션으로 이름 또는 설명을 기준으로 검색할 수 있습니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 관리자 |
| 라이선스 사용량 | 집계함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
sonar-address-groups [keywords=STR]
옵션
keywords=STR- 이름 또는 설명에 포함된 키워드로 검색합니다. 공백으로 여러 단어를 구분하면 모든 단어가 포함된 주소 그룹만 반환합니다.
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
guid | 문자열 | 주소 그룹 GUID(36자) |
name | 문자열 | 주소 그룹 이름 |
description | 문자열 | 주소 그룹 설명 |
count | 64비트 정수 | 그룹 내 주소 개수 |
version | 64비트 정수 | 버전 번호 |
created | 문자열 | 생성 시각. yyyy-MM-dd HH:mm:ssZ 형식의 문자열로 반환됨(날짜 타입 아님) |
updated | 문자열 | 마지막 갱신 시각. yyyy-MM-dd HH:mm:ssZ 형식의 문자열로 반환됨(날짜 타입 아님) |
share | 불리언 | 공유 설정 여부. 열 순서 정의에 없는 조건부 필드로, 공유로 설정된 그룹에만 나타나며 결과 표에서는 다른 열 뒤에 표시됨(공유로 설정되지 않은 그룹은 이 필드 자체가 없음) |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 300173 | 주소 그룹 목록 조회는 관리자 권한이 필요합니다. | 관리자 권한이 없는 세션에서 실행한 경우 |
런타임 오류
해당 사항 없음
설명
sonar-address-groups는 로그프레소 소나에 등록된 주소 그룹(구 IP 블랙리스트) 목록을 조회하는 관리자 전용 명령어입니다. 관리자 권한이 없는 세션에서 실행하면 파싱 단계에서 오류가 발생하며 쿼리가 실행되지 않습니다.
내부적으로 1,000건씩 페이지 단위로 조회하여 전체 주소 그룹을 순차적으로 반환합니다. 조회한 guid는 sonar-address-objects 명령어의 group 옵션에 지정하여 그룹에 속한 개별 주소 객체를 조회하거나, sonar-add-address-batch·sonar-remove-address-batch 명령어의 guid 옵션에 지정하여 주소를 일괄 추가·삭제하는 데 사용할 수 있습니다.
사용 예
-
등록된 모든 주소 그룹 조회
sonar-address-groups -
이름 또는 설명에 특정 키워드가 포함된 주소 그룹 검색
sonar-address-groups keywords="차단" | fields guid, name, count, updated -
주소가 100개 이상 등록된 그룹만 필터링
sonar-address-groups | search count >= 100 | sort -count
변경 이력
sonar-address-groups 명령어는 소나 4.0.2609.0 버전부터 사용 가능합니다.
이 명령어는 실험실(Lab) 앱이 제공하던 것을 소나 코어에 내장한 것입니다(SNR#3463). 내장되지 않은 버전에서는 실험실 앱을 설치해 사용할 수 있습니다.