Cast AI

다운로드 0
업데이트 2026. 11. 16.

설치 매뉴얼

개요

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 키 발급

  1. CAST AI 콘솔에 로그인합니다.
  2. API > API access keys 메뉴에서 새 키 생성을 클릭합니다.
  3. 키 이름을 입력하고 읽기 전용(Read-only) 권한을 선택한 뒤 키를 생성합니다.
  4. 생성 직후 표시되는 키 문자열을 안전한 곳에 보관합니다.

API 키 발급

API 키 발급

단계 2: 리전 확인

CAST AI 콘솔 리전에 따라 API 주소가 다릅니다. 사용 중인 리전을 확인합니다.

리전API 주소
기본https://api.cast.ai
EUhttps://api.eu.cast.ai
Indiahttps://api.india.cast.ai

단계 3: 감사 로그 확인

CAST AI 콘솔에서 감사 이벤트가 기록되는 화면을 확인합니다. 수집 후 건수를 비교할 때 이 화면을 사용합니다.

  1. 콘솔 왼쪽 메뉴에서 클러스터를 선택하고 Logs를 클릭합니다.
  2. 화면 오른쪽 위의 기간 선택에서 조회할 기간을 지정합니다.
  3. 왼쪽 필터(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에서 확인한 화면에서 같은 구간에 조회되는 이벤트 목록과 비교해 누락된 이벤트가 없는지 확인합니다.

참고 자료