감사 로그

실행 가능한 사용자: 회사 관리자
사용 가능 플랜: Enterprise 플랜
사용 가능 환경: 브라우저

감사 로그는 관련 권한이 있는 조직 관리자에게 Miro 조직 내 사용자 활동을 추적할 수 있게 해줍니다. 로그는 문제 조사나 글로벌 보안 설정 변경, 신규 사용자 초대, 새 보드 생성 등 중요한 이벤트에 대한 상세 보고를 작성할 때 매우 유용합니다.

✏️ 현재 이벤트는 Enterprise 구독이 생성된 시점부터 기록되며 기본적으로 180일 동안 보관됩니다:
a) 다른 플랜에서 Enterprise로 업그레이드하면 업그레이드된 시점부터 이벤트가 기록됩니다.
b) 일부 팀을 Enterprise 구독으로 이전하면 해당 팀의 데이터는 구독에 속하게 되는 시점부터 기록됩니다.

감사 로그에 액세스하기

감사 로그에 액세스하려면 다음을 수행하세요:

1. Go to 회사 설정.
2. On the left panel, click 보안 > 감사 로그.
3. You can filter the audit logs by choosing a 날짜 범위, one or more 행위자 (including apps and AI agents acting on behalf of a user), one or more 이벤트 카테고리, one or more specific 이벤트, and one or more 영향 대상.

Click the View events button to preview the events matching your filtering criteria. Time is displayed in ISO 8601 format, in the 로컬 time zone. You can see details of a particular event by clicking on three dots in the 세부 정보 column.

✏️ 조직의 감사 로그 보유 기간(최대 365일)까지 이벤트를 미리 볼 수 있습니다.

감사 로그 내보내기

로그를 CSV 파일 형식으로 내보낼 수 있습니다.

CSV 내보내기 파일에서는 이벤트 날짜와 시간이 ISO 8601 형식의 UTC 표준시로 제공됩니다. 한 번에 내보낼 레코드 수에는 제한이 없지만, 데이터가 많을수록 파일 준비 시간이 길어집니다. 또한 테이블 작업용으로 널리 사용되는 애플리케이션은 열 수 있는 데이터 양에 한계가 있으니 유의하세요. 내보낸 파일에는 영향받은 객체를 포함해 적용한 모든 필터가 반영됩니다.

로그를 내보내려면 CSV로 내보내기 버튼을 클릭하세요.

내보내기 파일 세부 정보가 표시된 바가 아래에 나타납니다. 파일이 다운로드할 준비가 되면 CSV 다운로드 버튼을 클릭할 수 있습니다. 파일은 24시간 동안 다운로드할 수 있습니다.

✏️ 현재 조직에서는 한 번에 하나의 내보내기 파일만 다운로드할 수 있습니다. CSV로 내보내기 버튼을 클릭하면 현재 내보내기 파일이 교체됩니다.

API를 통해 감사 로그에 접근

관리자는 Audit Log API 또는 지원되는 SIEM Integrations을 사용해 감사 로그 데이터를 프로그래밍 방식으로 액세스하고 수집할 수 있습니다.

API는 UI와 동일한 필터(행위자, 이벤트 카테고리, 이벤트, 영향 대상)를 지원하며, 각 필터는 여러 값을 허용합니다. API를 통해 조직의 전체 감사 로그 기록을 가져올 수 있습니다.

Audit Logs API v1 사용 중단

Audit Logs API v1 has been retired. If you have a custom integration built on v1 (GET /v1/audit/logs), migrate it to v2 (GET /v2/audit/logs). Authentication and the time-window parameters are unchanged, but pagination, response format, and some field names differ, see the API reference for details. If you use a Miro-provided app or marketplace connector (for example, the Miro app for Splunk or Microsoft Sentinel), update it to the latest version, which already supports v2.

Notable changes in the v2 response:

• 페이징은 오프셋 기반이 아닌 불투명한 커서 값을 사용하는 커서 기반이며, 총 레코드 수는 제공되지 않습니다.
• createdBy.id는 문자열로 반환됩니다(이전에는 숫자였습니다).
• 각 이벤트에는 최상위 category 필드가 포함됩니다.
• 이벤트 ID는 UUID 문자열입니다(이전에는 숫자 접미사 사용). 불투명한 값으로 취급하세요.
• createdAt은 작업이 발생한 정확한 시점이 아니라 이벤트가 저장된 시점을 반영합니다(일반적으로 몇 초 정도의 지연이 있습니다).
• details 필드는 camelCase(예: organizationId)를 사용합니다. 큰 숫자 값은 문자열로 직렬화되며, 타임스탬프는 ISO 8601을 사용하고 null 값인 키는 생략됩니다.
• 앱, 통합 또는 AI 에이전트가 사용자를 대신해 수행한 작업의 경우 actor 객체에 해당 사용자를 식별하는 onBehalfOf 필드가 포함됩니다.
• 로그아웃된 방문자의 액터 이름이 이제 "Visitor"(이전에는 "Guest")로 변경되었습니다.
• 보드 관련 이벤트에는 내부 숫자 ID 대신 보드의 공개 boardKey가 참조됩니다.
• 이전에 'project'를 참조하던 이벤트 유형과 범주는 이제 '스페이스'를 사용합니다(예: project_created는 이제 space_created). 이 변경은 v2를 통해 조회한 과거 이벤트에도 소급 적용됩니다.

감사 로그 삭제

관리자는 감사 로그의 보유 정책을 설정할 수 있습니다. 30일, 90일, 180일 또는 365일 중에서 선택할 수 있습니다.

⚠️ 감사 로그를 삭제하면 복구할 수 없습니다.

✏️ 감사 로그의 무기한 보유는 더 이상 사용되지 않습니다.

삭제 기간을 설정하려면 다음 단계를 따르세요:

1. 회사 설정으로 이동하세요.
2. 왼쪽 패널에서 보안 > 감사 로그를 클릭하세요.
3. 감사 로그에서 설정 탭을 클릭하세요.
4. 드롭다운 목록에서 옵션을 선택하세요. 선택을 확인하라는 메시지가 표시됩니다.

감사 로그의 이벤트

감사 로그에는 다음 이벤트 카테고리에 대한 기록이 포함됩니다:

자주 묻는 질문