감사 로그
KIOPS에서 시스템 감사 로그를 조회하고 분석하는 방법을 안내합니다.
감사 로그가 왜 필요한가요?
감사 로그는 시스템에서 발생한 활동의 기록입니다. 내가 볼 수 있는 범위는 역할에 따라 다릅니다 — 기관 관리자는 기관 전체, 팀 관리자는 자기 팀과 본인, 멤버는 본인의 기록만 조회합니다(화면에도 안내가 표시됩니다). 보안 감사, 문제 해결, 규정 준수에 필수적입니다. 감사 로그가 없으면 다음을 놓칩니다.
- 보안 침해 발생: 로그가 없으면 누가 무엇을 했는지 알 수 없지만, 있으면 침입 경로와 영향 범위를 파악할 수 있습니다.
- 장애 원인 분석: 로그가 없으면 추측에 의존해야 하지만, 있으면 정확한 변경 이력을 추적할 수 있습니다.
- 규정 감사: 로그가 없으면 증빙 자료가 없지만, 있으면 모든 활동 기록으로 감사를 통과할 수 있습니다.
- 권한 오용 탐지: 로그가 없으면 발견이 불가능하지만, 있으면 비정상적인 활동 패턴을 탐지할 수 있습니다.
많은 보안 규정(ISO 27001, SOC 2, GDPR 등)이 감사 로그 유지를 요구하므로, 적절한 로그 보관 정책은 규정 준수의 핵심입니다.
감사 로그 카테고리
KIOPS는 시스템 전반의 활동을 16가지 카테고리로 분류하여 기록합니다:
| 카테고리 | 코드 | 주요 기록 대상 |
|---|---|---|
| 장비 | device | 장비 등록/수정/삭제 |
| 인프라 | infra | 런타임 환경 등록, 설정 변경 |
| 서비스 | service | 빌드, 배포, 롤백, 서비스 설정 변경 |
| 인증 | auth | 로그인/로그아웃, 비밀번호 변경, 인증 성공/실패 |
| 백업 | backup | 백업 생성, 복구 실행 |
| 데이터베이스 | database | DB 연결 등록/수정, 동기화 작업 |
| 사용자 | user | 역할 변경, 계정 변경 |
| 기관 | organization | 기관 설정 변경, 멤버십 처리 |
| 감사 | audit | 감사 로그 관련 동작(설정 변경 등) |
| VPN | vpn | VPN 프로파일 등록/수정/삭제, 연결 이력 |
| 시크릿 | secret | 시크릿/토큰 등록/수정/삭제 |
| 도메인 | domain | 도메인 등록/수정/삭제 |
| 모니터링 | monitoring | 모니터링 확장 설치/설정 변경 |
| 시스템 | system | 시스템 설정 변경, 점검성 작업 |
| 웹훅 | webhook | 웹훅 등록/수신/이벤트 처리 |
| DB 백업 | db_backup | 데이터베이스 백업/복원 작업 |
실무 팁 — 보안 감사를 시작할 때는 auth 카테고리로 비정상 로그인 시도를 먼저 확인하고, 이어서 service / infra / backup 카테고리로 주요 변경 이력을 점검하면 효과적입니다.
감사 로그 조회하기
시스템에서 발생한 활동 기록을 확인하는 방법입니다.
필요 권한: audit 권한
Step 1: 감사 로그 페이지 이동
좌측 메뉴에서 [감사 로그]를 클릭합니다.
Step 2: 기본 로그 목록 확인
감사 로그 테이블에서 최근 로그 목록을 확인합니다. 각 로그에는 다음 정보가 표시됩니다:
- 시간: 이벤트가 발생한 시간
- 수행자: 작업을 수행한 사용자
- 유형: 카테고리 (예: auth, service, infra, backup 등 16가지)
- 작업: 수행한 작업 (예: create, update, delete)
- 대상: 작업 대상 리소스
- 결과: done(성공) / failed(실패) / pending(대기) / processing(진행중)
Step 3: 로그 상세 보기
로그 항목을 클릭하면 상세 정보를 확인할 수 있습니다:
- 요청 IP 주소
- 요청 상세 내용 (요청 파라미터)
- 변경 전/후 데이터 비교
- 실패 시 에러 메시지
- 요청 식별자(
request_id) 등 추적 정보
로그 필터링하기
특정 조건의 로그만 조회하는 방법입니다.
Step 1: 필터 영역 사용
화면 상단의 필터 영역에서 기간(일간/주간/월간), 날짜 범위, 유형, 작업자, Request ID, 결과 등의 조건을 입력한 뒤 조회 버튼을 클릭합니다. (필터 필드는 항상 표시되어 있으며 별도의 '필터' 버튼이나 펼침 패널은 없습니다.) 멤버는 본인 기록만 조회하므로 작업자 조건이 표시되지 않으며, 유형 목록도 자기 기록에 있는 유형만 나타납니다.
Step 2: 기간 필터 설정
조회 기간을 선택합니다:
- 일간: 오늘 발생한 로그만 표시합니다.
- 주간: 최근 7일간의 로그를 표시합니다.
- 월간: 최근 1개월간의 로그를 표시합니다.
- (날짜 범위 선택기): 시작일과 종료일을 직접 입력합니다.
Step 3: 유형 필터 설정
이벤트 카테고리를 선택합니다. KIOPS는 16가지 카테고리를 제공하며 여러 개를 함께 고를 수 있습니다. 카테고리는 device, infra, service, auth, backup, database, user, organization, audit, vpn, secret, domain, monitoring, system, webhook, db_backup 입니다.
Step 4: 사용자 필터 설정
특정 사용자의 활동만 보려면 사용자를 선택합니다.
Step 5: 결과 필터 설정
결과 상태를 선택합니다. 결과 값은 done(성공) / failed(실패) / pending(대기) / processing(진행중)이며, 비동기 작업은 pending → processing → done/failed 순으로 진행됩니다.
- 전체: 모든 결과를 표시합니다.
- 성공: 성공(done)한 작업만 표시합니다.
- 실패: 실패(failed)한 작업만 표시합니다.
- 작업 종류에 따라 대기(pending) / 진행중(processing) 상태의 로그도 존재할 수 있습니다.
Step 6: 필터 적용
조회 버튼을 클릭합니다. 필터 조건에 맞는 로그만 표시됩니다.
로그 검색하기
특정 키워드로 로그를 검색하는 방법입니다.
Step 1: 필터 필드 사용
감사 로그는 단일 통합 검색창이 아니라 항목별로 분리된 필터를 제공합니다:
- 작업자: 사용자 이름 또는 이메일로 검색 (입력 디바운스 적용, 자동 갱신)
- Request ID: 추적용 식별자(UUID) 부분 일치 검색 (Discord 에러 알림 링크로 들어오면 자동으로 채워집니다)
- 기간(일간/주간/월간 및 날짜 범위), 유형, 결과 드롭다운 필터
- 기업명 필터(플랫폼 관리자 전용)
리소스 이름, IP 주소, 동작 설명을 대상으로 하는 자유 텍스트 검색은 지원되지 않습니다.
Step 2: 검색 결과 활용
목록에서 항목을 클릭하면 상세 정보가 열립니다. 다른 화면(알림, 서비스 상세 등)의 딥링크를 통해 감사 로그로 진입할 경우, 해당 로그 항목이 자동으로 선택/스크롤되어 표시됩니다.
로그 내보내기
감사 로그를 파일로 내보내는 방법입니다.
Step 1: 내보내기 모달 열기
내보내기 버튼을 클릭합니다. 내보내기는 항상 현재 필터(검색) 결과 전체를 대상으로 하며, 모달 상단에 "현재 검색된 총 N건의 데이터를 다운로드합니다"라고 대상 건수가 표시됩니다. 체크박스로 일부 항목만 선택해 내보내거나 필터와 무관한 전체 로그를 내보내는 옵션은 제공되지 않으므로, 내보낼 범위는 먼저 필터/검색으로 좁혀 두세요.
Step 2: 내보내기 형식 선택
형식을 선택합니다. 현재 감사 로그 내보내기는 두 가지 형식만 지원합니다:
- xlsx (기본): 스프레드시트에서 바로 열어 분석할 수 있습니다.
- CSV: 다른 도구로 후처리하거나 대량 데이터 처리에 적합합니다.
Step 3: 내보내기 실행
내보내기 버튼을 클릭합니다. 파일이 다운로드됩니다.
보안 이벤트 모니터링
의심스러운 활동을 모니터링하는 방법입니다.
Step 1: 보안 이벤트 필터 적용
다음 조건으로 필터링합니다:
- 유형: 인증
- 결과: 실패
Step 2: 로그인 실패 패턴 확인
다음 패턴에 주의하세요:
- 동일 IP에서 다수 실패: 무차별 대입 공격 가능성이 있습니다.
- 동일 계정으로 다수 실패: 계정 탈취 시도 가능성이 있습니다.
- 비정상 시간대 접근: 권한 없는 접근 가능성이 있습니다.
Step 3: 권한 변경 이력 확인
유형 필터를 사용자(user)와 기관(organization)으로 변경해 역할 변경·멤버십 처리 이력에 비정상적인 것이 있는지 확인합니다. 「권한」이라는 유형은 없습니다.
감사 로그 페이지 자체에는 임계치 기반 자동 알림 설정 기능이 없습니다. "5분 내 로그인 실패 N회" 같은 실시간 룰 기반 경보가 필요하면 감사 로그를 외부 SIEM/로그 분석 도구에 연동하여 운용하는 것을 권장합니다.
로그 보관 정책
KIOPS는 감사 로그를 자동으로 삭제하지 않습니다. 예전에는 오래된 기록을 매일 자동으로 지웠지만, 지금은 그 기능이 없습니다. 기록된 로그는 계속 남습니다. 카테고리별로 보관 기간이 다르게 적용되는 동작도 없습니다.
개인정보보호법·정보통신망법 등 관련 법령에 따라 특정 로그는 법정 보관 기간을 준수해야 하므로, 아카이브·파기 정책은 조직의 보안/법무팀과 상의해 별도로 세우세요. 장기 보관이나 외부 제출이 필요하면 내보내기를 사용합니다.
자주 묻는 질문
특정 사용자의 활동만 보고 싶습니다
다음 방법 중 하나를 사용하세요:
- 사용자 필터: 필터 영역의 '작업자' 입력란에서 원하는 사용자를 지정합니다.
- 검색: [감사 로그] 페이지의 '작업자' 입력란에 사용자 이름 또는 이메일을 입력하여 검색합니다. (별도의
user:접두사 구문은 없으며, 입력한 값이 이름 또는 이메일과 일치하는 항목을 조회합니다.) - 결과 정렬: 우측 상단 정렬 드롭다운에서 최신순/오래된순을 선택하여 시간 기준으로 정렬합니다. (작업자 등 컬럼 헤더 클릭 정렬은 지원하지 않습니다.)
로그가 너무 많아 찾기 어렵습니다
효율적으로 좁히는 순서는 다음과 같습니다.
- 기간 좁히기 — 문제가 발생한 시간대로 범위를 제한합니다.
- 유형 선택 — 관련 있는 이벤트 유형만 남깁니다.
- 결과 필터 — 실패한 작업만 봅니다.
고급 검색 구문(action:·resource:·user: 같은 key:value 조합)은 지원되지 않습니다. 대신 '작업자' 필드에 이메일을 입력하고 '유형'에서 카테고리를, '결과'에서 상태를 선택하여 조합하세요.
오래된 로그가 보이지 않습니다
KIOPS가 자동으로 지우지는 않으므로, 먼저 기간 필터를 넓혀 보세요. 그래도 없다면 내 역할이 볼 수 있는 범위 밖일 수 있습니다 — 멤버는 본인 기록만 조회합니다.
로그 내보내기가 안 됩니다
원인 및 해결 방법:
- 권한 부족:
audit권한이 있는지 확인하세요. - 데이터 크기 초과: 기간을 나누어 여러 번 내보내세요.
- 브라우저 문제: 다른 브라우저로 시도하거나 팝업 차단을 해제하세요.