Dashboard 운영 현황: (2024-11-14 추가)
- 관리자가 운영 현황을 알 수 있도록 표시 해야 합니다.
- 표시되는 항목은 4가지이며 해당 항목에 대한 Count를 표시합니다.
1.변환 대기중 문서 2.변환중 문서 수 3.변환 완료 문서 수 4.변환 예외 문서 수
1번과 2번 카드는 실시간 데이터이며 레디스에서 추출합니다.
3번과 4번 카드는 증가하는 데이터이며 30초 내 데이터를 통합 로그에서 추출합니다.
또한 화면 갱신 시간도 30초입니다.
SHIELDRM Dashboard 문서 변환 현황 구성
현재 SHIELDRM Dashboard에 문서 변환 현황은 다음 4가지 항목으로 구성되어 있습니다.
- 변환 대기중 문서 수 : SHIELDRM 서비스에서 변환 대기중인 문서 수 입니다.
- 변환중 문서 수 : SHIELDRM 서비스에서 변환 진행중인 문서 수 입니다.
- 변환 완료 문서 수 : SHIELDRM 서비스에서 변환 완료된 문서 수 입니다.
- 변환 예외 : SHIELDRM 서비스에서 변환 예 외 처리된 문서 수 입니다. 변환 예외 항목에 대한 상세 정보는 아래 서술되어 있습니다.
'변환 예외' 로그 정보
변환 예외는'LOG_EVENT_RETRY_EXCEPTION_CASE'로그가 생성되었을 때 표시되는 항목입니다. 해당 로그는 두가지 케이스 일때 생성됩니다.
- 변환 미지원: 재시도가 불가능한 예외 케이스
- 재시도 미지원: 예외처리되어 더 이상 재시도되지 않는 케이스
참고: SHIELDRM에서 문서 변환 중 예외 발생 시, 재시도 큐에 현재 작업을 넣고 다음 재시도 시간에 문서 변환 작업을 시도합니다. 여기서 예외 발생 건중 중에 재시도 큐에 넣지 않는 작업은 'LOG_EVENT_RETRY_EXCEPTION_CASE' 로그에 전송하고 해당 작업을 종료합니다. 재시도 큐에 넣지 않는 경우는 재시도를 하더라도 문서 변환에 성공하지 않을 작업울 SHIELDRM 서비스가 판별하기 때문입니다.
備考
SHIELDRM Dashboard의 문서 변환 현황 중 '변환 예외' 항목에 표시되는 로그 상세 내역에 대한 설명입니다.
변환 예외 로그 상세 분류
1. 변환 미지원 케이스
1.Unsupported tenant-Documents from unsupported tenants
: Graph API로 sharepoint 에 업로드된 파일의 AIP 레이블을 획득할 때 타 테넌트의 민감도 레이블 문서인 경우 발생합니다.
2.Document encrypted with Microsoft double key encryption
: MS DKE(Double Key Encryption) 더블 키로 암호화된 문서인 경우 서비스에서 변환이 불가하여 발생합니다.
3.DS Encrypted document without sensitivity label from another tenant
: DS 문서 헤더 획득 시에 타 회사의 문서키로 암호화 되어 현재 회사의 문서키로 복호화가 불가능한 경우 발생합니다.
4.Sharepoint Site item not found
: 이벤트 발생 시점에는 문서가 존재했으나, 변환 시점에 문서가 없는 경우 발생합니다.
예) 문서 생성 직후 삭제하여 Sharepoint 사이트에서 해당 문서를 찾을 수 없을 경우
5.File size is 0 (Zero)
: Sharepoint에 업로드 된 파일 크기가 0인 경우로 암호화할 내용이 없어 발생합니다.
2. 재시도 미지원 케이스
1.Failed to CDF decrypt. No retry
: Container Linker로 DS 문서 암복호화를 요청하였으나 실패 한 경우 발생합니다.
예) 키 정보 오류, 파일 손상 등등
2.Documents that the MIP service cannot change
: MIP Service에서 문서 변환이 불가능한 상태일 때 발생합니다.
Container Linker로 MIP 변환을 요청하였으나 실패한 경우 입니다.
예1) 다른 방식으로 암호화 된 경우 - MS Office 암호 걸린 경우 등
예2) 파일 구조가 손상된 경우 - 엑셀로 만든 문서가 아닌 확장자만 xlxs 경우 등