メインコンテンツまでスキップ

Dashboard Card : 운영 현황 (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'로그가 생성되었을 때 표시되는 항목입니다. 해당 로그는 두가지 케이스 일때 생성됩니다.

  1. 변환 미지원: 재시도가 불가능한 예외 케이스
  2. 재시도 미지원: 예외처리되어 더 이상 재시도되지 않는 케이스

참고: 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 경우 등