evtctxgetvar()

이벤트 컨텍스트에 저장된 사용자 변수의 값을 반환합니다. evtctxsetvar() 함수로 설정한 변수를 조회하는 데 사용합니다.

문법

매개변수

TOPIC

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

KEY

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

VAR_NAME

조회할 변수 이름. 문자열.

HOST

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

설명

TOPIC과 KEY로 이벤트 컨텍스트를 식별한 뒤, VAR_NAME에 해당하는 변수 값을 반환합니다.

TOPIC 또는 KEY가 null이면 null을 반환합니다. 지정한 이벤트 컨텍스트가 존재하지 않으면 null을 반환합니다. VAR_NAME이 null이거나 해당 이름의 변수가 존재하지 않으면 null을 반환합니다.

오류 코드

사용 예

1. web_session 토픽에서 세션 키에 해당하는 이벤트 컨텍스트의 client_ip 변수 조회

   evtctx topic=web_session key=session_id
   | eval ip = evtctxgetvar("web_session", session_id, "client_ip")
   

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

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

3. 존재하지 않는 변수를 조회하는 경우

   evtctx topic=login_fail key=src_user
   | eval v = evtctxgetvar("login_fail", src_user, "no_such_var")
   | # v: null
   

호환성

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