장치 관리

장치 관리에서는 WaveDesk가 등록한 컴퓨터를 회사, 사용자, 상태와 네트워크 정보로 조회하고 장치별 Heartbeat, 접속 세션과 감사 이벤트를 확인합니다. 회사 주소록에 원격 접속 대상을 등록하는 작업도 이 화면에서 시작할 수 있습니다.

개요

장치는 클라이언트가 등록 정보를 전송하고 주기적으로 Heartbeat를 보내면 목록에 나타납니다. 화면에서 행을 선택하면 오른쪽 상세 영역에 장치 정보와 이력이 표시됩니다. 장치의 온라인 상태는 최근 Heartbeat와 서버의 TTL 정책으로 판단합니다.

검색과 필터

여러 조건을 함께 입력하면 모든 조건에 맞는 장치만 표시됩니다. 결과가 없으면 상태 필터를 전체로 바꾸고 검색어의 공백과 철자를 확인합니다.

장치 목록

목록에는 상태, 장치명, 장치 ID, 사용자, 회사, 운영체제, 클라이언트 버전, IP와 마지막 Heartbeat가 표시됩니다. 열 제목을 눌러 정렬하거나 열 필터를 사용할 수 있습니다. 한 행을 선택하면 이벤트와 세션 버튼이 활성화됩니다.

장치 상세 확인

선택한 장치의 상세 영역에서는 다음 정보를 확인합니다.

• 장치 ID와 표시 이름
• 회사와 연결 사용자
• 운영체제와 WaveDesk 버전
• 현재 Presence 상태와 마지막 Heartbeat
• 마지막 확인 IP와 네트워크 스냅샷
• 최근 접속 세션과 감사 이벤트

장치 이름이나 사용자만으로 판단하지 말고 장치 ID를 기준으로 같은 장치의 이력을 연결합니다.

온라인 상태 판단

컴퓨터가 절전 모드이거나 네트워크가 잠깐 끊긴 경우에도 오프라인으로 표시될 수 있습니다. 장치가 다시 Heartbeat를 보내면 온라인으로 복구됩니다.

이벤트와 세션 열기

장치를 선택한 뒤 이벤트를 누르면 해당 장치가 포함된 감사 로그로, 세션을 누르면 접속 세션 목록으로 이동합니다. 실패 원인을 조사할 때에는 같은 시간대의 세션 상태와 이벤트의 연결 ID를 비교합니다.

회사 주소록 등록

관리 대상 장치를 회사 주소록에 추가하려면 장치를 선택하고 주소록 등록을 누릅니다. tenant, 원격 ID, 표시 이름, 호스트와 그룹을 확인한 뒤 저장합니다. 주소록 등록만으로 모든 사용자가 연결할 수 있는 것은 아니며, 사용자 직접 권한 또는 접근 역할에 장치를 배정해야 합니다.

버전과 네트워크 이력

낮은 클라이언트 버전은 문제 장치로 표시될 수 있습니다. 업데이트 전에는 운영체제 지원 여부와 현장 작업 시간을 확인합니다. IP가 자주 바뀌는 장치는 네트워크 스냅샷에서 시간대별 주소를 비교하고, NAT나 VPN 사용 여부를 함께 확인합니다.

장치가 나타나지 않을 때

1. 클라이언트에서 WaveDesk 서비스가 실행 중인지 확인합니다.
2. 장치 등록 API와 Heartbeat API 주소가 올바른지 확인합니다.
3. Agent Key가 서버와 클라이언트에 동일하게 구성됐는지 확인합니다.
4. 회사/tenant와 상태 필터를 해제하고 다시 검색합니다.
5. API 상태 화면에서 DB와 최근 수집 시각을 확인합니다.

운영 시 주의

장치 목록의 IP와 호스트 정보는 운영 정보이므로 필요한 관리자에게만 제공합니다. 화면에서 항목을 숨기는 것만으로 접근을 제한하지 말고 Admin API에서도 권한을 확인합니다. 퇴역 장치는 주소록과 접근 역할에서 먼저 제외한 뒤 보존 정책에 따라 이력을 관리합니다.