sonar-format-log

소나 운영 로그 메시지를 지정한 언어로 변환합니다. 운영 로그 레코드의 msg 필드를 사람이 읽을 수 있는 형식의 메시지로 변환하여 출력합니다.

명령어 속성

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

문법

... | sonar-format-log [locale=STR]

옵션

locale=STR
메시지 변환에 사용할 언어. 지정하지 않으면 영문으로 변환합니다. (기본값: en)
  • en: 영문
  • ko: 한국어

출력 필드

입력 레코드의 모든 필드를 그대로 출력하며, msg 필드를 사람이 읽을 수 있는 형식의 메시지로 변환합니다.

오류 코드

파싱 오류

해당 사항 없음

런타임 오류

해당 사항 없음

설명

sonar-format-log 명령어는 소나 운영 로그 레코드의 내용을 바탕으로 msg 필드를 사람이 읽을 수 있는 메시지 문자열로 변환합니다. 소나 운영 로그는 코드와 파라미터로 구성되어 있으며, 이 명령어는 코드에 해당하는 메시지 템플릿을 조회하고 파라미터를 대입하여 최종 메시지를 생성합니다.

locale 옵션으로 언어를 지정할 수 있으며, 지정하지 않으면 영문 메시지로 변환합니다.

사용 예

  1. 운영 로그 메시지를 한국어로 변환

    table duration=1h sonar_system_logs
| sonar-format-log locale=ko

    최근 1시간 동안의 소나 운영 로그를 조회하여 msg 필드를 한국어 메시지로 변환합니다.

  2. 운영 로그 메시지를 영문으로 변환

    table duration=1d sonar_system_logs
| sonar-format-log

    최근 1일 동안의 소나 운영 로그를 조회하여 msg 필드를 영문 메시지로 변환합니다.

호환성

sonar-format-log 명령어는 소나 4.0.2404.0 버전부터 제공되었습니다.