# Instance 등록하기

### Import Instance 진입 경로

로그인 후 첫 화면인 Dashboard에서 import 버튼을 클릭하면 instance를 등록할 수 있다.

<figure><img src="/files/nb4tRmd4M5d6wQWt4ord" alt=""><figcaption></figcaption></figure>

### Import Instance 페이지

모니터링을 위한 인스턴스 연결 테스트 및 등록을 수행할 수 있으며, 현재 서비스에 적용된 라이선스 정보를 상단 License Info 영역을 통해 참고할 수 있다.

<div data-with-frame="true"><figure><img src="/files/afw70nGu9BYXvPsNInCN" alt=""><figcaption></figcaption></figure></div>

| 항목             | 설명                              |
| -------------- | ------------------------------- |
| Instance Name  | 인스턴스 이름 (카드에 표시되는 정보)           |
| Instance Color | 인스턴스 고유 색상 (차트에 그려지는 색상)        |
| IP Address     | 관제 대상 DB의 접속 IP                 |
| Port           | 관제 대상 DB의 접속 포트 번호              |
| DB Name        | 관제 대상 DB의 DB Name               |
| User ID        | 관제 대상 DB의 SUPERUSER 권한사용자 이름    |
| Password       | 관제 대상 DB의 SUPERUSER 권한 사용자 패스워드 |
| Agent ID       | 관제 대상 인스턴스에 설치한 Agent ID        |

{% hint style="warning" %}
인스턴스 **등록 시 입력하는 Agent ID**와 **Agent의 설정 파일에 있는 ID**는 **동일**해야 하며, **해당 Agent**가 SysMasterDB 서버에 연결하기 위해 **정상적으로 기동**되어 있어야 인스턴스 등록이 가능하다.
{% endhint %}

새로 등록한 instance는 바로 화면에 반영되지 않고, 그룹에 instance를 할당한 후에 Dashboard에서 관제가 가능하다.

모니터링 인스턴스를 최초로 구성할 때 대상 DB에 모니터링 전용 계정과 전용 DB를 생성해야 하므로 슈퍼유저(관리자) 계정 정보가 필요합니다. 입력된 슈퍼유저 권한으로 대상 DB에 모니터링 전용 계정(ID: sysmaster\_db)을 생성한 뒤, 이후 모니터링은 해당 전용 계정(sysmaster\_db)으로만 접속하여 수행합니다. 만약 동일한 사용자/DB가 이미 존재하면 생성은 건너뛰고 비밀번호를 갱신하여 사용합니다. 생성 작업에 사용된 슈퍼유저 계정 정보는 저장하지 않습니다.

{% hint style="info" %}
PostgreSQL 재설치(initdb 등) 시 기존 sysmaster\_db가 삭제되어 모니터링 DB가 Down 상태가 되며, 현재 구조상 인스턴스를 재등록해야만 sysmaster\_db가 재생성되어 모니터링이 가능하다.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tibero.com/sysmasterdb-for-postgresql1.0/8.3_manual/sysmasterdb/import-instance.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.