alertmsg

경보 코드를 기반으로 경보 템플릿을 조회하여, 지정한 로케일에 맞는 경보 이름, 분류, 설명, 메시지를 출력 필드에 할당합니다.

명령어 속성

항목	설명
명령어 유형	가공 쿼리
필요 권한	없음
라이선스 사용량	해당 없음
병렬 실행	미지원
분산 실행	수집 노드에서 실행 (mapper)

문법

alertmsg [locale=STR]

옵션

locale=STR: 경보 메시지를 변환할 로케일 코드 (예: ko, en, ja) (기본값: en)

입력 필드

필드	타입	필수 여부	설명
`code`	문자열	필수	경보 템플릿 코드
`level`	문자열	선택	경보 수준. `INFO`, `WARN`, `ERROR`, `FATAL` 중 하나
`module_name`	문자열	선택	경보를 발생시킨 모듈 이름
`params`	맵	선택	경보 메시지 템플릿에 치환할 매개변수 맵

출력 필드

필드	타입	설명
`name`	문자열	지정한 로케일에 해당하는 경보 템플릿 이름
`category`	문자열	지정한 로케일에 해당하는 경보 분류
`description`	문자열	지정한 로케일에 해당하는 경보 설명
`message`	문자열	매개변수가 치환된 경보 메시지

오류 코드

파싱 오류

해당 사항 없음

런타임 오류

해당 사항 없음

설명

alertmsg 명령어는 sys_alerts 시스템 테이블에 기록된 경보 데이터 또는 입력 필드(code, level, params 등)를 포함하는 쿼리 파이프라인에서 입력을 받을 수 있습니다.

alertmsg 명령어는 입력 레코드의 code 필드를 기준으로 경보 메시지 템플릿을 조회합니다. 템플릿이 존재하면 지정한 로케일에 맞는 name, category, description, message 필드를 레코드에 추가합니다. 경보 코드에 해당하는 템플릿이 없으면 해당 필드를 추가하지 않고 입력 레코드를 그대로 출력합니다.

message 필드는 경보 템플릿의 메시지 문자열에 params 맵의 값을 치환한 결과입니다.

locale 옵션을 지정하지 않으면 영문(en)으로 변환합니다. 지정한 로케일에 해당하는 번역이 없으면 영문 메시지로 대체합니다.

사용 예

경보 메시지를 한국어로 변환
```
table duration=1d sys_alerts
| alertmsg locale=ko
```
최근 1일간의 경보 레코드를 조회하여 한국어로 경보 이름, 분류, 설명, 메시지를 변환합니다.
경보 메시지를 영문(기본값)으로 변환
```
table duration=1d sys_alerts
| alertmsg
```
locale 옵션을 생략하면 영문으로 경보 메시지를 변환합니다.
특정 수준의 경보 메시지를 한국어로 변환
```
table duration=7d sys_alerts
| search level == "ERROR" or level == "FATAL"
| alertmsg locale=ko
```
최근 7일간의 경보 중 ERROR 또는 FATAL 수준의 레코드만 조회하여 한국어로 변환합니다.
json으로 입력 필드를 직접 구성
```
json "{'code': 'SNR-0001', 'level': 'ERROR', 'module_name': 'sonar', 'params': {'ip': '192.0.2.1'}}"
| alertmsg locale=ko
```
json 명령어로 입력 필드를 직접 구성하여 경보 메시지를 변환합니다.

호환성

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