Predefined Values
사전 정의값은 알림 메시지 내용에 치환되어 들어갈 값을 미리 정의해놓은 것이에요. 사전 정의값을 사용하면, 메시지 내용에 기입한 각 사전 정의값이 알림 발송을 발송할 때 치환되어 발송돼요.
사전 정의값은 다음과 같은 상황에서 입력할 수 있어요.
- 커스텀 수신자 유형 생성 > 사용자 정의 필드 추가하기 > 바디 필드 입력 시, 필드 타입이 String인 필드에서 필드의 값(value)
- 알림 룰 생성 > Step5: 수신자 설정 및 메시지 입력 시
사전 정의값은 메시지의 상세 내용에 중괄호 두개 쌍( {{...}} )이 포함된 키워드로 입력할 수 있어요. 메시지 내용에 중괄호 두개를 입력 시, 편리하게 입력할 수 있는 사전 정의값 입력폼이 보여져서 원하는 사전 정의값을 화살표 키로 선택하여 입력할 수 있어요.
사전 정의값 입력 시, 파라미터 설정
특정 사전 정의값은 파라미터 값을 설정해야해요. 파라미터가 필요한 사전 정의값의 경우, 사전 정의값 입력폼에서 선택하면 다음과 같은 파라미터 설정 모달이 노출됩니다.
사전 정의값을 직접 타이핑으로 {{rand_num}} 과 같이 입력할 수도 있지만, 이 경우 파라미터를 지정하기 까다로울 수 있기 때문에, 가급적 앞서 언급한 사전 정의값 입력폼을 사용하여 입력하는 것을 권장해요.
사전 정의값 목록
사용자 정의 필드 입력 폼 > [VALUE 입력 안내] 버튼을 누르면 사용 가능한 사전 정의값의 목록 모달이 노출돼요. 모달의 내용은 아래와 같으니 참고해주세요.
사전 정의값은 두 가지 유형으로 나뉘어요.
- 기본: 알림 룰에 부여한 메트릭과 관계없이 공용으로 사용되는 사전 정의값
- 메트릭: 알림 룰에 부여한 메트릭이 발생한 조건에 대한 사전 정의 값. (단, 매트릭에서 제공하지 않는 매트릭 사전 정의값을 사용할 경우, 알림 발송 시 해당 값은 N/A로 치환)
기본 사전 정의값
| 구분 | 설명 | 파라미터 포함 유/무 | 파라미터 |
|---|---|---|---|
| {{sender_ip}} | 최초 요청을 보내는 시스템의 IP | X | |
| {{sender_ip_pad}} | 최초 요청을 보내는 시스템의 IP, 옥텟 단위마다 3자리에 맞춰 패딩 문자열 추가 | X | |
| {{sender_ip_pad_no_dot}} | 최초 요청을 보내는 시스템 의 IP, 옥텟 단위마다 3자리에 맞춰 패딩 문자열 추가, 옥텟 구분자(.) 제거 | X | |
| {{rand_num}} | 무작위 번호 생성. 기본값은 1-100 사이의 숫자 생성 | O | - range: 랜덤 생성할 숫자의 범위이며, min, max 순서대로 입력하세요. (기본값: 1-100) - paddingLetter: 랜덤 생성한 숫자 앞 또는 뒤에 패딩 문자를 넣을 수 있어요. (기본값: 빈문자열('')) - digitLength: 숫자와 패딩을 포함해 총 몇자리 수로 생성할 것인지 입력하세요. (기본값: range의 최대값 자리수) - paddingLocation: 패딩을 랜덤 생성한 숫자의 앞(left)에 넣을 것인지, 뒤(right)에 넣을 것인지 선택하세요. (기본값: left) |
| {{rand_str}} | 무작위 문자열 생성. 기본값은 16자리 알파벳 대소문자(upper+lower)를 이용한 문자열 생성 | O | - strLength: 랜덤 생성할 문자열의 길이에요. (기본값: 16) - stringType: 랜덤 생성할 문자열에 포함되는 문자의 타입을 지정할 수 있어요. 'upper' / 'lower' / 'num' / 'sp' 를 +로 조합하여 입력하세요. (기본값: upper+lower) |
| {{date}} | 현재 날짜 생성 | O | - format: 날짜를 표현할 형식을 지정할 수 있어요. (기본값: yyyyMMdd) - timeZone: 어느 지역의 날짜을 출력할지 지정할 수 있어요. (기본값: 시스템 타임존) |
| {{time}} | 현재 시간 생성 | O | - format: 시간을 표현할 형식을 지정할 수 있어요. (기본값: HHmmss) - timeZone: 어느 지역의 시간을 출력할지 지정할 수 있어요. (기 본값: 시스템 타임존) |
| {{datetime}} | 현재 날짜/시간 생성 | O | - format: 날짜/시간을 표현할 형식을 지정할 수 있어요. (기본값: yyyyMMddHHmmss) - timeZone: 어느 지역의 날짜/시간을 출력할지 지정할 수 있어요. (기본값: 시스템 타임존) |
| {{timestamp}} | Timestamp 생성 | X | |
| {{null}} | null 처리 | X | |
| {{empty}} | 빈 문자열('') | X | |
| {{blank}} | 띄어 쓰기 문자열(white space) | X | |
| {{unknown}} | 알 수 없는 문자열 | X |
매트릭 사전 정의값
| 구분 | 설명 | 파라미터 포함 유/무 | 파라미터 |
|---|---|---|---|
| {{title}} | 발송 메시지 제목 | X | |
| {{content}} | 발송 메시지 내용 | X | |
| {{trigger_value}} | 알람 룰에서 설정한 트리거 값 | X | |
| {{component}} | 컴포넌트 유형 | X | |
| {{component_metric}} | 메트릭 명 | X | |
| {{kafka_cluster}} | '브로커 디스크 불균형'에서 트리거된 클러스터 | X | |
| {{cluster}} | 트리거된 클러스터 | X | |
| {{brokerId}} | 브로커 ID | X | |
| {{kafka_job}} | '브로커 디스크 불균형'에서의 역할 | X | |
| {{job}} | 역할 | X | |
| {{partition}} | 파티션 | X | |
| {{topic}} | 토픽 명 | X | |
| {{consumer_group}} | 컨슈머 그룹명 | X | |
| {{quantile}} | 분위수 | X | |
| {{request}} | 요청 메소드 | X | |
| {{zookeeper}} | 주키퍼 IP | X | |
| {{schemaRegistry}} | 스키마 레지스트리 IP | X | |
| {{connect}} | 커넥트 IP | X | |
| {{connector}} | 커넥터 | X | |
| {{status}} | 커넥터 상태 | X | |
| {{task}} | 커넥터 태스크 | X | |
| {{value}} | 알람 발생 값 | X | |
| {{starts_at}} | 트리거 시작 시간 | O | - format: 날짜/시간을 표현할 형식을 지정할 수 있어요. (기본값: yyyyMMddHHmmss) |
| {{ends_at}} | 트리거 종료 시간 | O | - format: 날짜/시간을 표현할 형식을 지정할 수 있어요. (기본값: yyyyMMddHHmmss) |