sonar-logger-models
로그프레소 소나에 등록된 수집 모델 목록을 조회합니다. 수집 모델은 수집기 팩토리, 파서, 정규화 규칙(로그 스키마 추출기)을 묶어 정의한 수집 설정 템플릿입니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 관리자 |
| 라이선스 사용량 | 집계함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 수집 노드에서 실행 (mapper) |
문법
sonar-logger-models [keywords=STR]
옵션
keywords=STR- 수집 모델 이름 검색 키워드
입력 필드
없음 (드라이버 쿼리이므로 파이프라인에서 첫 번째 명령어로만 사용합니다)
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| guid | 문자열 | 수집 모델 GUID |
| name | 문자열 | 수집 모델 이름 |
| description | 문자열 | 수집 모델 설명 |
| logger_factory_name | 문자열 | 수집기 팩토리 식별자 |
| logger_factory_display_name | 문자열 | 수집기 팩토리 표시 이름 |
| parser_code | 문자열 | 파서 식별자 |
| parser_name | 문자열 | 파서 이름 |
| overlay | 불리언 | 오버레이 설정 여부. 모델 생성 시 지정하지 않으면 true |
| log_schemas | 배열 | 정규화 규칙(추출기)에 연결된 로그 스키마 코드 목록 |
| app_code | 문자열 | 앱 식별자 |
| app_built_in | 불리언 | 앱에 포함된 수집 모델 객체 여부 |
| rule_count | 32비트 정수 | 정규화 규칙 개수 |
| created | 날짜 | 생성 시각 |
| updated | 날짜 | 마지막 갱신 시각 |
정규화 규칙이 하나 이상 있는 수집 모델은 위 필드 외에 common_stream_query(문자열, 공통 스트림 쿼리)와 rules(배열, 정규화 규칙 상세 목록) 필드가 함께 반환됩니다.
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 300145 | 수집 모델 목록 조회는 관리자 권한이 필요합니다. | 관리자 권한이 없는 계정으로 실행한 경우 |
런타임 오류
해당 사항 없음
설명
sonar-logger-models 명령어는 최대 1,000건씩 페이지 단위로 조회하여 등록된 모든 수집 모델을 순차적으로 반환합니다. keywords 옵션을 지정하면 수집 모델 이름에서 검색합니다.
각 수집 모델은 정규화 규칙(추출기)을 다시 조회하여 log_schemas 필드를 구성합니다. rules 필드가 포함된 경우, 각 정규화 규칙 안에서 값이 null인 항목은 결과에 포함되지 않습니다(규칙 자체가 제거되는 것은 아닙니다).
사용 예
-
전체 수집 모델 목록 조회
sonar-logger-models -
이름으로 검색
sonar-logger-models keywords="apache"이름에
apache가 포함된 수집 모델만 반환합니다. -
앱에 포함된 수집 모델만 조회
sonar-logger-models | search app_built_in == true -
정규화 규칙 개수 기준으로 정렬
sonar-logger-models | sort -rule_count
변경 이력
sonar-logger-models 명령어는 소나 4.0.2609.0 버전부터 사용 가능합니다.
이 명령어는 실험실(Lab) 앱이 제공하던 것을 소나 코어에 내장한 것입니다(SNR#3463). 내장되지 않은 버전에서는 실험실 앱을 설치해 사용할 수 있습니다.