DirectCloud Gateway의 동기화 로그를 확인하는 방법
개요
DirectCloud Gateway는 기존 NAS나 파일 서버와 DirectCloud를 실시간으로 동기화하여, 동일한 폴더 구성으로 운용할 수 있는 하이브리드 스토리지 서비스입니다. 사내에서는 NAS를 통해 기존과 같은 조작감을 유지하면서, 사외 이용자나 거래처는 DirectCloud 쪽에서 안전하게 접근할 수 있습니다. 이 매뉴얼에서는 DirectCloud Gateway의 '동기화 로그' 메뉴에서 동기화 이력을 확인하는 방법을 설명합니다. 또한 로그 필터링과 CSV 파일 다운로드, 진단 로그 다운로드도 설명합니다.
제한·보충사항
이 매뉴얼의 순서는 조직의 NAS 관리자를 대상으로 합니다.
이 매뉴얼의 순서를 실행하려면, DirectCloud Gateway를 설치하는 방법의 순서에 따라 DirectCloud Gateway를 설치하고 로그인까지 완료해야 합니다.
'동기화 로그' 메뉴와 '대시보드' 메뉴는 첫 동기화 사이클이 정상적으로 끝난 뒤에 선택할 수 있습니다. 그전까지는 '설정' 메뉴만 선택할 수 있습니다.
동기화 로그는 NAS의 DirectCloud Gateway에만 보관되며, DirectCloud 쪽에는 별도로 저장되지 않습니다.
DirectCloud Gateway의 동기화 로그 보존 기간은 30일로 고정되어 있습니다. 30일이 지난 로그는 자동으로 삭제됩니다. 보존 기간은 이용자나 회사 단위로 변경할 수 없습니다. 30일을 넘겨 동기화 로그를 보관해야 한다면, 'CSV 다운로드'로 정기적으로 내려받아 별도로 보관합니다. 자동 삭제된 로그는 복원할 수 없습니다.
파일 작업 이력은 DirectCloud 관리자 페이지의 '로그' > '파일 작업 내역 (FU)' 메뉴에서 확인합니다. 이 메뉴에 기록되는 것은 동기화 로그와는 별개의 정보입니다.
이 매뉴얼은 2026년 9월 29일 업데이트로 릴리스된 DirectCloud Gateway(Beta)의 개발 버전을 이용해 작성했습니다. 이 매뉴얼에서 사용하는 화면명이나 동작이 실제와 다를 수 있습니다.
절차
동기화 로그 보기
[상태 확인하기]
화면 왼쪽 메뉴에서 '동기화 로그'를 선택합니다.
동기화 이벤트가 시간순으로 표시됩니다.
각 열의 의미는 다음과 같습니다.
시각
이벤트가 기록된 일시가 최신순으로 위에서부터 표시됩니다.
카테고리
이벤트 내용을 분류한 배지가 표시됩니다. 자세한 내용은 뒤에 나오는 '카테고리'를 참조합니다.
배지는 로그 레벨(OK, INFO, WARN, ERR)에 따라 색이 구분됩니다.
방향
동기화와 관련된 카테고리일 때 다음 중 하나의 동기화 방향이 표시됩니다.
NAS→DirectCloud
DirectCloud→NAS
메시지
이벤트의 상세 내용이 표시됩니다. 대상 파일 경로나 오류 내용이 포함됩니다.
[카테고리]
이벤트는 다음 카테고리로 분류됩니다.
동기화 시작
INFO
동기화 사이클 #{cycle} 시작
폴더 스캔 완료(폴더: {folders}건)
초기 동기화이므로 NAS→DirectCloud 동기화만 실행합니다(DirectCloud→NAS는 다음 회차부터)
동기화 완료
OK／INFO
동기화 완료(업로드: {uploaded}, 스킵: {skipped}, 오류: {errors}, 소요: {elapsed})
DirectCloud→NAS(다운로드: {downloaded}, 스킵: {skipped}, 오류: {errors}, 전체: {total})
충돌 처리
WARN
충돌 감지: {path} — last-write-wins 정책으로 처리되었습니다
주기 스킵
WARN
사이클 미완료: 다음 예약 실행을 스킵
동기화가 일시정지됨 — 사이클을 실행하지 않습니다
DirectCloud 관리자 페이지에서 동기화가 비활성으로 설정되어 있어 사이클을 실행하지 않습니다(서버 확인)
인증 갱신
INFO／WARN／ERR
DirectCloud 토큰 갱신 실패: 비밀번호로 다시 로그인을 시도합니다({error})
DirectCloud 로그인에 실패했습니다: {error}
연결 오류
ERR
NAS 연결에 실패했습니다: {error}
폴더 스캔에 실패했습니다: {error}
DirectCloud→NAS 동기화에 실패했습니다: {error}
스킵
WARN
권한이 없어 스킵: {path}
동기화 오류
ERR
DirectCloud 폴더 생성/확인에 실패했습니다: {path}(이하 생략)
업로드 실패: {path} — 전송중에 연결이 끊겼습니다. 다음 동기화에서 다시 시도합니다.
업로드 실패: {path} — 서버 응답을 해석할 수 없습니다.(이하 생략)
동기화 로그 작업
[동기화 로그 필터링하기]
화면 상단의 '필터'에서 표시할 이벤트에 체크합니다.
전체
전체 로그를 표시합니다.
동기화
동기화 로그만 표시합니다.
충돌
충돌 처리에 관한 로그만 표시합니다.
오류
오류 로그만 표시합니다.
주기 스킵
스킵에 관한 로그만 표시합니다.
인증
인증 갱신에 관한 로그만 표시합니다.
정보
동기화 보류, 일시정지·중지, DirectCloud→NAS 동기화 결과 요약 등 참고용 로그만 표시합니다.
[동기화 로그를 CSV로 다운로드하기]
DirectCloud Gateway의 동기화 로그 보존 기간은 30일로 고정되어 있습니다. 감사 등으로 장기간 보관이 필요하면, CSV로 내려받아 별도로 보관합니다.
'CSV 다운로드' 버튼을 클릭합니다. 표시된 로그가 CSV 파일로 다운로드됩니다.
[진단 로그 다운로드하기]
애플리케이션 오류가 발생하면, 진단 로그를 내려받아 지원팀에 보냅니다. 개발 부문이 원인을 가려내는 데 사용합니다.
'CSV 다운로드' 버튼 왼쪽에 있는 '진단 로그 다운로드' 버튼을 클릭합니다. 진단 로그가 다운로드됩니다.
출력된 JSON의 synced_files에 포함된 ID별 정보는 다음과 같습니다.
ID
레코드의 내부 ID
CreatedAt
레코드가 DB에 등록된 날
UpdatedAt
레코드가 마지막으로 갱신된 일시
DeletedAt
논리 삭제된 일시(null = 삭제되지 않음)
LocalPath
로컬의 파일 경로(동기화 대상 폴더 기준 상대 경로)
RemoteFileID
DirectCloud의 파일 ID
RemoteNode
파일이 존재하는 DirectCloud의 노드(폴더) ID
Reginfo
업로드 시 등록 정보(타임스탬프 기반의 관리용 문자열)
Hash
파일 내용의 해시값(동기화 정합성 확인에 사용)
Size
파일 크기(바이트)
LastModified
파일의 최종 수정일시(로컬 또는 리모트 메타데이터)
SyncedAt
가장 최근에 동기화가 완료된 일시
Status
동기화 상태
예: synced＝동기화 완료
LastSeenCycle
이 파일이 마지막으로 확인된 동기화 사이클 번호
HashCheckedCycle
해시 검증이 마지막으로 이루어진 동기화 사이클 번호
Last updated