감사 개선 사항 출시

What's New

감사 로그는 언제나 누가 작업을 수행했는지와 무엇에 대해 수행했는지를 기록해 왔습니다. 이번 릴리스는 해당 기록을 페이지를 떠나지 않고도 읽고 검색할 수 있게 만드는 것입니다.

특정 중재자에게 무슨 일이 일어났는지 알고 싶다면 먼저 해당 중재자의 ID를 찾아야 했으며, 그 중재자가 이미 삭제된 경우 ID를 조회할 대상이 없었습니다. 이벤트는 무언가가 삭제되었고, 누가, 언제 삭제했는지를 표시했지만, 일부 경우에는 이름이 누락되었습니다.

이제 이벤트 발생 시 이름이 ID와 함께 기록되므로 삭제 후에도 남아 검색할 수 있습니다.

The Affected Column

테이블에 새로운 Affected 열이 추가되어 이벤트가 작용한 사람 또는 객체를 이름으로 표시합니다. 사람의 경우 jsmith (jsmith@example.com)와 같이 표시됩니다. 위젯 커스터마이징이나 중재 그룹의 경우 지정한 이름이 표시됩니다. 미디어 파일의 경우 업로드한 파일 이름이 표시됩니다.

테이블 위에는 Who or what was changed 라는 검색 상자가 있습니다. 이름, 이메일 주소 또는 ID를 입력하면 해당 사람이나 객체에 영향을 미친 이벤트를 찾습니다. 세 가지 중 어떤 것을 가지고 있는지 알 필요 없으며, 내부 ID를 먼저 조회할 필요도 없습니다.

이번 릴리스 이전에 기록된 이벤트에는 이름이 첨부되지 않았지만, 항상 있던 ID는 그대로 있으므로 동일한 검색 상자를 통해 ID로 찾을 수 있습니다.

Date Range

필터 행에 이제 Date Range 드롭다운이 추가되어 최근 30일, 최근 90일, 지난 연도, 전체 기간, 그리고 Custom range 를 선택할 수 있으며, 선택 시 시작일과 종료일 선택기가 표시됩니다.

날짜 범위는 검색을 좁히는 가장 쉬운 방법이며, 다른 필터와 함께 사용할 때 원하는 항목을 가장 빠르게 찾을 수 있습니다.

Managed Accounts

계정이 다른 테넌트를 관리하는 경우, Include sub-tenants 체크박스가 있습니다. 이를 선택하면 계정과 관리하는 모든 테넌트를 한 번에 검색하며, Tenant 열에 각 이벤트가 발생한 계정이 표시됩니다.

지금까지는 각 테넌트의 로그를 개별적으로만 읽을 수 있었기 때문에, "이번 주에 누가 우리 자산을 건드렸는가" 라는 질문에 답하려면 하나씩 전환해야 했습니다.

Updates Now Record What Changed

팀 멤버를 편집하면 결과적인 권한 집합만 기록되었습니다. 이는 현재 권한이 무엇인지 알려주지만 이전 권한은 알 수 없으므로, "누가 언제 이 사람의 결제 접근 권한을 제거했는가" 라는 질문에 답할 수 없었습니다.

업데이트 이벤트에는 실제로 변경된 필드만 포함하는 changes 맵이 추가되어 각 필드의 이전 값과 새로운 값이 기록됩니다. 변경되지 않은 필드는 제외되므로, 권한 변경은 여러 불리언 값 대신 한 줄로 표시됩니다.

Descriptions, and the Device Behind a Change

파괴적인 이벤트에는 이제 "Removed user from the account."와 같이 발생한 일을 설명하는 간단한 문장이 포함됩니다. 페이지 조회에는 설명이 있었지만 삭제에는 없었는데, 이는 역전된 상황이었습니다.

무언가를 변경하는 이벤트는 변경을 수행한 브라우저도 기록합니다. 세션은 해시 형태로 저장되어 한 사람의 행동을 연관시킬 수 있지만, 재생될 수 있는 정보를 로그에 저장하지는 않습니다.

Other Improvements

• 페이지네이션 및 필터 조합에 대한 몇 가지 수정 사항.
• 로그인 이벤트에서 Who 열이 비어 있었습니다. 사용자 이름은 기록에 있었지만 페이지가 읽지 못했습니다.
• 액션 열이 로그인 이벤트를 N/A로 표시했는데, 이는 액션 이름 목록에 Login이 없었기 때문입니다.
• 감사 로그 페이지에서 SSO 사용자를 이름으로 표시하지 못해 "Missing User"가 표시되었습니다. 이제 올바르게 해결됩니다.
• 긴 기록을 가진 계정에서 페이지 속도가 크게 향상되었습니다.

For the API

/api/v1/audit-logs 엔드포인트에 일치하는 필터가 추가되었습니다: 서브스트링 검색을 위한 username, ip, crudType, resourceName, targetId, target 및 includeManagedTenants. 응답에는 이제 targetId, targetLabel 및 ua가 포함됩니다.

이미 이 엔드포인트를 호출하고 있다면 주목할 두 가지 변경 사항이 있습니다. before는 이제 단독으로 동작하며, 이전에는 after와 함께 전달하지 않으면 무시되었습니다. 또한 limit은 이제 최대 10k로 제한되고 기본값은 5k입니다. 이전에는 제한이 없었습니다.

Documentation

AuditLogs API 가이드는 새로운 쿼리 매개변수를 다루며, AuditLog 구조 레퍼런스는 새로운 필드를 다룹니다.

감사 로그를 아직 사용해 보지 않았다면, 원본 릴리스 포스트에서 로그가 어디에 위치하고, 누가 읽을 수 있으며, 항목이 얼마나 오래 보관되는지 설명합니다. 이 모든 내용은 변경되지 않았습니다.

In Conclusion

FastComments를 지속적으로 개선할 수 있게 되어 기쁩니다. 로그에서 무언가를 찾으려 했지만 찾지 못한다면, 아래에 알려 주세요.

감사합니다!