> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/monitoring/view-device-logs.md).

# 장치 로그 보기

장치에서 실행 중인 Roboflow 서비스의 로그를 검색하고, 필터링하고, 다운로드합니다.

디바이스 로그를 사용하면 디바이스가 실행되는 동안 Roboflow 서비스의 출력을 읽거나 이전 출력을 확인할 수 있습니다.

디바이스가 Roboflow로 보내는 로그 줄에는 [배포 크레딧](https://docs.roboflow.com/platform/billing-and-plans#credits) 이 사용되며, 사용 요금은 [크레딧 페이지](https://roboflow.com/credits).

## 웹 앱

Deployment Manager에서 디바이스를 열고 "로그"를 선택합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-54a9cefd594a894757bedbfd9a107ecc8e61e3ae%2Fenterprise-device-logs.png?alt=media" alt="Logs tab with the keyword filter, severity and service filters, Live, and the histogram"><figcaption></figcaption></figure>

### 실시간 로그 및 기록 로그

탭은 "실시간"으로 열리며 새 로그 줄이 하단에 표시됩니다. 새 로그 줄 표시를 중지하려면 "실시간" 옆의 일시 중지 컨트롤을 클릭합니다. 재생을 클릭할 때까지 탭에 "일시 중지됨"이 표시됩니다.

위로 스크롤하면 이전 로그 줄을 불러옵니다. 하단에서 벗어나 있으면 탭에 "일시 중지됨"이 표시됩니다. 일시 중지 컨트롤을 사용하지 않았다면 하단으로 다시 스크롤해 새 로그 줄을 계속 확인할 수 있습니다.

특정 시간 범위를 확인하려면 시간 메뉴를 열고 "지난 15분", "지난 1시간", "지난 24시간", "지난 7일" 또는 "지난 30일"을 선택합니다. 같은 메뉴에서 "맞춤 범위" 달력을 사용할 수도 있습니다. 시간 범위를 선택하면 새 로그 줄 표시가 중지되고 탭에 "기록"이 표시됩니다. "전체 기간"을 선택하면 날짜 필터 없이 새 로그 줄이 계속 표시됩니다. "새로고침"을 클릭하면 같은 범위를 다시 불러옵니다. "실시간으로 돌아가기"를 클릭하면 새 로그 줄이 다시 표시됩니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-18cc1dfe218830cea346ffcd8bd94faf314bb33c%2Fdevice-logs-historical.png?alt=media" alt="Historical logs for a custom range, with Refresh and Return to Live"><figcaption></figcaption></figure>

### 맞춤 범위

"맞춤 범위"에서 달력의 시작 날짜와 종료 날짜를 선택합니다. "시작"과 "종료"를 설정한 다음 "적용"을 클릭합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-4d549c65775165e90a0212de48104093b514335e%2Fdevice-logs-custom-range.png?alt=media" alt="Custom Range calendar with Start, End, and Apply"><figcaption></figcaption></figure>

### 검색

"키워드로 로그 필터링"에 입력하면 메시지 텍스트와 서비스 이름에서 일치하는 항목을 찾습니다. 검색은 대소문자를 구분하지 않으며 입력한 문자를 그대로 검색하므로 공백과 문장 부호도 일치 여부에 영향을 줍니다. 또한 `*` 와 같은 문자는 특별한 의미가 없습니다. 히스토그램에도 목록과 동일한 검색이 적용됩니다. 강조 표시는 입력한 텍스트와 정확히 일치하는 부분만 표시합니다. 단어 하나를 검색하면 해당 단어가 나타나는 위치에 표시됩니다(예: `error`). 여러 단어는 같은 순서로 연이어 나타날 때만 표시되므로 `error timeout` 은 두 단어가 떨어져 있는 로그 줄에서는 표시되지 않습니다. 따옴표로 묶은 구문은 로그 줄에 따옴표까지 포함되어 있을 때만 표시됩니다.

* 여러 단어를 검색하면 그중 하나라도 포함된 로그 줄이 일치합니다(예: `error timeout`). 단어는 더 긴 단어 안에 포함되어 있어도 일치합니다(예: `back` 는 `backend`).
* 와 일치합니다. 큰따옴표로 묶은 텍스트는 하나의 구문으로 검색됩니다.
* 구문에 다른 단어를 더해 검색하면 구문과 그 단어 중 하나 이상이 포함된 로그 줄이 일치합니다.

특정 요청을 찾으려면 다음을 `"GET /stats HTTP/1.1"` 따옴표까지 포함해 검색합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-7cdd4c050796aad4f2065fab5d266f7e94076213%2Fdevice-logs-search-phrase.png?alt=media" alt="Quoted phrase GET /stats HTTP/1.1 in the filter, highlighted in the matching lines"><figcaption></figcaption></figure>

### 심각도

"모든 로그 유형"을 열어 목록과 히스토그램을 특정 심각도로 제한합니다. "모두 선택" 또는 "모두 지우기"를 클릭하고 원하는 수준을 선택하거나, 특정 수준만 남기려면 해당 수준 옆의 "만"을 클릭합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-333262b4193de7e89323af6c63ebeeffd508efa9%2Fdevice-logs-severity.png?alt=media" alt="Severity menu with Select All, Clear All, and Debug through Emergency"><figcaption></figcaption></figure>

메뉴의 수준은 syslog 수준입니다. 표에는 Linux 및 journald와 같은 순서로 심각도가 높은 항목부터 표시됩니다. 메뉴에는 Debug부터 Emergency까지 표시됩니다.

<table data-search="false"><thead><tr><th>수준</th><th>번호</th><th>의미</th></tr></thead><tbody><tr><td>Emergency(긴급)</td><td>0</td><td>시스템을 사용할 수 없습니다.</td></tr><tr><td>Alert(경보)</td><td>1</td><td>즉시 조치해야 합니다.</td></tr><tr><td>Critical(치명적)</td><td>2</td><td>치명적인 상태입니다.</td></tr><tr><td>Error(오류)</td><td>3</td><td>오류가 발생했습니다.</td></tr><tr><td>Warning(경고)</td><td>4</td><td>경고입니다. "WARN"도 같은 수준입니다.</td></tr><tr><td>Notice(알림)</td><td>5</td><td>정상 상태이지만 주의가 필요합니다.</td></tr><tr><td>Info(정보)</td><td>6</td><td>일반 작업입니다.</td></tr><tr><td>디버그</td><td>7</td><td>문제 해결을 위한 세부 정보입니다.</td></tr></tbody></table>

Roboflow는 Error, Warning, Info, Debug, Success를 저장합니다. Notice, Critical, Alert, Emergency는 Info로 저장되므로 해당 수준으로 필터링해도 일치하는 로그가 없습니다.

### 서비스

표시할 서비스를 선택하려면 "모든 서비스"를 엽니다. 서비스 옆의 "only"를 클릭하면 해당 서비스만 표시됩니다. 처음부터 다시 선택하려면 "모두 지우기"를 클릭합니다. 서비스를 선택하지 않으면 목록에 "로그를 보려면 서비스를 하나 이상 선택하세요."라고 표시됩니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-b8c8716ed438b294c3ed10e1fe34d545270823eb%2Fdevice-logs-services.png?alt=media" alt="Services menu listing event-store, hmi, inference, redis, and rfdm"><figcaption></figcaption></figure>

메뉴에는 기기의 서비스가 나열됩니다. 일반적인 기기에는 다음 서비스가 있습니다.

* `inference` 모델과 Workflow를 실행합니다.
* `rfdm` 컨테이너를 설치하고 로그, 텔레메트리, 장치 상태를 Roboflow로 전송합니다.
* `hmi` 구성된 경우 장치에서 인터페이스를 실행합니다.
* `redis` Roboflow와 동기화될 때까지 텔레메트리를 보관합니다.
* `event-store` 구성된 경우 최근 비전 이벤트를 저장합니다. 자세한 내용은 [이벤트 스토어](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/services/event-store.md).

커널 및 systemd-oomd 로그(예: 메모리 부족으로 인한 프로세스 종료)는 Docker 장치에서만 표시되며, 해당 장치의 `device.json` 설정합니다 `collect_kernel_logs` 을 true로 설정합니다. 기본적으로 이 설정은 꺼져 있습니다. 탭에는 호스트 저널 전체가 표시되지 않습니다.

기기가 Roboflow에 보고하지 않으면 기기에서 다음 명령을 실행합니다. `sudo /opt/rfdm/bin/rfdm tools run-checks` 이 명령은 Docker, Roboflow 연결, 디스크, 메모리, 시간 동기화 및 RFDM 서비스를 확인한 다음 기기의 컨테이너 목록을 표시합니다. 스크립트에서 읽을 수 있는 출력을 얻으려면 `--json` 을 추가합니다.

### 히스토그램

히스토그램에 표시할 기간을 설정하려면 "1h", "6h", "24h", "7d" 또는 "30d"를 클릭하고, 7일로 돌아가려면 "Reset"을 클릭합니다. "Hide chart"를 클릭하면 히스토그램이 접힙니다. 차트 아래의 색상 점은 각 심각도를 나타냅니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-b53ef79f6d5d08fb1a3d4b8501eb53a73ca0cd31%2Fdevice-logs-histogram.png?alt=media" alt="Histogram bars for a steady stretch, with the window buttons, Reset, and the severity legend"><figcaption></figcaption></figure>

### 타임스탬프

브라우저의 시간대로 시간을 표시하려면 "사용자 시간"을 선택하고, 기기의 시간대를 표시하려면 "기기 시간"을 선택합니다. "기기 시간"은 Deployment Manager에 해당 기기의 유효한 시간대가 설정된 경우 사용할 수 있습니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c717b0ee617b818401529a40f726b40251f0df78%2Fdevice-logs-timezone.png?alt=media" alt="User Time selected next to Device Time"><figcaption></figcaption></figure>

### 다운로드

다운로드 버튼을 클릭하면 현재 필터와 일치하는 행을 CSV 파일로 내보냅니다.

1. "로그 다운로드"에서 "서비스", "심각도", "시간 범위", "검색"을 확인합니다. "행 제한"은 내보내기에 포함되는 최대 행 수입니다.
2. "일치하는 로그 모두 내보내기(최대 50,000행)"가 이미 선택되어 있습니다. 현재 브라우저에 표시된 행만 내보내려면 "이미 로드된 로그 내보내기"를 선택합니다. 이 옵션은 브라우저에서 이미 적용된 필터를 기준으로 최대 10,000행을 포함합니다.
3. "시작"을 클릭합니다.
4. 파일이 준비되면 "CSV 다운로드"를 클릭합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-59c0f3c0207849b72df2c74984e3696870e5c0fc%2Fdevice-logs-download.png?alt=media" alt="Download Logs dialog with the current filters, row limit, and the two export choices"><figcaption></figcaption></figure>

### 활동

켜기 [활동](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/monitoring/view-device-activity.md), 오류에서 "로그 보기"를 클릭하면 해당 시점의 이 탭이 열립니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-5df570bad4636c493ca670536e1dadec4974e2b7%2Fdevice-logs-activity.png?alt=media" alt="View logs on an inference error in Activity"><figcaption></figcaption></figure>

### 로그 전송 수준

기기에서 Roboflow로 전송할 로그의 최저 심각도를 선택하려면 "고급 구성" 아래의 "구성"에서 "로그 전송 수준"을 설정하세요. 기기는 자체 로그를 최대 24시간 동안 보관합니다. 기본 전송 수준인 INFO는 Info와 그보다 심각도가 높은 모든 수준(고객 PRINT 출력 포함), 기기 이벤트, 수준이 지정되지 않은 줄을 전송합니다. DEBUG는 모든 줄을 전송합니다. 자세한 내용은 다음을 참조하세요. [기기 구성 업데이트](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/update-device-configuration.md).

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-cd0ad0d6723b0e9386e67a47eb0cc5a03df26a40%2Fdevice-logs-shipping.png?alt=media" alt="Log Shipping Level set to INFO under Advanced Configuration"><figcaption></figcaption></figure>

## 에이전트 및 API

The [Deployment Manager API](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager.md#device-logs-and-telemetry) 는 시간 범위, 서비스, 심각도로 필터링한 저장된 줄을 반환합니다. 요청 하나당 최대 1,000줄을 반환합니다. 다음을 전달하세요. `next_cursor` 이전 항목으로 이동하려면 `cursor` 이전 줄을 읽습니다. API는 키워드 검색을 지원하지 않습니다.

MCP 클라이언트는 다음을 사용해 읽습니다. `devices_get_logs` (자세한 내용은 [MCP 도구 목록](https://docs.roboflow.com/agents/mcp-server#devices-and-streams)). [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) 는 기기에 관해 질문하면 해당 로그를 읽습니다. 두 방법 모두 같은 필터를 사용하며 줄 수는 최대 1,000개입니다. Roboflow Agent는 각 메시지에서 비밀 정보도 제거합니다.
