감사 로그
GenD는 AuditMiddleware를 통해 모든 API 요청을 JSON 형태의 감사 로그로 자동 기록합니다. 감사 로그는 OpenSearch에 저장되며, 검색 및 통계 분석이 가능합니다.
주요 기능
- 자동 감사 로깅: 모든 HTTP 요청의 메서드, 경로, 사용자, 응답 코드, 처리 시간을 자동 기록합니다
- OpenSearch 기반 검색: 기간, 사용자, 경로, 상태 코드 등 다양한 조건으로 감사 로그를 검색합니다
- 통계 분석: 일별/시간별 요청 수, 사용자별 활동량, 에러율 등 통계를 제공합니다
- 오남용 탐지: fire-and-forget 방식으로 비정상적인 요청 패턴을 실시간 탐지합니다 (세마포어 10 동시 제한)
- OpenSearch 상태 확인: 감사 로그 저장소의 헬스 상태를 모니터링합니다
감사 로그 항목
| 필드 | 설명 |
|---|---|
| timestamp | 요청 시각 |
| method | HTTP 메서드 |
| path | 요청 경로 |
| user | 인증된 사용자 ID |
| status_code | HTTP 응답 코드 |
| duration_ms | 요청 처리 시간 |
| ip_address | 클라이언트 IP |
사용 방법
- ⚙ 관리 콘솔 → 운영 & 모니터링 → 감사 로그 메뉴에서 감사 로그를 검색합니다
- 기간, 사용자, 경로, 상태 코드로 필터링합니다
- 통계 탭에서 활동 추이를 확인합니다
API 엔드포인트
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/audit/logs | 감사 로그 검색 |
| GET | /api/v1/audit/stats | 감사 통계 조회 |
| GET | /api/v1/audit/health | OpenSearch 헬스 확인 |
AI Agent Chat으로 수행하기
이 페이지의 작업을 AI에게 자연어로 요청할 수 있습니다. 페이지 상단의 AI에게 요청 버튼을 클릭하거나, AI 에이전트 채팅에서 직접 질문하세요.
예시:
- "최근 감사 로그 보여줘"
- "admin 사용자의 활동 이력 조회해줘"
자세한 내용은 AI Agent Chat 가이드를 참조하세요.