keenauth logs tail로 로그 따라가기

keenauth logs tail은 tail -f처럼 작업하는 동안 환경의 로그(로그인, 세션, 토큰, MFA, 공격 방어)를 따라갑니다. 가장 최근 기록을 먼저 출력하되 오래된 순서로 보여 준 뒤, 고정된 간격으로 새 기록을 확인하고 나타나는 대로 출력합니다. 중지하려면 Ctrl-C를 누르십시오. 그러면 명령이 종료 코드 0으로 끝납니다.

이 명령은 keenauth logs list와 같은 기록을 읽으며 같은 권한(logs:read)이 필요합니다. API 키와 keenauth login 세션 모두에서 동작합니다.

사용법

keenauth logs tail --type authentication. --user usr_01j9z3k4m5n6p7q8r9s0t1v2w3

잘못된 필터나 간격을 지정하면 요청을 보내기 전에 종료 코드 2로 명령이 중단됩니다.

출력

• table: 기록마다 한 줄씩, 시간(UTC), 유형, 결과, 사용자, 조직, 로그 ID를 표시합니다. 값이 없으면 -로 표시합니다.
• json: 기록마다 JSON 객체 하나를 한 줄에 출력합니다(줄바꿈으로 구분된 JSON). keenauth logs get이 반환하는 객체와 같습니다. 표준 출력이 터미널이 아닐 때의 기본값이므로 예를 들어 jq로 파이프할 수 있습니다.
• yaml: 기록마다 ---로 시작하는 YAML 문서 하나를 출력합니다.

keenauth logs tail --type authentication.failed -o json | jq -r '.ip_country'

IP 주소, 사용자 에이전트, 식별자 힌트는 자격 증명에 로그 API에 설명된 권한이 있는 경우에만 표시됩니다.

따라가는 방식

로그 API는 가장 최근 기록을 먼저 반환하며 대기 매개변수가 없으므로 명령은 폴링 방식으로 동작합니다. 첫 페이지 이후의 각 확인에서는 이미 출력한 가장 최신 시간 이후(같은 시간 포함)의 기록을 요청하고, 이미 출력한 기록은 건너뛰므로 같은 기록이 두 번 표시되지 않습니다. 확인 한 번마다 결과 페이지를 따라가며 새 기록을 모두 가져오며, 확인당 최대 2,000개까지입니다. 플랜의 보존 기간보다 오래된 기록은 반환되지 않습니다.

종료 코드