cast-ai-audit-events
CAST AI 서버에서 감사 이벤트 목록을 조회합니다.
문법
cast-ai-audit-events [profile=STRING] [from=STRING] [to=STRING] [limit=INT]
옵션
- profile=STRING
- 선택 옵션. CAST AI 접속 프로파일 식별자. 여러 개는 쉼표로 구분합니다. 생략하면 모든 CAST AI 프로파일을 사용합니다.
- from=STRING
- 선택 옵션. yyyyMMddHHmmss 포맷으로 범위의 시작을 지정합니다. 뒷자리를 쓰지 않으면 0으로 채워집니다. 생략하면 끝 시각(to)의 24시간 전부터 조회합니다.
- to=STRING
- 선택 옵션. yyyyMMddHHmmss 포맷으로 범위의 끝을 지정합니다. 뒷자리를 쓰지 않으면 0으로 채워집니다. 생략하면 현재 시각입니다.
- limit=INT
- 선택 옵션. 프로파일별로 반환할 이벤트 최대 개수. 1~10000, 생략하면 1000.
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| profile | 문자열 | 접속 프로파일 | CAST AI 접속 프로파일 식별자 |
| event_id | 문자열 | 이벤트 ID | 이벤트 고유 식별자 |
| _time | 날짜 | 발생 시각 | 이벤트 발생 시각 |
| ingested_at | 날짜 | 인제스트 시각 | CAST AI가 이벤트를 수집한 시각 |
| event_domain | 문자열 | 이벤트 도메인 | 이벤트 도메인. 예: autoscaler |
| event_resource | 문자열 | 이벤트 리소스 | 이벤트 리소스. 예: cluster |
| event_action | 문자열 | 이벤트 액션 | 이벤트 액션. 예: paused |
| level | 문자열 | 심각도 | 이벤트 심각도. 예: info |
| actor_type | 문자열 | 행위자 유형 | 행위자 유형. 예: user, system |
| actor_email | 문자열 | 행위자 이메일 | 행위자 이메일 |
| resource_name | 문자열 | 대상 이름 | 이벤트 대상 이름 |
| cluster_id | 문자열 | 클러스터 ID | 이벤트가 발생한 클러스터 식별자 |
| description | 문자열 | 설명 | 이벤트 요약 |
위 표는 일부이며, profile을 제외한 모든 필드는 수집기가 저장하는 cast-ai-audit 로그 스키마와 같습니다.
오류 코드
파싱 오류
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| 사용 가능한 CAST AI 프로파일이 없습니다. | 등록된 CAST AI 접속 프로파일이 없음 | 시스템 > 접속 프로파일에서 프로파일을 등록합니다 |
| CAST AI 프로파일 이름을 입력하세요. | profile 옵션에 유효하지 않은 값을 지정함 | 등록된 접속 프로파일의 식별자를 입력합니다 |
| limit은 1 이상 10000 이하의 정수여야 합니다. | limit 값이 범위를 벗어나거나 숫자가 아님 | 1~10000 범위의 정수를 지정합니다 |
런타임 오류
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| CAST AI API error: HTTP 401 ... | API 키가 잘못되었거나 만료됨 | 접속 프로파일의 API 키를 확인하고 재발급합니다 |
| CAST AI API error: HTTP 403 ... | API 키 권한이 부족함 | 감사 로그 조회 권한이 있는 키를 사용합니다 |
| CAST AI request failed: GET ... | 네트워크 단절, 프록시, 인증서 검증 실패 | HTTPS/443 도달 여부와 프록시·사설 CA 설정을 확인합니다 |
설명
접속 프로파일에 저장된 API 키로 CAST AI 감사 이벤트 API를 호출해 지정한 구간의 이벤트를 발생 시각 오름차순으로 반환합니다. 구간은 시작 시각 이상, 끝 시각 미만입니다. 프로파일을 여러 개 지정하거나 생략하면 프로파일마다 순서대로 조회하며, limit은 프로파일별로 적용됩니다.
조회 결과는 수집기가 저장한 로그와 같은 필드명으로 반환됩니다(profile 제외). 따라서 수집 테이블에 쓰는 쿼리를 그대로 사용할 수 있습니다.
수집기가 놓친 이벤트를 보충하는 방법은 사용 매뉴얼의 수집에서 놓친 이벤트 보충 시나리오를 참고하십시오.