Audit 로그
Audit 로그가 기록하는 활동과 필터·CSV 내보내기, 기록 끄기, 플랜별 보존 기간, 소유자·관리자 권한을 설명합니다.
Audit 로그는 멤버·API 키·프로젝트·도메인·결제처럼 보안에 영향을 주는 변경을 누가, 언제, 어디서 했는지 기록합니다. Workspace → 보안 메뉴에서 확인하며, 팀원이 늘어나거나 외부 협업자가 참여할 때, 그리고 보안 점검이나 사고 조사 때 변경 이력을 추적하는 데 사용합니다.
이 문서를 읽고 나면 어떤 활동이 기록되는지, 기록을 어떻게 찾고 내보내는지, 플랜에 따라 얼마나 오래 보존되는지 알 수 있습니다.
누가 볼 수 있나요
Audit 로그는 보안 메뉴 안에 있어 Workspace 소유자(OWNER)와 관리자(ADMIN)만 볼 수 있습니다.
Audit 로그는 Pro 요금제부터 제공됩니다. Free 플랜에서는 활동이 기록되지 않으며 보안 메뉴에 업그레이드 안내가 표시됩니다. 플랜을 올리면 그 시점부터 기록이 시작되고, 플랜에 따라 보존 기간이 달라집니다.
기록되는 활동
각 기록은 실행자(멤버 또는 시스템), 활동, 대상, IP 주소와 브라우저 정보, 활동별 세부 정보로 구성됩니다. 실행자의 이름과 이메일은 기록 시점 그대로 저장되므로 멤버가 이름을 바꾸거나 탈퇴해도 기록은 그대로 남습니다.
| 분류 | 기록되는 활동 |
|---|---|
| 워크스페이스 | 정보 수정, 삭제, Audit 로그 CSV 내보내기 |
| 멤버 | 초대, 기존 회원 추가, 초대 수락으로 참여, 역할 변경, 내보내기, 나가기 |
| 초대 | 초대 역할 변경, 초대 취소 |
| 프로젝트 | 생성, 설정 수정, 삭제 |
| 프로젝트 멤버 | 추가, 역할 변경, 내보내기, 나가기 |
| API 키 | 생성, 수정, 활성화, 비활성화, 삭제 |
| 도메인 | 커스텀 도메인 추가·삭제, 대표 도메인 변경 |
| 테마 | 테마 변경 |
| 구독 | 요금제 변경, 해지 예약, 해지 취소 |
| 결제 수단 | 추가, 기본 결제 수단 변경, 삭제 |
| 보안 정책 | IP 허용·차단 목록 변경, 허용 이메일 도메인 변경, Audit 로그 켜기·끄기 |
세부 정보에는 역할 변경의 이전·이후 역할, API 키의 종류와 접두어, 요금제 변경의 대상 플랜처럼 활동을 이해하는 데 필요한 값만 담깁니다. API 키 본문, 비밀번호, 카드 번호 같은 비밀 값은 기록되지 않습니다.
콘텐츠, 번역, 변수 등 데이터 자체의 편집 이력은 Audit 로그가 아니라 각 Project의 버전 이력에서 확인합니다. 공개 API 호출 내역은 사용량과 로그를 참고하세요.
Audit 로그 끄기
Audit 로그 카드 오른쪽 위의 Audit 로그 사용 스위치로 워크스페이스의 기록을 끄고 켤 수 있습니다. 소유자 또는 관리자 권한이 필요합니다.
- 끄면 새 활동은 기록되지 않습니다. 이미 기록된 활동은 보존 기간이 끝날 때까지 볼 수 있습니다.
- 끄는 순간은
Audit 로그 끄기로, 다시 켜는 순간은Audit 로그 켜기로 기록되어 공백 구간을 알 수 있습니다. - 다시 켜면 그 시점부터 기록됩니다. 꺼져 있던 동안의 활동은 복구되지 않습니다.
기록 찾기
목록은 최신 순으로 표시되며, 행을 클릭하면 액션 코드, 대상 ID, 브라우저 정보(User-Agent)와 세부 정보를 펼쳐 볼 수 있습니다.
| 필터 | 설명 |
|---|---|
| 기간 | 최근 1일, 1주, 30일, 90일 또는 날짜 직접 선택 |
| 분류 | 위 표의 분류 중 하나 |
| 실행자 | 현재 Workspace 멤버 중 한 명 |
필터는 주소에 함께 저장되므로 보고 있는 화면의 링크를 그대로 공유할 수 있습니다. 더 오래된 기록은 더 보기로 이어서 불러옵니다.
CSV 내보내기
CSV 내보내기를 누르면 현재 필터에 해당하는 기록을 최신 순으로 최대 5,000행까지 내려받습니다. 파일에는 시간(UTC), 액션 코드, 실행자, 대상, 프로젝트, IP, 브라우저 정보, 세부 정보(JSON)가 포함됩니다.
- 내보내기 자체도
워크스페이스 → Audit 로그 내보내기활동으로 기록됩니다. - 수식으로 해석될 수 있는 셀은 스프레드시트에서 안전하게 열리도록 처리됩니다.
보존 기간
플랜별 보존 기간이 지난 기록은 매일 새벽(KST)에 자동으로 삭제됩니다. 보안 메뉴 상단에서 현재 플랜의 보존 기간을 확인할 수 있습니다.
| 플랜 | 보존 기간 |
|---|---|
| Free | 제공 안 함 |
| Pro | 7일 |
| Pro+ | 30일 |
| Ultra | 1년 |
| Enterprise | 무제한 |
- 조회와 내보내기는 보존 기간 안의 기록만 대상으로 합니다. 날짜를 직접 선택해도 보존 시작 시점 이전은 조회되지 않습니다.
- 플랜을 올리면 그 시점부터 더 오래 보존됩니다. 이미 삭제된 기록은 복구되지 않으므로, 장기 보관이 필요하면 주기적으로 CSV로 내보내 두세요.
- 플랜을 내리면 다음 정리 시점에 새 보존 기간을 넘긴 기록이 삭제됩니다. Free로 내리면 기록이 중단되고 남은 기록도 삭제됩니다.
권장 사용법
- 주기적으로 확인: 멤버 역할 변경, Secret API 키 생성, 결제 수단 변경은 특히 눈여겨보세요.
- 외부 협업 종료 시: 협업자가 나간 뒤 해당 멤버를 실행자로 필터해 남긴 변경을 점검합니다.
- 장기 보관: 규정상 1년 이상 보관해야 한다면 월별로 CSV를 내보내 사내 저장소에 보관합니다.
다음 단계
- 보안 — API 키 상태, IP 허용·차단 목록, 허용 이메일 도메인을 확인합니다.
- Workspace와 멤버 — 역할별 권한과 멤버 관리를 확인합니다.
- REST API 인증 — Publishable·Secret 키의 차이와 Origin 제한을 확인합니다.
- 요금제와 한도 — 플랜별 Audit 로그 제공 여부와 보존 기간을 비교합니다.