evtctxcnt()

지정된 토픽에 현재 존재하는 이벤트 컨텍스트의 수를 반환합니다. evtctx 명령어로 생성된 이벤트 컨텍스트의 개수를 파악하는 데 사용합니다.

문법

매개변수

TOPIC

이벤트 컨텍스트 수를 조회할 토픽 이름. 문자열. null을 지정하면 전체 토픽의 이벤트 컨텍스트 수를 반환합니다.

설명

TOPIC에 해당하는 이벤트 컨텍스트의 수를 32비트 정수로 반환합니다.

TOPIC이 null이면 모든 토픽에 걸쳐 존재하는 이벤트 컨텍스트 수의 합을 반환합니다.

해당 토픽에 이벤트 컨텍스트가 하나도 없으면 0을 반환합니다.

오류 코드

사용 예

1. login_fail 토픽에 현재 존재하는 이벤트 컨텍스트 수 조회

   evtctx topic=login_fail key=src_user max_count=5
   | eval ctx_count = evtctxcnt("login_fail")
   

2. 토픽 인수로 null을 전달하여 전체 이벤트 컨텍스트 수 조회

   evtctx topic=login_fail key=src_user
   | eval total = evtctxcnt(null)
   

3. 이벤트 컨텍스트가 존재하지 않는 토픽을 조회하는 경우

   evtctx topic=login_fail key=src_user
   | eval cnt = evtctxcnt("no_such_topic")
   | # cnt: 0
   

호환성

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