관리 대시보드

마지막 게시: 2026-07-21 19:00

관리 대시보드

WaveDesk Admin Console 대시보드는 전체 장치와 접속 상태, 최근 실패와 관리 API 상태를 한 화면에서 확인하는 운영 시작점입니다. 장애 징후를 찾은 뒤 장치, 세션 또는 감사 로그 화면으로 이동해 원인을 확인합니다.

개요

대시보드를 열면 마지막 수집 시각을 기준으로 장치와 세션 현황이 표시됩니다. 데이터가 오래됐으면 먼저 새로 고침하고, API 상태와 DB 연결이 정상인지 확인한 뒤 수치를 판단합니다.

요약 정보

항목	의미	확인이 필요한 경우
온라인 장치	Heartbeat가 유효한 장치 수	예상보다 급격히 감소했을 때
오프라인 장치	Heartbeat 유효시간을 지난 장치 수	현장 장치가 장시간 복구되지 않을 때
최근 접속 시도	최근 원격 연결 요청 수	평소보다 비정상적으로 많을 때
실패	실패로 기록된 연결·이벤트 수	반복 실패나 특정 장치 집중 여부 확인
로그인 세션	현재 기록된 클라이언트 로그인 세션 수	만료·취소 세션이 계속 남을 때
Connection Grants	발급된 기업 접속 Grant 수	권한 거부 또는 비정상 발급이 의심될 때

최근 이벤트 확인

최근 이벤트 10건에는 서버가 수집한 최신 감사 이벤트가 시간순으로 표시됩니다. 항목을 누르면 관련 장치의 상세 화면으로 이동할 수 있습니다. 실패 이벤트는 이벤트 유형, 장치 ID, 사용자와 기록 시각을 함께 확인합니다.

같은 이벤트가 짧은 시간에 반복되면 클라이언트 재시도인지 실제 여러 작업인지 세션 ID와 연결 ID로 구분합니다.

문제 장치 확인

최근 문제 장치에는 오프라인, Heartbeat 만료 임박 또는 낮은 클라이언트 버전으로 판단된 장치가 표시됩니다. 장치 이름을 누르면 현재 상태, 마지막 Heartbeat, 네트워크 이력과 최근 세션을 확인할 수 있습니다.

오프라인 장치가 한 회사나 네트워크 대역에 집중되면 개별 PC보다 현장 네트워크, Relay 연결과 방화벽을 먼저 확인합니다.

API 상태

상태	정상 기준
`/health`	`OK`
DB 연결	`OK`
Heartbeat TTL	운영 정책에 설정된 초 단위 값
Offline Scan	오프라인 판정 작업의 실행 간격
Agent Key	장치 등록·Heartbeat 수집 환경에서 구성됨

/health 또는 DB가 실패하면 대시보드의 다른 수치도 최신 상태가 아닐 수 있습니다. Heartbeat TTL이 지나치게 짧으면 일시적인 네트워크 지연도 오프라인으로 표시되고, 지나치게 길면 실제 장애 확인이 늦어집니다.

새로 고침

상단 새로 고침을 누르면 장치, Presence, 세션, 감사 이벤트, 회사, 라이선스와 기업 접근 데이터가 다시 조회됩니다. 로딩 중에는 반복해서 누르지 않습니다. 마지막 수집 시각이 바뀌지 않으면 API 상태와 서버 로그를 확인합니다.

운영 점검 순서

마지막 수집 시각과 API·DB 상태를 확인합니다.
온라인·오프라인 장치 수의 급격한 변화를 확인합니다.
최근 문제 장치에서 영향 범위를 파악합니다.
실패 수치가 있으면 최근 이벤트와 세션 화면에서 이유를 확인합니다.
권한 관련 실패는 기업 접근 정책과 Connection Grant를 확인합니다.

수치 해석 시 주의

대시보드의 수치는 현재 필터가 아니라 전체 수집 데이터의 요약일 수 있습니다. 장치가 오프라인이라고 해서 프로그램이 삭제된 것은 아니며, 최근 Heartbeat가 TTL을 지난 상태를 뜻합니다. 로그인 세션과 원격 연결 세션도 서로 다른 기록이므로 같은 수치로 비교하지 않습니다.

문제가 있을 때

모든 수치가 비어 있으면 DB 연결과 최근 수집 시각을 확인합니다.
온라인 장치가 모두 오프라인으로 바뀌면 Agent Key, API 주소와 네트워크를 확인합니다.
특정 사용자만 접속하지 못하면 사용자 활성 상태, 접근 역할과 Grant 실패 사유를 확인합니다.
화면 수치와 현장 상태가 다르면 새로 고침 후 장치의 마지막 Heartbeat 시각을 비교합니다.

수정 이력

이 문서의 변경 내역을 시간순으로 볼 수 있습니다.

표시할 수정 이력이 없습니다.