> 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/roboflow-cloud/cloud-streaming/manage-and-monitor.md).

# 관리 및 모니터링

Cloud Streaming 작업을 모니터링하고, 처리를 다시 시작하거나 중지하며, 커넥터 오프라인 알림을 구성하세요.

Cloud Streaming을 사용해 소스 상태와 Workflow 상태를 각각 확인하세요. 카메라가 온라인이라고 해서 Workflow가 처리 중이라는 뜻은 아니며, 카메라가 오프라인이어도 비디오를 기다리는 Workflow는 활성화된 상태로 남아 있을 수 있습니다.

## 웹 앱

"Deployments"를 연 다음 "Cloud Streaming"을 여세요. 커넥터를 열면 해당 커넥터의 소스를 볼 수 있고, 소스를 열면 해당 소스의 Workflow 실행을 볼 수 있습니다. 초안 미리보기는 배포와 별도로 표시되므로, 출력, 오류 또는 제어 항목을 확인하기 전에 원하는 실행을 선택하세요.

### 처리 상태

<table data-search="false"><thead><tr><th>상태</th><th>확인할 항목</th></tr></thead><tbody><tr><td>비디오 대기 중</td><td>사용 가능한 입력이 없습니다. 커넥터 또는 게시자를 확인하세요.</td></tr><tr><td>용량 대기 중</td><td>GPU를 기다리는 중입니다. 작업을 추가해도 도움이 되지 않습니다.</td></tr><tr><td>시작 중</td><td>Workflow 및 모델을 불러오는 중입니다.</td></tr><tr><td>처리 중</td><td>프레임 수가 증가하는지 확인하세요.</td></tr><tr><td>재연결 또는 재시도 중</td><td>복구 중입니다. 추적기와 카운터가 재설정됩니다.</td></tr><tr><td>리소스 조정 중</td><td>메모리가 부족해진 후 더 큰 GPU에서 다시 시작하는 중입니다.</td></tr><tr><td>주의 필요</td><td>실패가 5회 발생하거나, 처리 없이 15분이 지나거나, 한 시간 동안 10회 시작된 후 복구가 일시 중지되었습니다. 원인을 해결한 다음 다시 시작하세요.</td></tr><tr><td>복구가 중단되었거나 실패함</td><td>다시 시작하기 전에 오류를 확인하세요.</td></tr><tr><td>중지됨</td><td>자동으로 재개되지 않습니다.</td></tr></tbody></table>

복구 없이 실행되는 경우(예: 미리보기)에는 원시 상태(예: "Queued", "Running")가 표시됩니다.

"Needs Attention"에는 오프라인 커넥터와 차단된 Workflow가 표시됩니다. 자세한 내용은  [문제 해결](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/troubleshooting.md).

### 활동

실행을 선택하고 "Activity"를 열면 자동 복구가 켜져 있을 때 최신 수명 주기 변경 사항(최대 30개 항목)을 확인할 수 있습니다. 대기, 재시도, 실패의 원인을 설명합니다. 예측 기록, 비디오 아카이브 또는 로그는 아니므로, 해당 항목은  [최신 결과, 싱크 또는 저장된 캡처](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/consume-results.md) 를 사용하세요.

### 로그

소스 메뉴에서 "Logs"를 클릭하면 해당 소스의 Workflow 실행에 대한 프로세서 출력을 볼 수 있습니다. 여기에는 Custom Python 블록의 출력도 포함됩니다. 다시 시작할 때마다 새 실행이 시작됩니다. 로그에는 Workspace의 로그 보존 정책이 적용되며,  [장치 로그](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/monitoring/view-device-logs.md)와 동일한 방식으로 요금이 부과됩니다. 실행 중에는 이 대화상자에서  [최근 결과 다운로드](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/consume-results.md#web-app) 도 할 수 있습니다.

### 처리 다시 시작

다시 시작하면 최신 게시된 Workflow가 적용되고 메모리 내 상태가 초기화됩니다. 예외 사항은  [다시 시작 동작](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md#restarts).

에서 설명합니다. 실행을 선택하고 "Restart"를 클릭하세요. 소스 목록에서 다시 시작하면 미리보기는 건너뜁니다. 업로드된 파일의 경우 "Run Again"을 클릭하세요. 가장 큰 GPU에서도 메모리가 부족해 실행이 중단됐다면 "Choose a Workflow"를 클릭하고 더 가벼운 Workflow를 선택하세요.

활성 배포를 모두 다시 시작하려면 "Restart All Streams"를 클릭하고 소스 및 Workflow 개수를 확인한 다음 "Restart All"을 확인하세요. 중지된 스트림은 계속 중지된 상태로 유지됩니다. 일부만 다시 시작되면 "Try Again"을 클릭해 완료되지 않은 항목만 다시 시도하세요.

다시 시작 과정에서 이전 실행을 중지하는 동안 새 작업을 시작하지 마세요.

### 처리 중지

실행을 선택하고 "Stop"을 클릭한 다음 "Stop processing"을 클릭하세요. 더 이상 필요하지 않은 각 실행을 중지하세요. 페이지를 닫아도 배포는 중지되지 않습니다. 자세한 내용은  [중지](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md#stopping).

### 소스 이름 변경 또는 삭제

커넥터에 연결된 소스는 작업 메뉴에서 이름을 변경하고, 직접 연결한 소스는 "Connection Settings"에서 이름을 변경하세요. "Delete"는 실행을 중지하는 용도가 아니라 소스 자체를 삭제할 때만 사용하세요. 삭제된 카메라가 여전히 커넥터에 보고되면 다시 등록됩니다. 해당 카메라를 계속 삭제된 상태로 유지하려면 커넥터 설정에서 카메라를 비활성화하거나 제거하세요.

## 오프라인 알림

알림은 Workspace 수준에서 선택적으로 설정할 수 있습니다. 커넥터를 등록하는 것만으로는 이메일이 발송되지 않습니다.

1. "클라우드 스트리밍"에서 "오프라인 알림"을 클릭합니다.
2. 알림을 활성화하고 Workspace 구성원 중 수신자를 선택합니다.
3. 오프라인 임계값, 알림 반복 여부, 시간당 및 일일 한도를 설정합니다.
4. "저장"을 클릭합니다. 저장하지 않고 대화상자를 열기만 해서는 알림이 활성화되지 않습니다.

새 구성을 만들 때는 설정 중인 구성원이 선택되고, 오프라인 임계값은 5분, 알림 반복은 활성화, 이메일 한도는 시간당 2개 및 하루 10개로 기본 설정됩니다. 기존에 비활성화된 구성은 열어도 비활성화 상태로 유지됩니다. 한도는 커넥터별이 아니라 Workspace 전체에 적용됩니다.

각 이메일에는 Workspace 전체에서 알림 조건을 충족하는 오프라인 스트림이 함께 표시됩니다. 새로운 장애가 발생하면 해당 임계값이 지난 후 같은 한도 내에서 업데이트 알림이 전송될 수 있습니다. 반복 알림 간격은 점점 늘어납니다. 30분 후 1시간, 2시간, 4시간 간격으로 전송되고, 이후에는 6시간마다 전송됩니다. 새 스트림이 오프라인 상태가 되면 이 일정이 초기화됩니다. 복구 이메일은 전송되지 않습니다.

커넥터 페이지를 열고 "오프라인 알림" 토글을 사용해 해당 커넥터를 제외하거나 포함합니다. 기본적으로 커넥터는 포함되지만, Workspace에서 알림 설정을 저장하고 활성화해야 합니다.

### 알림 적용 범위

이메일은 복구 기능이 있는 배포를 실행하는 포함된 커넥터의 카메라를 대상으로 합니다. 미리 보기, 직접 소스 및 차단된 Workflow는 적용 대상이 아닙니다.

이메일이 임계값보다 늦게 도착할 수 있습니다.

테스트하려면 "나에게 테스트 이메일 보내기"를 사용합니다. 요청이 접수되었다고 해서 받은 편지함으로 이메일이 전달되었음을 의미하지는 않습니다.

## 권한

"스트림 처리 보기" 권한이 있으면 소스 및 실행 정보를 볼 수 있습니다. 소스 설정 변경, 처리 시작 또는 중지, 알림 변경, 테스트 이메일 전송에는 "소스 비디오 관리" 권한이 필요합니다. 실시간 미리 보기 및 시청 작업도 비디오 게시를 요청하므로 관리 권한이 필요합니다. 캡처를 저장하려면 업로드 권한도 필요합니다.

필요한 액세스 권한을 운영자별로 부여하려면 [사용자 지정 역할](https://docs.roboflow.com/platform/enterprise-features/role-based-access-control) 을 사용합니다. API 통합에는 해당하는 [API 키 범위](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys).

## HTTP API

작업을 조회하여 현재 상태와 오류를 확인합니다. 요청 시간 초과를 근거로 성공 여부를 판단하지 마세요. 상태를 변경하는 작업을 재시도하기 전에 기존 작업을 확인합니다.

{% openapi src="/files/ae7e4311e69eb877b2de6277c1563407df651d51" path="/{workspace}/video-jobs/v1/{jobId}" method="get" %}
[cloud-streaming.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

처리를 종료해야 하면 작업을 취소한 다음, 작업이 종료 상태에 도달할 때까지 조회합니다. 활성 프로세서는 비동기적으로 중지됩니다.

{% openapi src="/files/ae7e4311e69eb877b2de6277c1563407df651d51" path="/{workspace}/video-jobs/v1/{jobId}/cancel" method="post" %}
[cloud-streaming.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

재시작, 승격, 커넥터 관리 및 오프라인 알림 설정을 위한 API 엔드포인트는 없습니다. 이러한 작업에는 Web App을 사용하세요.
