Edge Fleet | Geo-MLOps 매뉴얼

공장·현장에 설치한 장비(Edge)를 관리하는 화면입니다. 장비는 Edge SDK로 플랫폼에 붙어 주기적으로 하트비트(살아 있다는 신호와 CPU·메모리 사용률)를 보내고, 수집한 데이터·추론 결과·파일을 올리며, 플랫폼이 보낸 명령을 가져가 실행합니다.

보기는 모든 멤버, 재시작·Offline·명령 보내기·로그 보기는 operate(OPERATOR·ADMIN), 장비 등록·삭제·위치 편집·토큰·정책은 settings(ADMIN)입니다.

장비 목록

번호	영역	설명
①	검색	장비 이름·장소로 찾습니다.
②	상태 필터	전체 · 연결 대기 · 정상 · 비정상 · 미설치.
③	디바이스 등록	새 장비를 등록하고 토큰을 발급합니다(`settings`).
④	상태	장비 상태. 서버에서 차단한 장비에는 빨간 Offline 차단됨 이 더 붙습니다.
⑤	대기	장비에 쌓여 아직 보내지 못한 건수. 최근 24시간 동안 보존 한도를 넘어 버린 건이 있으면 빨간 `−N` 이 붙습니다.
⑥	동기화	장비의 전송 상태: 대기, 전송 중, 일시정지, 오프라인, 인증 실패.

CPU·GPU·MEM 은 마지막 하트비트의 사용률입니다. 줄을 누르면 장비 상세로 갑니다.

디바이스 등록 을 누릅니다.
디바이스 ID(필수)와 위치(선택)를 적고, 토큰 스코프(이 토큰으로 할 수 있는 일의 범위)를 고릅니다. 스코프에는 텔레메트리(하트비트·수집 레코드 보내기), 추론(추론 결과), 컨테이너(이미지 받기), 모델(모델 조회), 파일(오프라인 동안 쌓인 파일 올리기)이 있고, 기본은 모두 켜짐입니다.
디바이스 등록: 디바이스 ID·위치와 토큰 스코프. 등록하면 토큰이 한 번만 표시된다
등록 하면 장비 토큰이 한 번만 표시됩니다. 복사해 장비 설정에 넣으세요. 창을 닫으면 다시 볼 수 없고, 잃어버리면 토큰을 회전(새 토큰으로 바꾸기)해야 합니다.

번호	영역	설명
①	제목	장비 ID, 상태, 실시간(변화가 바로 반영됨) 또는 폴링 10초(10초마다 새로 가져옴), 가져가지 않은 명령이 있으면 대기 명령 N.
②	동작	재시작(`operate`), Offline(`operate`, 서버에서 차단), 삭제(`settings`, 살아 있는 토큰을 먼저 회수해야 켜짐).
③	탭	개요 · 수집 데이터 · 추론 결과 · 파일 · 명령 · 정책.
④	디바이스 정보	OS, SDK·에이전트 버전, 위치(위치 편집), 마지막 하트비트, 정책 리비전(정책의 버전 번호. 장비가 새 정책을 적용했는지 봅니다).
⑤	리소스	CPU·GPU·MEM·DISK 사용률(30초 갱신).
⑥	쌓인 데이터	대기 건수·용량, 가장 오래된 것, 24시간 폐기, 동기화 상태, 마지막 전송.
⑦	토큰 관리	회전(새 토큰 발급, 한 번만 표시), 회수(토큰 폐기), 스코프 보기·편집(`settings`).

그 밖에 로컬 모델(장비에 받아 둔 모델과 실행 중인 버전. 이 버전으로 전환 으로 바꿈), 수집기, 컨테이너, 로그(최근 하트비트)(operate) 카드가 있습니다.

수집 데이터: 장비가 올린 구조화 레코드(발생 시각·종류·우선순위·내용)입니다. 새 레코드가 계속 들어오며, 최신 고정 을 끄면 목록이 멈춰 천천히 읽을 수 있습니다. 위의 선택 상자로 종류를 거릅니다.

추론 결과: 장비에서 돌린 추론의 시각·모델·지연(ms)·결과(JSON)입니다.

파일: 오프라인 동안 쌓였다가 올라온 파일과 전송 상태, 조각(청크) 전송 진행, 연결된 데이터셋입니다.

명령: 장비에 보낸 명령과 결과입니다. 장비는 보통 공유기(NAT) 뒤에 있어 서버가 먼저 연결할 수 없습니다. 그래서 명령은 대기열(큐)에 들어갔다가, 장비가 다음에 물어볼 때 가져갑니다.

번호	영역	설명
①	명령 종류	핑(살아 있는지 확인), 재시작(에이전트를 다시 띄움), 재동기화(실패로 처리된 항목을 다시 전송 대기로 돌림), 모델 내려받기(모델 이름·버전을 골라 받아서 활성화).
②	명령 보내기	큐에 넣습니다(`operate`).

정책: 장비의 동작 설정입니다. ADMIN 만 고칠 수 있습니다. 저장하면 정책 리비전(버전 번호)이 오르고, 장비는 다음 하트비트 응답에서 바뀐 것을 알아채 새 정책을 가져갑니다.

장비 상태:

배지	값	뜻
연결 대기	PENDING	등록만 되고 하트비트가 한 번도 오지 않음
정상	ACTIVE	최근 180초 안에 하트비트가 옴
비정상	UNHEALTHY	마지막 하트비트가 180초보다 오래됨. 이렇게 되면 WARNING 경보가 만들어지고, 하트비트가 다시 오면 정상으로 돌아오며 경보도 저절로 풀립니다.
미설치	UNINSTALLED	설치가 해제된 장비로 표시됨

명령 상태:

파일 전송 상태: 전송 중 · 조립 중 · 완료 · 실패. 7일 동안 전송 중에 머문 파일은 실패로 바뀝니다.

장비를 잠시 끊고 싶을 때(점검, 의심스러운 동작) 개요의 Offline 을 누릅니다.