# 운영 모범 사례

> 프로덕션에서 Xisom Edge AI를 운영하기 위한 실용 가이드 — 모델 준비, 데이터소스 크기 설정, 모니터링, 배포, 보안.

프로덕션에서 Xisom 박스를 건강하게 유지하기 위한 현장 검증 가이드입니다. 각 섹션은
전체 세부 정보가 담긴 참조 페이지로 연결됩니다. **자리표시자**로 표시된 섹션은
현장 데이터로 마무리 중입니다 — 확정된 수치가 아니라 방향으로 받아들이세요.

## 운영 루프

```mermaid
flowchart LR
  P["준비<br/>modelctl"] --> D["배포<br/>업로드 + 페어링 + 활성화"]
  D --> M["모니터링<br/>지연 시간 · 처리량 · EP"]
  M -->|"드리프트 / 신규 데이터"| P
  M -->|"버전 업"| D
```

## 모델 준비

- **박스의 ONNX Runtime 버전 기준으로 검증**한 뒤 배포하세요 — `--target-ort`를
  고정하여 너무 최신인 opset이 현장이 아니라 워크스테이션에서 실패하도록 합니다.
- **양자화는 신중하게.** 동적 INT8은 모델을 더 작고 대개 더 빠르게 만들지만 정확도가
  다소 떨어집니다 — 양자화된 모델을 재검증하고 예측 품질을 확인한 뒤 적용하세요.
- **재현 가능한 번들을 고정**(`--timestamp`)하여 박스의 아티팩트가 검토한 것과
  일치하도록 합니다. [모델 준비](/ko/configure/prepare-models/)를 참조하세요.

## 데이터소스 크기 설정

- **윈도우 크기 × 피처 수를 일치**시키세요 — 플랫폼은 불일치한 페어링을 거부합니다.
  모든 모델에 대해 이 두 값을 기록하세요.
- 서버가 지원하는 경우 폴링보다 **OPC-UA 구독**을 우선하세요.
- 라이브 플랜트 소스에 연결하기 전에 **CSV 리플레이**로 기록된 데이터에 대해 모델을
  검증하세요. [입력 데이터소스](/ko/configure/input-datasources/)를 참조하세요.

## 모니터링 및 알림

- **평균이 아니라 p95/p99 지연 시간을 관찰**하세요 — 엣지 추론은 꼬리 지연에서
  먼저 저하됩니다.
- **실행 공급자가 CPU로 폴백되는 것은 회귀 신호**입니다 — TensorRT/CUDA로 실행되어야
  할 박스가 CPU를 보고하면 처리량이 떨어지기 전에 조사하세요.
- **라이브 메트릭은 3일간 보관**됩니다 — 장기 추세가 필요하면 내보내세요.
  [모니터링](/ko/operate/monitoring/)을 참조하세요.

**자리표시자 — 권장 임계값**

하드웨어 등급별 구체적인 지연 시간 / 처리량 알림 임계값은 아직 현장 배포에서
수집 중입니다. 여기에 채워 넣을 예정입니다.

## 배포 및 버전 관리

- **프런트엔드와 백엔드 버전을 일치**시키세요 — 드리프트가 발생하면 버전 불일치
  배너가 표시됩니다. [버전 및 업데이트](/ko/operate/versioning/)를 참조하세요.
- 프로덕션 박스로 승격하기 전에 **Docker 랩에서 스테이징**하세요.
  [Docker 랩](/ko/operate/docker-lab/)을 참조하세요.

**자리표시자 — 용량 및 크기 설정**

하드웨어별 가이드(박스당 모델 수, 엣지 장치별 최대 지속 처리량)는 벤치마크
데이터를 기다리고 있습니다. 여기에 채워 넣을 예정입니다.

## 보안

- **최소 권한을 적용**하세요 — 필요한 작업(출력 테스트 쓰기, 키 관리)에만 관리자
  계정을 사용하고, 운영자는 운영자로 로그인합니다.
- **감사 추적을 주기적으로 검토**하세요 — 누가 언제 시스템에 접근했는지 기록됩니다.
- 대시보드와 API 앞단의 **리버스 프록시에서 TLS를 종료**하고, 데이터소스에는 인증된
  브로커 / 보안 OPC-UA 정책을 사용하세요. [보안](/ko/security/)을 참조하세요.

**자리표시자 — 백업 및 복구**

모델 데이터와 구성에 대한 권장 백업 주기와 복구 절차를 문서화하는 중입니다.
여기에 채워 넣을 예정입니다.

## 다음 단계

  - [모델 준비](/ko/configure/prepare-models/) — 변환, 검증, 양자화, 패키징.
  - [모니터링](/ko/operate/monitoring/) — 추론 대시보드 읽기.
  - [보안](/ko/security/) — 접근 제어, 하드닝, 감사.