감사 로그의 작동 방식
로깅은 기본적으로 꺼져 있으며 회사별로 따로 유지됩니다. 켜면 Alforse는 이후 감사 대상 엔터티에 발생하는 모든 변경을 기록합니다. 켜기 전이나 꺼져 있는 동안의 변경은 절대 기록되지 않습니다. 항목은 변경된 데이터베이스 행이 아니라 사용자가 다루는 업무 엔터티별로 그룹화됩니다. 예를 들어 품목의 원가를 편집하면 내부itemCost 행이 아니라 품목 항목이 생성됩니다.
항목의 구성
차이에서는
updatedAt, updatedBy, 내부 임베딩 같은 관리용 필드가 제외되므로, 항목에는 사람이 관심을 가질 변경만 표시됩니다.
감사 대상 엔터티
아래 엔터티만 감사됩니다. 그 외의 변경은 로깅이 켜져 있든 아니든 기록되지 않습니다.로깅 켜기와 끄기
설정 → 감사 로그의 감사 로깅 카드에는 토글이 하나 있습니다. 토글을 끄면 새 항목은 중단되지만 기존 이력은 유지됩니다. 다시 켜면 그 시점부터 기록이 재개되며, 꺼져 있던 동안의 공백은 비어 있는 채로 남습니다.변경 검토
같은 데이터를 두 가지 범위로 볼 수 있습니다.레코드 하나의 이력
고객, 수주, 작업, 출하 같은 대부분의 상세 페이지에서 이력 작업을 선택하면 해당 레코드의 타임라인이 서랍으로 열립니다. 각 변경에는 작업, 행위자, 시간, 변경된 필드의 펼칠 수 있는 목록이 표시됩니다. 로깅이 꺼져 있으면 서랍에 “Audit logging is not enabled”(감사 로깅이 활성화되지 않았습니다)라고 표시됩니다. 설정을 갱신할 수 있는 사용자에게는 활성화 바로가기가 제공되며, 그 외 사용자에게는 관리자에게 문의하라는 안내가 표시됩니다.회사 전체 로그
설정 → 감사 로그에서 모두 보기를 선택하면 전체 화면의 모든 감사 로그 표가 열립니다. 검색과 페이지 매김이 가능하며 엔터티, 작업, 변경자, 변경 사항, 시점 열이 있습니다.
작업은 색이 있는 배지로 표시됩니다. 생성됨은 녹색, 갱신됨은 파란색, 삭제됨은 빨간색입니다. 행을 펼치면 필드 단위 차이를 볼 수 있고, 엔터티 값을 선택하면 해당 레코드가 열립니다.
보존과 아카이브
실시간 로그에는 30일 분량의 항목이 유지됩니다. 매일 밤 작업이 오래된 항목을 압축 아카이브로 옮기고, 아카이브의 날짜 범위, 행 수, 크기를 기록한 뒤 실시간 테이블에서 해당 항목을 삭제합니다. 아카이브는 설정 페이지의 아카이브된 로그에 나열됩니다. 다운로드는 압축된 내보내기 파일에 대한 단기 서명 링크를 만들므로, 링크를 저장하지 말고 필요할 때마다 새 링크를 요청하십시오. 첫 아카이브가 생기기 전에는 30일이 지난 로그가 이곳에 보관될 것이라고 카드에 안내됩니다.권한과 플랜
설정 모듈이 직원 유형에 매핑되는 방식은 권한 및 액세스를 참조하십시오.
문제 해결
”Upgrade to Business to enable audit logging”(감사 로깅을 활성화하려면 Business로 업그레이드하십시오)
원인: 회사가 Business 플랜이 아니므로 설정 → 감사 로그의 토글이 차단되었습니다. 해결 방법: 플랜을 업그레이드한 다음 로깅을 켜십시오.”Upgrade to unlock audit history”(감사 이력을 사용하려면 업그레이드하십시오)
원인: 같은 플랜 제한이 레코드의 이력 서랍에 표시된 것입니다. 해결 방법: Business 플랜으로 업그레이드하십시오. 이 제한은 설정 토글과 서랍 모두에 적용됩니다.”Audit logging is not enabled”(감사 로깅이 활성화되지 않았습니다)
원인: 이력 서랍이 열렸지만 회사의 로깅이 꺼져 있습니다. 해결 방법: 설정 갱신 권한이 있는 사용자가 설정 → 감사 로그에서 켭니다. 해당 권한이 없으면 관리자에게 요청하십시오.”Failed to enable audit logging” 또는 “Failed to disable audit logging”(감사 로깅을 활성화하지 못했습니다 / 비활성화하지 못했습니다)
원인: 회사의 로그 저장소와 변경 구독을 만들거나 제거하는 동안 서버 오류가 발생했습니다. 해결 방법: 다시 시도하십시오. 계속 실패하면 로그 테이블이나 구독이 어긋났을 수 있으며, 토글을 한 번 더 전환하면 다시 동기화됩니다.”Failed to generate download URL”(다운로드 URL을 생성하지 못했습니다)
원인: 아카이브의 저장된 파일이 없거나 서명 요청이 실패하여 Alforse가 서명 링크를 만들지 못했습니다. 해결 방법: 다시 시도하십시오. 링크는 금방 만료되므로 오래된 링크는 작동하지 않습니다.레코드에 이력이 표시되지 않습니다
세 가지를 확인하십시오. 변경이 발생했을 때 로깅이 켜져 있어야 합니다. Alforse는 소급해서 채우지 않기 때문입니다. 레코드의 엔터티가 감사 대상 엔터티에 나타나야 합니다. 그리고 관리용 필드(updatedAt, updatedBy, 임베딩)만 건드린 변경은 필드 단위 차이를 표시하지 않습니다.