evtctxsetvar()

이벤트 컨텍스트에 사용자 변수를 설정합니다. 변수 설정에 성공하면 true를, 실패하면 false를 반환합니다.

문법

매개변수

TOPIC

이벤트 컨텍스트의 토픽 이름. 문자열.

KEY

이벤트 컨텍스트의 키 값. 문자열.

VAR_NAME

설정할 변수 이름. 문자열.

VALUE

변수에 저장할 값.

HOST

(선택) 이벤트 컨텍스트가 속한 호스트 이름. 생략하면 기본 호스트에서 검색합니다.

설명

TOPIC과 KEY로 이벤트 컨텍스트를 식별한 뒤, VAR_NAME 이름으로 VALUE를 저장합니다. 성공하면 true(불리언)를 반환합니다.

TOPIC 또는 KEY가 null이면 false를 반환합니다. VAR_NAME이 null이면 false를 반환합니다. VALUE가 null이면 null 값으로 변수를 설정합니다.

설정한 변수는 evtctxgetvar() 함수로 조회할 수 있습니다.

오류 코드

사용 예

1. login_fail 토픽에서 사용자별 이벤트 컨텍스트에 last_ip 변수 설정

   evtctx topic=login_fail key=src_user
   | eval ok = evtctxsetvar("login_fail", src_user, "last_ip", src_ip)
   

2. 변수를 설정한 뒤 evtctxgetvar()로 다시 조회

   evtctx topic=login_fail key=src_user
   | eval ok      = evtctxsetvar("login_fail", src_user, "score", risk_score)
   | eval stored  = evtctxgetvar("login_fail", src_user, "score")
   

3. TOPIC이 null인 경우

   evtctx topic=login_fail key=src_user
   | eval ok = evtctxsetvar(null, src_user, "last_ip", src_ip)
   | # ok: false
   

호환성

evtctxsetvar() 함수는 소나 4.0 이전 버전부터 제공되었습니다.