> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/agent/management.md).

# 에이전트 관리하기

## 심플리에 등록된 기기와 에이전트가 설치된 기기 연결하기

등록된 기기와 설치된 기기는 기본적으로 기기의 일련 번호를 기준으로 자동 연결됩니다. 몇 가지 경우에 의해 자동 연결이 되지 않는 경우가 있습니다.

<figure><img src="/files/t20guPyVKAlpeoxUcwWW" alt="설정 > 에이전트 관리"><figcaption><p>설정 > 에이전트 관리</p></figcaption></figure>

#### 에이전트 상태

에이전트는 다음 상태 중 하나를 가집니다.

| 상태        | 설명                      | 표시  |
| --------- | ----------------------- | --- |
| **연결됨**   | 기기와 정상적으로 연결되어 데이터 수집 중 | 녹색  |
| **연결 대기** | 에이전트가 설치되었으나 기기와 미연결    | 주황색 |
| **오프라인**  | 일정 기간 데이터 전송 없음         | 회색  |
| **삭제됨**   | 에이전트가 삭제되어 비활성화         | -   |

{% hint style="info" %}
**오프라인 상태** 기기가 꺼져 있거나 네트워크에 연결되지 않으면 오프라인으로 표시됩니다. 기기가 다시 연결되면 자동으로 상태가 업데이트됩니다.
{% endhint %}

***

#### 기기 연결

에이전트가 설치된 기기는 일련번호(Serial Number)를 기준으로 자동 연결됩니다.

**시나리오 1: 기존 등록 기기에 연결**

이미 SMPLY에 등록된 기기에 에이전트를 설치한 경우:

**단계 1: 자동 연결 확인**

1. 에이전트 설치 후, **기기 > 목록**에서 해당 기기를 확인합니다.
2. 일련번호가 일치하면 자동으로 연결됩니다.

**단계 2: 수동 연결 (일련번호 없는 경우)**

1. 기존 기기 정보에 일련번호가 없는 기기는 자동 연결되지 않습니다.
2. **에이전트 > 관리**에서 연결 대기 중인 에이전트를 찾습니다.
3. **기기 연결** 버튼을 클릭합니다.
4. 연결할 기기를 선택합니다.

**시나리오 2: 신규 기기 등록과 함께 연결**

SMPLY에 등록되지 않은 기기에 에이전트를 설치한 경우:

**단계 1: 에이전트 확인**

1. **에이전트 > 관리**에서 연결 대기 중인 에이전트를 확인합니다.

**단계 2: 기기 등록 및 연결**

1. 해당 에이전트의 **기기 등록** 버튼을 클릭합니다.
2. 기기 정보를 입력합니다.
3. 저장하면 자동으로 에이전트와 연결됩니다.

{% hint style="warning" %}
**일련번호 없는 기기** 조립 PC 등 일련번호가 없는 기기는 SMPLY에서 임의로 시리얼키가 생성되고 해당 키를 이용하여 연결됩니다.
{% endhint %}

***

#### 에이전트 삭제

퇴사자 기기나 더 이상 사용하지 않는 기기의 에이전트를 삭제할 수 있습니다.

**단계 1: 에이전트 선택**

1. **에이전트 > 관리**로 이동합니다.
2. 삭제할 에이전트를 찾습니다.

**단계 2: 삭제 실행**

1. 에이전트 우측의 **삭제** 버튼을 클릭합니다.
2. 확인 대화상자에서 **삭제**를 클릭합니다.

{% hint style="danger" %}
**삭제 시 영향**

* 에이전트가 삭제되면 해당 기기에서 구성원이 즉시 로그아웃됩니다.
* 더 이상 데이터가 수집되지 않습니다.
* 삭제된 에이전트는 복구할 수 없습니다.
  {% endhint %}

***

#### 문제 해결

**에이전트가 연결 대기 상태로 유지됩니다**

**원인 1: 일련번호 불일치**

* 기기에 등록된 일련번호와 에이전트가 감지한 일련번호가 다를 수 있습니다.
* 기기 정보에서 일련번호를 확인하고 수정하세요.

**원인 2: 중복 기기**

* 동일한 일련번호의 기기가 여러 개 등록되어 있을 수 있습니다.
* 중복 기기를 정리한 후 다시 시도하세요.

**에이전트가 오프라인으로 표시됩니다**

**원인 1: 기기 전원 꺼짐**

* 기기가 꺼져 있거나 절전 모드일 수 있습니다.

**원인 2: 네트워크 문제**

* 기기가 인터넷에 연결되어 있는지 확인하세요.
* 방화벽에서 에이전트 통신이 차단되지 않았는지 확인하세요.

**원인 3: 에이전트 프로세스 중단**

* 에이전트 프로세스가 비정상 종료되었을 수 있습니다.
* 기기를 재시작하거나 에이전트를 재설치하세요.

**에이전트 삭제 후에도 데이터가 수집됩니다**

**원인: 기기에 에이전트가 남아있음**

* SMPLY에서 삭제해도 기기의 에이전트는 자동 삭제되지 않습니다.
* 기기에서 에이전트를 직접 제거하세요.

***

#### 자주 묻는 질문

**Q: 하나의 기기에 여러 에이전트를 설치할 수 있나요?**

아니요, 하나의 기기에는 하나의 에이전트만 설치할 수 있습니다. 중복 설치 시 충돌이 발생할 수 있습니다.

**Q: 에이전트를 삭제하면 수집된 데이터도 삭제되나요?**

아니요, 이미 수집된 소프트웨어 사용 데이터는 유지됩니다. 에이전트 삭제 후에는 새로운 데이터만 수집되지 않습니다.

**Q: 에이전트 버전을 업데이트하려면 어떻게 하나요?**

에이전트는 자동 업데이트를 지원합니다. 네트워크에 연결되어 있으면 새 버전이 자동으로 설치됩니다.

**Q: Windows에서 에이전트가 자동으로 실행되나요?**

예. Windows에서 에이전트를 설치하면 \*\*Windows 작업 스케줄러(Scheduled Task)\*\*에 자동으로 등록됩니다. 이를 통해 시스템 시작 시 또는 일정 주기로 에이전트가 자동 실행되어 데이터를 수집합니다.

**Q: 에이전트가 수집하는 데이터는 무엇인가요?**

설치된 소프트웨어 목록, 소프트웨어 사용 시간, 기기 기본 정보(운영체제, 하드웨어 스펙 등)를 수집합니다. 파일 내용이나 개인 데이터는 수집하지 않습니다.

수집 항목과 수집하지 않는 항목, 관리자에게 표시되는 형태는 [에이전트 수집 정보](/agent/agent-data.md)에서 자세히 확인할 수 있습니다.

**Q: 이 외의 문제**

채널톡으로 문의해 주세요.