설치 매뉴얼
개요
CAST AI 앱은 CAST AI의 감사 이벤트 API(GET /v2/audit/events)를 주기적으로 호출해 감사 로그를 수집하고, cast-ai-audit 로그 스키마로 정규화합니다. 같은 접속 프로파일로 확장 명령어 cast-ai-audit-events를 실행해 감사 이벤트를 직접 조회할 수 있습니다.
적용 범위
Note
소나 4.0.2502.0 이상에서 동작합니다.
CAST AI 설정
Note
CAST AI 콘솔에서 감사 로그 조회용 API 키를 발급합니다. 이 단계가 누락되면 로그프레소가 CAST AI와 통신할 수 없습니다.
단계 1: API 키 발급
- CAST AI 콘솔에 로그인합니다.
- API > API access keys 메뉴에서 새 키 생성을 클릭합니다.
- 키 이름을 입력하고 읽기 전용(Read-only) 권한을 선택한 뒤 키를 생성합니다.
- 생성 직후 표시되는 키 문자열을 안전한 곳에 보관합니다.
단계 2: 리전 확인
CAST AI 콘솔 리전에 따라 API 주소가 다릅니다. 사용 중인 리전을 확인합니다.
| 리전 | API 주소 |
|---|---|
| 기본 | https://api.cast.ai |
| EU | https://api.eu.cast.ai |
| India | https://api.india.cast.ai |
단계 3: 감사 로그 확인
CAST AI 콘솔에서 감사 이벤트가 기록되는 화면을 확인합니다. 수집 후 건수를 비교할 때 이 화면을 사용합니다.
- 콘솔 왼쪽 메뉴에서 클러스터를 선택하고 Logs를 클릭합니다.
- 화면 오른쪽 위의 기간 선택에서 조회할 기간을 지정합니다.
- 왼쪽 필터(Severity, Domain, Resource type, Action)로 이벤트를 좁히고, 목록에서 시각, 도메인, 리소스, 액션, 행위자, 요약을 확인합니다.
로그프레소 수집 설정
단계 1: 접속 프로파일 추가
시스템 > 접속 프로파일에서 추가를 클릭하고 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 접속 프로파일을 식별할 고유한 이름 |
| 필수 | 식별자 | 로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자 |
| 필수 | 유형 | CAST AI |
| 필수 | API 키 | CAST AI 설정에서 발급한 API 키 |
| 선택 | API 주소 | 기본값은 https://api.cast.ai 입니다. EU 또는 India 리전이면 위 표의 주소를 입력합니다 |
| 선택 | HTTP 프록시 | 프록시를 거치는 경우 IP:포트 |
| 선택 | 접속 타임아웃 | 초 단위, 범위 10~600, 기본값 30 |
| 선택 | 읽기 타임아웃 | 초 단위, 범위 10~600, 기본값 60 |
저장한 뒤 접속 테스트로 API 키와 연결을 확인합니다. TLS 검사를 하는 프록시 환경에서 접속 테스트가 실패하면 소나 서버의 JVM 신뢰 저장소에 프록시의 사설 CA 인증서를 등록하고 소나를 재시작해야 합니다.
단계 2: 수집기 추가
수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 수집기를 식별할 고유한 이름 |
| 필수 | 적재 위치/수집 위치 | 로그프레소 플랫폼 구성에 따라 적합한 노드 선택 |
| 필수 | 수집 모델 | CAST AI Audit Logs |
| 필수 | 접속 프로파일 | 단계 1에서 등록한 프로파일의 식별자 |
| 필수 | 주기 | 기본값 권장 |
| 필수 | 테이블 | cast_ai_audit 처럼 원하는 테이블 이름 입력 |
| 선택 | 모니터링 대상 일수 | 최초 수집 시 소급할 일수. 범위 1~90, 기본값 1 |
| 선택 | 수집 지연 (초) | 이벤트가 API에 노출되기까지의 지연을 고려해 수집을 늦추는 시간. 범위 0~3600, 기본값 2 |
Tip
CAST AI에서 이벤트가 API에 노출되기까지 걸리는 시간보다 수집 지연을 길게 설정해야 이벤트 누락이 줄어듭니다. 지연 이후에 노출된 이벤트는 수집기가 가져오지 못하므로, 확장 명령어 cast-ai-audit-events로 보충할 수 있습니다. 보충 방법은 사용 매뉴얼을 참고하십시오.
설치 후 검증
아래 쿼리로 수집이 실제로 동작하는지 최종 확인합니다. 테이블 이름은 수집기에 입력한 값으로, from과 to는 확인할 구간(yyyyMMddHHmmss)으로 바꿉니다.
table from=20261106170000 to=20261106180000 cast_ai_audit
| fields _time, event_domain, event_resource, event_action, description
| sort _time
조회된 목록을 CAST AI 설정의 단계 3에서 확인한 화면에서 같은 구간에 조회되는 이벤트 목록과 비교해 누락된 이벤트가 없는지 확인합니다.



