전체 현황

같은 MSP사의 독립 IOC 서버에서 지자체 상태·로그·버전·배포 이력을 관리함.

운영 경계 및 배포 정책 보기

IOC와 모든 지자체 우리봄은 같은 MSP사의 IaaS를 사용함. 단, IOC는 별도 서버·별도 PostgreSQL·별도 HTTPS 도메인으로 운영하고 각 지자체 APP/DB도 서로 독립함. 같은 MSP라고 해서 DB/VPC를 공유하거나 지자체 DB에 직접 SQL 접속하지 않음. 서버 업데이트는 지자체 우리봄 Updater가 IOC를 Outbound HTTPS 443으로 Poll/Pull함. IOC는 서명된 릴리스만 지자체별 배정하고 임의 원격 셸/SSH/root 명령을 보내지 않으며, 지자체 서버가 서명·SHA-256 검증 후 버전별 deploy.sh로 Blue/Green 전환하고 결과를 IOC에 회신함.

등록 지자체-

상태 보고 정상-

상태 보고 지연/미확인-

장애·지원 이벤트-

진행 중 배포-

지자체 상태

지자체	MSP	상태 보고	APP 버전 정보	IOC 배포 버전	최근 배포기록	STB	최근 상태 보고

지자체 연결

상태 보고는 최신 상태 스냅샷을 기준으로 판정합니다. 로그 수신만 성공한 경우 최근 통신 시각은 갱신되지만 상태 보고는 지연 또는 미확인으로 남습니다.

지자체를 선택하면 공식 행정코드와 운영자 ID(예: 47-210-00)가 자동 확정됩니다. 설치 시 행정코드를 다시 입력하지 않습니다. 행정코드가 중복되거나 연결 설정과 다르면 등록·설치가 거부됩니다.

최초 연결 시 등록된 서비스 도메인과 우리봄 서버의 PUBLIC_BASE_URL이 일치해야 합니다. 다른 지자체로 잘못 연결되는 것을 방지합니다.

MSP가 지자체 서버 직접 연결을 허용하지 않으면 직접 관리용 주소는 비워 두세요. 회사 STB 설치·등록은 지자체 서버의 아웃바운드 HTTPS Pull로 처리합니다. 기존 직접 관리 프록시 기능은 주소·전용 인증이 없으면 동작하지 않습니다.

IOC와 우리봄은 어느 것을 먼저 배포해도 됩니다. 두 서버가 각각 독립적으로 설치된 뒤 IOC에서 지자체를 등록하고 [지자체 활성화]를 클릭하면, IOC가 해당 우리봄 HTTPS 서버로 활성화 이벤트를 전달합니다. 수동 연결코드나 재설치는 필요하지 않습니다.

ID	지자체	행정코드 / 운영자 ID	MSP	서비스 도메인	사설 관리망	최초 연결	상태 보고	최근 상태 보고	최근 통신	관리	허용

장애 관제 · 처리할 사건

STB가 보고하거나 서버가 감지한 확정 실패만 자동으로 묶습니다. 한 사건은 지자체·오류코드 단위이며, 건수는 TV 고장 대수나 현재 장애 지속을 의미하지 않습니다. 실제 대응 여부는 담당자가 확인하세요.

장애 현황조회 중

지자체상태

우선도	지자체	장애 종류	상태 / 담당	최초·최근 발견	누적 수신	처리
사건을 조회하고 있습니다.

기존 장애·고객지원 이벤트

오류/경고 및 기술지원·고객지원 이벤트의 최소 메타데이터만 수집함. 문의 본문·계정정보·audit detail_json은 중앙으로 복제하지 않음.

지자체이벤트·대상 검색

시각	지자체	레벨	이벤트	대상

기술 장애·복구 진단

민감정보를 제외한 핵심 오류 메타데이터만 수집합니다. 지자체 연결 단절 시 뒤늦게 전달될 수 있으며, 아래 ZIP은 사용자가 AI에 직접 제공합니다.

지자체 진단 수집 상태를 확인하고 있습니다.

파일 큐와 DB 보존 미전송은 같은 사건을 포함할 수 있으므로 합산하지 않습니다. DB 조회 불가를 0건으로 표시하지 않습니다.

지자체오류코드·단계·단말 참조 검색

STB 장애는 기존 20자리 내부 참조로 연결하며, 공공시설 관리번호가 확인되면 같이 표시합니다. 관리번호를 확인할 수 없으면 해당 지자체 CMS에서 참조를 대조하세요. MAC·IP·설치주소는 수집하지 않습니다. TV 화면을 직접 확인했다는 뜻은 아닙니다.

기록·감지시각	지자체	진단 코드·단계	예외/경로	버전	동일 오류 식별자

운영 로그 · 핵심 추이

진단 이벤트 중 확정 실패에 해당하는 건수만 집계합니다. IOC 수신일(KST) 기준이며, 지자체가 연결되지 않아 로그를 보내지 못하는 기간은 0건으로 표시될 수 있습니다. 0건은 STB 정상 보장이 아닙니다.

지자체기간

오류 추이 조회 전

일별 확정 실패 수신 추이 (KST)

자주 발생한 오류 코드

기존 운영 로그

지자체이벤트·대상 검색

지자체를 선택하면 최근 로그를 조회합니다.

시각	레벨	이벤트	대상

IOC 관리자 중요 행위

토큰 발급·재발급, 배포 지정, 진단 ZIP 다운로드 등의 감사이력을 IOC DB에 저장합니다. 토큰 값·본문·접속 IP는 기록하지 않습니다.

관리자 감사이력 조회 중

시각	작업자	지자체	관리자 행위

지자체별 Agora 사용량

조회월(KST)

녹화 500분·실시간 60분은 지자체 우리봄 CMS의 월 운영한도이며, Agora 청구시간이 아닙니다. 미수신 값은 0분으로 표시하지 않습니다. 월 마감 후에는 이전 달 집계를 한 번 더 수신합니다.

지자체	녹화 사용 / 500분	실시간 사용 / 60분	잔여(녹화/실시간)	최근 보고	Agora 프로젝트	조회

Agora 프로젝트 연결

각 지자체는 회사 Agora 계정 내 별도 프로젝트/App ID를 사용합니다. App Certificate·Customer Secret·토큰은 화면이나 지자체별 사용량 보고에 포함하지 않습니다. 별도 자격증명을 IOC 서버에 설정한 경우에만 '공식 사용량' 조회가 가능합니다.

STB 현황

STB가 120초 넘게 보고하지 않으면 미접속으로 표시합니다. 장애 확인 대상에는 이전에 접속했던 마을회관 STB만 포함하며, 한 번도 접속하지 않은 신규 단말은 별도 표시합니다. 중앙에는 원본 Heartbeat·IP·MAC·설치주소를 보내지 않습니다. CPU·메모리는 API 컨테이너 cgroup, 디스크는 해당 마운트가 속한 파일시스템의 값이며 MSP 서버 전체, DB 서버, Object Storage의 상태가 아닙니다.

지자체	전체	온라인	오프라인	오프라인 STB 식별	API 자원·로컬 볼륨	버전 분포	최근 보고

IOC 직원 계정

회사 직원만 이용하며 공개 회원가입은 없습니다. 최고관리자가 직원 아이디와 권한만 등록하면 1회용 설정코드가 발급됩니다. 직원이 직접 비밀번호를 설정합니다.

아이디	역할	배포 권한	상태	계정 관리

IOC 서명 업데이트 관리

1. 릴리스 생성Docker 이미지·버전 전용 deploy.sh/rollback.sh를 Self-Contained ZIP으로 생성함.

2. IOC 서명·배정IOC 호스트에서 패키지를 서명·등록한 뒤 대상 지자체에 릴리스를 배정함.

3. Outbound Pull지자체 Updater가 HTTPS 443으로 Poll/Pull하고 서명·SHA-256을 검증함.

4. Blue/GreenStandby /ready 성공 후 Nginx를 전환하고 실패 시 기존 Active를 유지/롤백함.

정식 셀프컨테인드 릴리스 ZIP만 접수합니다(소스 CODE_CANDIDATE ZIP 불가). 진행률은 브라우저 → IOC 전송률이며 검증·서명 완료율이 아닙니다. 접수 후 IOC 호스트에서 검증·서명합니다. 자동으로 지자체에 배정하지 않으며, 아래에서 지자체를 선택해 배정해야 합니다. 웹 접수 가능 표시와 별개로 호스트 서명 작업자 설치·작동 확인이 필요합니다.

웹 업로드 상태 조회 전

접수	Release ID	버전	상태	크기

웹 업로드가 비활성화된 경우

IOC 호스트에서 1회 설정으로 웹 업로드 작업자를 활성화하거나 기존 STAGE_AND_REGISTER_RELEASE.sh package.zip release-id version 경로를 사용합니다. 개인키는 IOC 호스트에만 보관하고 API 컨테이너·지자체에는 전달하지 않습니다.

등록시각	Release ID	버전	상태	크기	SHA-256	비고

업데이트 진행 상태

배정 → 지자체 호스트가 하루 1회 자동 확인 → 완료/실패/롤백을 표시합니다. 현재 설치기 기본 시각은 02:30(KST, 지자체별 변경 가능), IOC 기본 배정 유효기간은 72시간(환경설정으로 변경 가능)입니다. 두 값 모두 고정된 지자체 운영정책은 아닙니다. 긴급 즉시 실행은 승인된 지자체 서버 수동 작업이 필요합니다. 배포 관리 화면이 열려 있으면 10초마다 자동 갱신합니다. 결과 전송이 일시 실패하면 지자체 Updater는 같은 배포를 다시 실행하지 않고 결과만 재전송합니다.

배정시각	지자체	Release	상태	전달	결과

배포 결과 이력

지자체 Updater의 완료/실패/롤백 결과가 자동 기록됨. 비상 수동 작업이 있었던 경우에만 아래 이력 입력을 사용함.

시작	지자체	버전	상태	MSP/작업방식	작업자	변경번호	완료