keenauth events tail로 이벤트 따라가기

keenauth events tail은 환경의 이벤트 API를 읽고, 고객 이벤트가 발생할 때마다 예를 들어 user.created처럼 하나씩 출력합니다. 이 이벤트는 웹훅 전송과 같은 이벤트이며, 봉투(envelope) 형식과 id도 동일합니다. 통합 시스템이 받을 내용을 확인하거나, 특정 작업이 기대한 이벤트를 발생시켰는지 점검할 때 사용하세요. 중지하려면 Ctrl-C를 누르세요. 그러면 명령이 종료 코드 0으로 끝납니다.

이 명령에는 events:read 권한이 필요합니다. API 키와 keenauth login 세션 모두로 사용할 수 있습니다.

사용법

keenauth events tail --types user.created,user.updated
플래그 설명
--types 이 이벤트 유형만 출력합니다. 쉼표로 구분하거나 여러 번 지정할 수 있습니다.
--org 이 조직(org_…)의 이벤트만 출력합니다.
--payload thin(기본값) 또는 full입니다. full은 리소스를 포함하며 users:read 권한도 필요합니다.
--after 시작 위치입니다. latest(기본값)는 지금부터 발생하는 이벤트만 출력하고, 이전 실행에서 출력된 커서를 지정하면 그 지점부터 이어서 출력합니다.
--interval 새 이벤트가 없을 때 확인하는 간격으로, 1s부터 60s까지 설정할 수 있습니다. 기본값: 5s.
--output, -o table, json 또는 yaml입니다. 플래그를 생략하면 터미널에서는 표를, 그 밖의 경우에는 JSON을 출력합니다.

잘못된 필터, 커서 또는 간격이 지정되면 어떤 요청도 보내기 전에 명령이 종료 코드 2로 끝납니다.

출력

이벤트는 환경의 이벤트 순서(seq)대로 출력됩니다. 명령을 중지하면, 이어서 실행할 때 사용할 커서를 stderr에 출력합니다:

to continue from here: --after <cursor>

나중에 keenauth events tail --after <cursor>를 실행하면 그 사이에 놓친 이벤트를 출력할 수 있습니다. 이벤트는 30일 동안 보관됩니다.

따라가는 방식

명령은 자신의 커서 이후의 이벤트를 요청하고, 이벤트를 출력한 뒤 응답이 반환한 값으로 커서를 옮깁니다. 응답에서 대기 중인 이벤트가 더 있다고 알려 주면 즉시 다시 요청합니다. 그렇지 않으면 --interval만큼 기다린 후 다시 요청합니다.

종료 코드

코드 의미
0 Ctrl-C로 중지했습니다.
1 서버 오류 또는 네트워크 오류가 발생했습니다(예: 다른 환경의 커서를 사용한 경우).
2 사용법 오류입니다. 필터, 커서, 간격 또는 출력 형식이 잘못되었습니다. 요청은 전송되지 않았습니다.
3 자격 증명이 없거나 서버가 401 또는 403으로 응답했습니다.
4 요금제에 해당 기능이 포함되어 있지 않습니다(plan_feature_unavailable과 함께 403).