본문으로 건너뛰기

Audit

OpenSearch 기반 감사 로그를 검색하고 통계를 조회하는 API입니다. AuditMiddleware가 기록한 모든 API 요청 로그를 분석할 수 있습니다.

엔드포인트

GET /api/v1/audit/logs

설명: 감사 로그를 검색합니다. 다양한 필터 조건을 지원합니다.

쿼리 파라미터:

파라미터타입필수설명
userstringN사용자 필터
actionstringN액션 필터
start_datestringN시작 일시 (ISO 8601)
end_datestringN종료 일시 (ISO 8601)
pageintN페이지 번호
sizeintN페이지 크기

GET /api/v1/audit/stats

설명: 감사 로그 통계를 반환합니다. 기간별 요청 수, 사용자별 분포 등을 제공합니다.

GET /api/v1/audit/health

설명: OpenSearch 감사 로그 저장소의 연결 상태를 확인합니다.

인증

JWT Bearer 토큰이 필요합니다.

에러 코드

코드설명
400잘못된 날짜 형식 또는 필터 조건
500OpenSearch 연결 실패