> For the complete documentation index, see [llms.txt](https://help.directcloud.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.directcloud.net/admin_manual/dc-gateway/directcloud-gateway-2.md).

# DirectCloud Gateway의 동기화 로그를 확인하는 방법

### 개요 <a href="#a03" id="a03"></a>

DirectCloud Gateway는 기존 NAS나 파일 서버와 DirectCloud를 실시간으로 동기화하여, 동일한 폴더 구성으로 운용할 수 있는 하이브리드 스토리지 서비스입니다. 사내에서는 NAS를 통해 기존과 같은 조작감을 유지하면서, 사외 이용자나 거래처는 DirectCloud 쪽에서 안전하게 접근할 수 있습니다.\
이 매뉴얼에서는 DirectCloud Gateway의 '동기화 로그' 메뉴에서 동기화 이력을 확인하는 방법을 설명합니다. 또한 로그 필터링과 CSV 파일 다운로드, 진단 로그 다운로드도 설명합니다.

***

### 제한·보충사항 <a href="#a04" id="a04"></a>

* 이 매뉴얼의 순서는 조직의 NAS 관리자를 대상으로 합니다.
* 이 매뉴얼의 순서를 실행하려면, DirectCloud Gateway를 설치하는 방법의 순서에 따라 DirectCloud Gateway를 설치하고 로그인까지 완료해야 합니다.
* '동기화 로그' 메뉴와 '대시보드' 메뉴는 첫 동기화 사이클이 정상적으로 끝난 뒤에 선택할 수 있습니다. 그전까지는 '설정' 메뉴만 선택할 수 있습니다.
* 동기화 로그는 NAS의 DirectCloud Gateway에만 보관되며, DirectCloud 쪽에는 별도로 저장되지 않습니다.
* DirectCloud Gateway의 동기화 로그 보존 기간은 30일로 고정되어 있습니다. 30일이 지난 로그는 자동으로 삭제됩니다. 보존 기간은 이용자나 회사 단위로 변경할 수 없습니다. 30일을 넘겨 동기화 로그를 보관해야 한다면, 'CSV 다운로드'로 정기적으로 내려받아 별도로 보관합니다. 자동 삭제된 로그는 복원할 수 없습니다.
* 파일 작업 이력은 DirectCloud 관리자 페이지의 '로그' > '파일 작업 내역 (FU)' 메뉴에서 확인합니다. 이 메뉴에 기록되는 것은 동기화 로그와는 별개의 정보입니다.
* 이 매뉴얼은 2026년 9월 29일 업데이트로 릴리스된 DirectCloud Gateway(Beta)의 개발 버전을 이용해 작성했습니다. 이 매뉴얼에서 사용하는 화면명이나 동작이 실제와 다를 수 있습니다.

***

### 절차 <a href="#a05" id="a05"></a>

{% hint style="warning" %}
**동기화 로그 보기**
{% endhint %}

**\[상태 확인하기]**

1. 화면 왼쪽 메뉴에서 '동기화 로그'를 선택합니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2F7N5Oa4hcJkeDFIFGg3sa%2Fimage.png?alt=media&amp;token=789a62c8-bfc9-4fd5-a5fd-0d52837361f3" alt=""><figcaption></figcaption></figure>

동기화 이벤트가 시간순으로 표시됩니다.

각 열의 의미는 다음과 같습니다.

<table><thead><tr><th width="187">항목</th><th>설명</th></tr></thead><tbody><tr><td>시각</td><td>이벤트가 기록된 일시가 최신순으로 위에서부터 표시됩니다.</td></tr><tr><td>카테고리</td><td><p>이벤트 내용을 분류한 배지가 표시됩니다. 자세한 내용은 뒤에 나오는 '카테고리'를 참조합니다.</p><p>배지는 로그 레벨(OK, INFO, WARN, ERR)에 따라 색이 구분됩니다.</p></td></tr><tr><td>방향</td><td><p>동기화와 관련된 카테고리일 때 다음 중 하나의 동기화 방향이 표시됩니다.</p><ul><li>NAS→DirectCloud</li><li>DirectCloud→NAS</li></ul></td></tr><tr><td>메시지</td><td>이벤트의 상세 내용이 표시됩니다. 대상 파일 경로나 오류 내용이 포함됩니다.</td></tr></tbody></table>

**\[카테고리]**

이벤트는 다음 카테고리로 분류됩니다.

{% hint style="info" %}
**NOTE**

* 카테고리 배지와 함께 '단계 건너뜀', '보완 스캔', '변경 없음' 같은 로그 종류를 나타내는 배지가 표시될 수 있습니다.
* '주기 스킵'은 사이클 단위, '단계 건너뜀'은 사이클 안의 단계 단위, '스킵'은 개별 파일이나 폴더 단위로 처리되지 않았음을 나타냅니다.
* DirectCloud의 이름 정책 위반이 실시간으로 감지되면, 1시간당 20건까지 개별로 기록됩니다. 20건을 넘기면 이름 정책 위반 파일이 스킵되었다는 알림이 1회 기록되고, 초과한 만큼은 다음 정기 동기화에서 개별로 기록됩니다. 파일이 사라지지는 않습니다.
  {% endhint %}

<table data-search="false"><thead><tr><th width="161.5999755859375">카테고리</th><th width="146.00006103515625">라벨</th><th>대표 로그</th></tr></thead><tbody><tr><td>동기화 시작</td><td>INFO</td><td><p>동기화 사이클 #{cycle} 시작</p><p>폴더 스캔 완료(폴더: {folders}건)</p><p>초기 동기화이므로 NAS→DirectCloud 동기화만 실행합니다(DirectCloud→NAS는 다음 회차부터)</p></td></tr><tr><td>동기화 완료</td><td>OK／INFO</td><td><p>동기화 완료(업로드: {uploaded}, 스킵: {skipped}, 오류: {errors}, 소요: {elapsed})</p><p>DirectCloud→NAS(다운로드: {downloaded}, 스킵: {skipped}, 오류: {errors}, 전체: {total})</p></td></tr><tr><td>충돌 처리</td><td>WARN</td><td>충돌 감지: {path} — last-write-wins 정책으로 처리되었습니다</td></tr><tr><td>주기 스킵</td><td>WARN</td><td><p>사이클 미완료: 다음 예약 실행을 스킵</p><p>동기화가 일시정지됨 — 사이클을 실행하지 않습니다</p><p>DirectCloud 관리자 페이지에서 동기화가 비활성으로 설정되어 있어 사이클을 실행하지 않습니다(서버 확인)</p></td></tr><tr><td>인증 갱신</td><td>INFO／WARN／ERR</td><td><p>DirectCloud 토큰 갱신 실패: 비밀번호로 다시 로그인을 시도합니다({error})</p><p>DirectCloud 로그인에 실패했습니다: {error}</p></td></tr><tr><td>연결 오류</td><td>ERR</td><td><p>NAS 연결에 실패했습니다: {error}</p><p>폴더 스캔에 실패했습니다: {error}</p><p>DirectCloud→NAS 동기화에 실패했습니다: {error}</p></td></tr><tr><td>스킵</td><td>WARN</td><td>권한이 없어 스킵: {path}</td></tr><tr><td>동기화 오류</td><td>ERR</td><td><p>DirectCloud 폴더 생성/확인에 실패했습니다: {path}(이하 생략)</p><p>업로드 실패: {path} — 전송중에 연결이 끊겼습니다. 다음 동기화에서 다시 시도합니다.</p><p>업로드 실패: {path} — 서버 응답을 해석할 수 없습니다.(이하 생략)</p></td></tr></tbody></table>

{% hint style="warning" %}
**동기화 로그 작업**
{% endhint %}

**\[동기화 로그 필터링하기]**

1. 화면 상단의 '필터'에서 표시할 이벤트에 체크합니다.

{% hint style="info" %}
**NOTE**\
필터는 대표 분류로 필터링하기 위한 것이며, 카테고리와 1대1로 대응하지는 않습니다. 특정 카테고리만 표시할 수 없을 때는 '전체'를 선택한 뒤 카테고리 배지로 확인합니다.
{% endhint %}

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2FdLms3ICyTHXcignIRynl%2Fimage.png?alt=media&amp;token=4b1d66a6-5065-4e64-8c79-95645fcf0d71" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th width="255">필터</th><th>설명</th></tr></thead><tbody><tr><td>전체</td><td>전체 로그를 표시합니다.</td></tr><tr><td>동기화</td><td>동기화 로그만 표시합니다.</td></tr><tr><td>충돌</td><td>충돌 처리에 관한 로그만 표시합니다.</td></tr><tr><td>오류</td><td>오류 로그만 표시합니다.</td></tr><tr><td>주기 스킵</td><td>스킵에 관한 로그만 표시합니다.</td></tr><tr><td>인증</td><td>인증 갱신에 관한 로그만 표시합니다.</td></tr><tr><td>정보</td><td>동기화 보류, 일시정지·중지, DirectCloud→NAS 동기화 결과 요약 등 참고용 로그만 표시합니다.</td></tr></tbody></table>

**\[동기화 로그를 CSV로 다운로드하기]**

DirectCloud Gateway의 동기화 로그 보존 기간은 30일로 고정되어 있습니다. 감사 등으로 장기간 보관이 필요하면, CSV로 내려받아 별도로 보관합니다.

{% hint style="info" %}
**NOTE** 필요하면 '필터'로 표시를 필터링한 뒤 다운로드할 수 있습니다.
{% endhint %}

1. 'CSV 다운로드' 버튼을 클릭합니다. 표시된 로그가 CSV 파일로 다운로드됩니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2F19ewrZmab8u1zxgjfJjn%2Fimage.png?alt=media&amp;token=5b85461a-5563-4e95-8dec-62f025f97659" alt=""><figcaption></figcaption></figure>

**\[진단 로그 다운로드하기]**

애플리케이션 오류가 발생하면, 진단 로그를 내려받아 지원팀에 보냅니다. 개발 부문이 원인을 가려내는 데 사용합니다.

{% hint style="info" %}
**NOTE** 진단 로그는 동기화 로그와는 별개인 애플리케이션 내부 로그입니다. '동기화 로그' 화면에는 표시되지 않습니다.
{% endhint %}

1. 'CSV 다운로드' 버튼 왼쪽에 있는 '진단 로그 다운로드' 버튼을 클릭합니다. 진단 로그가 다운로드됩니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2FfMFL7YNbHJOAuNjdaJSI%2Fimage.png?alt=media&amp;token=56808fc5-72d1-4735-a398-3a52d18a6d63" alt=""><figcaption></figcaption></figure>

2. 출력된 JSON의 synced\_files에 포함된 ID별 정보는 다음과 같습니다.

<table data-search="false"><thead><tr><th width="177.4000244140625">키</th><th>설명</th></tr></thead><tbody><tr><td>ID</td><td>레코드의 내부 ID</td></tr><tr><td>CreatedAt</td><td>레코드가 DB에 등록된 날</td></tr><tr><td>UpdatedAt</td><td>레코드가 마지막으로 갱신된 일시</td></tr><tr><td>DeletedAt</td><td>논리 삭제된 일시(null = 삭제되지 않음)</td></tr><tr><td>LocalPath</td><td>로컬의 파일 경로(동기화 대상 폴더 기준 상대 경로)</td></tr><tr><td>RemoteFileID</td><td>DirectCloud의 파일 ID</td></tr><tr><td>RemoteNode</td><td>파일이 존재하는 DirectCloud의 노드(폴더) ID</td></tr><tr><td>Reginfo</td><td>업로드 시 등록 정보(타임스탬프 기반의 관리용 문자열)</td></tr><tr><td>Hash</td><td>파일 내용의 해시값(동기화 정합성 확인에 사용)</td></tr><tr><td>Size</td><td>파일 크기(바이트)</td></tr><tr><td>LastModified</td><td>파일의 최종 수정일시(로컬 또는 리모트 메타데이터)</td></tr><tr><td>SyncedAt</td><td>가장 최근에 동기화가 완료된 일시</td></tr><tr><td>Status</td><td><p>동기화 상태</p><p>예: synced＝동기화 완료</p></td></tr><tr><td>LastSeenCycle</td><td>이 파일이 마지막으로 확인된 동기화 사이클 번호</td></tr><tr><td>HashCheckedCycle</td><td>해시 검증이 마지막으로 이루어진 동기화 사이클 번호</td></tr></tbody></table>