evtctxlist

메모리 저장소에 보관된 이벤트 컨텍스트 목록을 조회합니다. 토픽으로 필터링할 수 있습니다.

명령어 속성

항목	설명
명령어 유형	드라이버 쿼리
필요 권한	없음
라이선스 사용량	집계 안 함
병렬 실행	미지원
분산 실행	미지원

문법

evtctxlist [topic=STR]

옵션

topic=STR: 조회할 이벤트 컨텍스트의 토픽 이름. 지정하면 해당 토픽의 이벤트 컨텍스트만 조회합니다. 미지정 시 모든 이벤트 컨텍스트를 조회합니다.

출력 필드

필드	타입	설명
`topic`	문자열	이벤트 토픽 이름
`key`	문자열	이벤트 컨텍스트 키
`host`	문자열	외부 시계 호스트 이름. 설정되지 않은 경우 null
`counter`	32비트 정수	이벤트 컨텍스트에 매칭된 이벤트 누적 횟수
`created`	날짜	이벤트 컨텍스트 생성 시각
`expire_at`	날짜	만료 예정 시각. 만료 시간이 설정되지 않은 경우 null
`timeout_at`	날짜	타임아웃 예정 시각. 타임아웃이 설정되지 않은 경우 null
`maxrows`	32비트 정수	이벤트 컨텍스트에 저장할 수 있는 최대 행 수
`vars`	맵	이벤트 컨텍스트에 설정된 변수 목록
`rows`	배열	이벤트 컨텍스트에 저장된 행 목록

오류 코드

파싱 오류

해당 사항 없음

런타임 오류

해당 사항 없음

설명

evtctxlist 명령어는 메모리 저장소에 보관된 이벤트 컨텍스트를 조회하여 각 이벤트 컨텍스트의 토픽, 키, 카운터, 생성 시각, 만료 및 타임아웃 정보, 변수, 저장된 행을 출력합니다. evtctxadd 명령어로 생성된 이벤트 컨텍스트의 상태를 확인하는 용도로 사용합니다.

이벤트 컨텍스트를 5,000건 단위로 배치 조회하여 출력합니다.

사용 예

모든 이벤트 컨텍스트 조회
```
evtctxlist
```
메모리 저장소에 보관된 모든 이벤트 컨텍스트를 조회합니다.
특정 토픽의 이벤트 컨텍스트 조회
```
evtctxlist topic=error_access
```
error_access 토픽의 이벤트 컨텍스트만 조회합니다.
토픽별 이벤트 컨텍스트 수 집계
```
evtctxlist
| stats count by topic
```
토픽별 이벤트 컨텍스트 수를 집계합니다.

호환성

evtctxlist 명령어는 소나 4.0 이전 버전부터 제공되었습니다.