감사 로그
이 장에서 배우는 것 무엇이 기록되는지, 왜 하위 등급에서도 계속 쌓이는지, 그리고 왜 admin 만 보는지.
답할 수 있어야 합니다
배포 후 어느 날 이런 질문이 옵니다.
설정 → 감사 로그가 그 답이 사는 자리입니다.
무엇이 남나
| 열 | 뜻 |
|---|---|
| 시각 | 언제 |
| 종류 | retrieval(자료 조회) · tool_call(도구 호출) · export(내보내기) 등 |
| 구성원 | 누가 — 사람인지 서비스 호출인지도 구분합니다 |
| 질의 | 무엇을 물었나 |
| 문서 수 | 몇 건이 근거로 붙었나 |
가장 많이 인용된 문서 목록도 함께 나옵니다. 이건 감사보다 운영에 더 쓸모 있습니다 — 팀이 실제로 무엇에 기대어 일하는지가 보입니다.
기록은 등급과 무관하게 항상 돕니다
여기가 설계의 핵심입니다.
수집은 언제나 돕니다. 등급이 줄이는 것은 조회 기간뿐입니다.
| 등급 | 조회 가능 기간 |
|---|---|
| 무료 · Starter | 화면이 잠김 (기록은 쌓임) |
| Pro | 30일 |
| Business | 365일 |
기록 자체를 끄면 상위 등급으로 올렸을 때 올린 시점부터만 보입니다. 그러면 "작년 그 사고 때"에 답할 수 없고, 감사 로그를 두는 이유가 사라집니다. 그래서 잠긴 화면의 문구도 "기록이 없습니다"가 아니라 "상위 등급에서 볼 수 있습니다" 입니다.
admin 만 봅니다
감사 로그 자체가 유출 경로입니다. 질의 원문과 문서명이 그대로 담기기 때문입니다. 그래서 owner·admin 만 열 수 있습니다. 멤버에게는 메뉴가 아예 보이지 않습니다.
이건 보안 검토에서 자주 나오는 질문이기도 합니다 — "감사 기록을 누가 볼 수 있느냐"에 답이 있어야 합니다.
무엇에 쓰나
이것만으로는 부족합니다
감사 로그는 이 제품 안에서 일어난 일을 남깁니다. 에이전트 시스템 전체를 추적하려면 트리 형태의 실행 기록이 필요하고, 그건 별도의 주제입니다 — 감사 기록과 관측에서 다룹니다.
자주 하는 오해
"무료 등급인데 기록이 안 쌓이는 것 아닌가요?"
쌓입니다. 보이지 않을 뿐입니다. 나중에 등급을 올리면 그 기간의 기록이 드러납니다.
"개인정보가 감사 로그에 남는 것 아닌가요?"
질의 원문이 남으므로 남을 수 있습니다. 그래서 조회를 admin 으로 좁혔습니다. 질의 자체에 개인정보가 자주 들어가는 워크스페이스라면 마스킹을 함께 켜는 것이 맞습니다.
확인
1. 하위 등급에서도 기록이 쌓이는 이유는?
답
나중에 등급을 올렸을 때 과거가 보여야 하기 때문입니다. 기록을 끄면 올린 시점부터만 보이고, 그러면 지난 사고를 조사할 수 없습니다.
2. 감사 로그를 admin 만 보는 이유는?
답
질의 원문과 문서명이 그대로 담겨 그 자체가 유출 경로이기 때문입니다.
3. 가장 많이 인용된 문서 목록은 무엇에 씁니까?
답
팀이 실제로 무엇에 기대어 일하는지가 보입니다. 감사보다 운영·개선에 더 쓸모가 있습니다 — 그 문서가 낡으면 답 전체가 낡습니다.
로그만으로 지난주를 재구성해봅니다. 30분입니다 → 감사 로그로 하루를 재구성해보기