> For the complete documentation index, see [llms.txt](https://docs.tibero.com/owldb-cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tibero.com/owldb-cloud/management/overview/instance.md).

# 인스턴스

**OwlDB**에서 운영 중인 인스턴스의 상태와 자원 사용량을 모니터링하고, 필요에 따라 인스턴스를 수정하거나 재시작할 수 있습니다. 인스턴스 상태가 `Available`이 아닌 경우, 일부 정보가 누락될 수 있습니다.

{% hint style="info" %}
**참고**

* 대시보드에서 다음 경로를 통해 인스턴스 관리 페이지로 이동할 수 있습니다.
  * **\[리스트뷰]** 데이터베이스 별칭 옆 화살표 아이콘 > 인스턴스 별칭 클릭
  * **\[카드뷰]** 데이터베이스 카드의 인스턴스 별칭 클릭
* AWS 환경에서는 Tibero 엔진만 지원합니다.
  {% endhint %}

## 인스턴스 목록 조회 <a href="#instance-list" id="instance-list"></a>

1. **관리 > Overview**로 이동합니다.
2. **인스턴스** 탭을 클릭합니다.
3. 목록에서 확인할 인스턴스의 상태와 자원 사용량을 확인합니다.

### Primary(Leader) DB 표시 항목

{% tabs %}
{% tab title="Tibero" %}

| 항목                 | 설명                                                           |
| ------------------ | ------------------------------------------------------------ |
| 별칭                 | 인스턴스 별칭 표시(클릭 시 상세 정보 페이지로 이동)                               |
| 생성일                | 인스턴스 생성 일시(`yyyy-mm-dd HH:mm:ss`)                            |
| AZ                 | 인스턴스가 배치된 가용 영역                                              |
| Health             | 인스턴스의 현재 상태(Available / In progress / Limited / Unavailable) |
| Open Mode          | DB의 운영 모드(READ WRITE)                                        |
| Replication Mode   | Primary DB의 동작 모드(PERFORMANCE)                               |
| CPU                | 프로비저닝된 vCPU 대비 사용량 바 차트                                      |
| Memory             | 프로비저닝된 메모리 대비 사용량 바 차트                                       |
| 활성 세션              | 활성화된 세션 수 바 차트                                               |
| Data Volume        | data 볼륨 사용량(90% 임계값 표시 포함)                                   |
| Redo log Volume    | redo log 볼륨 사용량                                              |
| Archive log Volume | archive log 볼륨 사용량                                           |
| Root Volume        | root 볼륨 사용량                                                  |
| Current Log        | 가장 최근 Redo log 식별값(Standby 구성 시에만 표시)                        |
| {% endtab %}       |                                                              |

{% tab title="OpenSQL" %}

| 항목            | 설명                                                           |
| ------------- | ------------------------------------------------------------ |
| 별칭            | 인스턴스 별칭 표시(클릭 시 상세 정보 페이지로 이동)                               |
| 생성일           | 인스턴스 생성 일시(`yyyy-mm-dd HH:mm:ss`)                            |
| AZ            | 인스턴스가 배치된 가용 영역                                              |
| Health        | 인스턴스의 현재 상태(Available / In progress / Limited / Unavailable) |
| Open Mode     | DB의 운영 모드(READ WRITE)                                        |
| CPU           | 프로비저닝된 vCPU 대비 사용량 바 차트                                      |
| Memory        | 프로비저닝된 메모리 대비 사용량 바 차트                                       |
| 활성 세션         | 활성화된 세션 수 바 차트                                               |
| Volume        | OpenSQL의 볼륨의 총합과 사용량                                         |
| Root Volume   | root 볼륨 사용량                                                  |
| Current Log   | 가장 최근 WAL log 식별값(LSN, HA 구성 시에만 표시)                         |
| {% endtab %}  |                                                              |
| {% endtabs %} |                                                              |

### Standby(Replica) DB 표시 항목

{% tabs %}
{% tab title="Tibero" %}

| 항목                   | 설명                                                                            |
| -------------------- | ----------------------------------------------------------------------------- |
| 별칭                   | 인스턴스 별칭 표시(클릭 시 상세 정보 페이지로 이동)                                                |
| 생성일                  | 인스턴스 생성 일시(`yyyy-mm-dd HH:mm:ss`)                                             |
| AZ                   | 인스턴스가 배치된 가용 영역                                                               |
| Health               | 인스턴스의 현재 상태(Available / In progress / Limited / Unavailable / Retired)        |
| Standby Status       | `v$standby` 조회 시 나오는 `status` 값 표시                                            |
| Open Mode            | DB의 운영 모드(MOUNTED / RECOVERY / READ WRITE / READ ONLY / READ ONLY WITH APPLY) |
| Log Replication Type | Standby의 복제 방식(LGWR ASYNC / ARCH ASYNC)                                       |
| CPU                  | 프로비저닝된 vCPU 대비 사용량 바 차트                                                       |
| Memory               | 프로비저닝된 메모리 대비 사용량 바 차트                                                        |
| 활성 세션                | 활성화된 세션 수 바 차트(Read Only 상태일 때만 표시)                                           |
| log last received    | Primary로부터 최근 수신한 Redo log 식별값(TSN 값)                                         |
| log last applied     | Standby에 최근 적용된 Redo log 식별값(TSN 값)                                           |
| Replication Lag(초)   | Primary DB와의 복제 지연 시간                                                         |
| {% endtab %}         |                                                                               |

{% tab title="OpenSQL" %}

| 항목                   | 설명                                                           |
| -------------------- | ------------------------------------------------------------ |
| 별칭                   | 인스턴스 별칭 표시(클릭 시 상세 정보 페이지로 이동)                               |
| 생성일                  | 인스턴스 생성 일시(`yyyy-mm-dd HH:mm:ss`)                            |
| AZ                   | 인스턴스가 배치된 가용 영역                                              |
| Health               | 인스턴스의 현재 상태(Available / In progress / Limited / Unavailable) |
| Open Mode            | DB의 운영 모드(READ ONLY)                                         |
| Log Replication Type | Replica의 복제 방식(ASYNC / SYNC)                                 |
| CPU                  | 프로비저닝된 vCPU 대비 사용량 바 차트                                      |
| Memory               | 프로비저닝된 메모리 대비 사용량 바 차트                                       |
| 활성 세션                | 활성화된 세션 수 바 차트(항상 표시)                                        |
| log last received    | Leader로부터 최근 수신한 WAL log 식별값(LSN 값)                          |
| log last applied     | Replica에 최근 적용된 WAL log 식별값(LSN 값)                           |
| Replication Lag(초)   | Leader DB와의 복제 지연 시간                                         |
| {% endtab %}         |                                                              |
| {% endtabs %}        |                                                              |

{% hint style="warning" %}
**주의**

인스턴스 상태가 `Available`이 아닌 경우, 화면 상단에 배너가 나타나 현재 상태에 대한 안내를 제공합니다.
{% endhint %}

## 인스턴스 상세 정보 조회 <a href="#instance-details" id="instance-details"></a>

<figure><img src="https://2566871117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgpIeVAAe6TUtfrjaD2G%2Fuploads%2FcadluR8y5jTXfJsqtlOL%2Fimage.png?alt=media&amp;token=76db0ca6-352f-4a47-814f-2ae432f46730" alt=""><figcaption><p>그림 1. 인스턴스 상세 정보</p></figcaption></figure>

인스턴스 목록에서 별칭을 클릭하면 해당 인스턴스의 상세 정보 페이지로 이동합니다. 상세 페이지는 상단 요약 정보, 가용성 및 복제 정보, 자원 사용 현황, 네트워크 정보, 데이터베이스 정보 순으로 구성됩니다.

1. Overview 페이지에서 **인스턴스** 탭을 클릭합니다.
2. 인스턴스 목록에서 상세 정보를 확인할 인스턴스의 별칭을 클릭합니다.
3. 상세 정보 페이지에서 상단 정보, 가용성 및 복제 정보, 자원 사용 정보, 네트워크 정보, 데이터베이스 정보를 확인합니다.

### 상단 정보

| 항목          | 설명                              | Primary/Leader                                  | Standby/Replica                                                                        |
| ----------- | ------------------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------- |
| Health      | 인스턴스 상태                         | Available / In progress / Limited / Unavailable | 공통(Tibero는 Retired 포함)                                                                 |
| 역할          | 인스턴스 역할                         | Tibero: Primary / OpenSQL: Leader               | Tibero: Standby(Recovery/Read Only) / OpenSQL: Replica                                 |
| 인스턴스 생성일    | 생성 일시(`yyyy-mm-dd HH:mm:ss`)    | 공통                                              | 공통                                                                                     |
| Open Mode   | DB 운영 모드                        | READ WRITE                                      | Tibero: MOUNTED/RECOVERY/READ WRITE/READ ONLY/READ ONLY WITH APPLY, OpenSQL: READ ONLY |
| 마지막 업데이트 일자 | 설정 변경 일시(`yyyy-mm-dd HH:mm:ss`) | 공통                                              | 공통                                                                                     |

### 가용성 및 복제 정보

Primary/Leader는 아래 항목을 표시하며, Standby/Replica는 동일 항목에 복제 관련 항목을 추가로 표시합니다.

{% tabs %}
{% tab title="Tibero" %}

| 항목                   | 설명                              | 표시 대상   |
| -------------------- | ------------------------------- | ------- |
| AZ                   | 배치된 가용 영역                       | 공통      |
| Replication Mode     | Primary DB의 동작 모드(PERFORMANCE)  | Primary |
| Current Log          | 최근 Redo log 식별값(TSN)            | 공통      |
| Standby Status       | Standby 복제 상태(노드별 상이 가능)        | Standby |
| Log Replication Type | 복제 방식(LGWR ASYNC / ARCH ASYNC)  | Standby |
| log last received    | Primary로부터 수신한 최근 Redo log(TSN) | Standby |
| log last applied     | Standby에 적용된 최근 Redo log(TSN)   | Standby |
| Replication Lag(초)   | Primary와의 복제 지연 시간              | Standby |
| {% endtab %}         |                                 |         |

{% tab title="OpenSQL" %}

| 항목                   | 설명                            | 표시 대상   |
| -------------------- | ----------------------------- | ------- |
| AZ                   | 배치된 가용 영역                     | 공통      |
| Current Log          | 최근 WAL log 식별값(LSN)           | 공통      |
| Log Replication Type | 복제 방식(ASYNC / SYNC)           | Standby |
| log last received    | Leader로부터 수신한 최근 WAL log(LSN) | Replica |
| log last applied     | Replica에 적용된 최근 WAL log(LSN)  | Replica |
| Replication Lag(초)   | Primary와의 복제 지연 시간            | Standby |
| {% endtab %}         |                               |         |
| {% endtabs %}        |                               |         |

### 자원 사용 정보

| 항목        | 설명                        | 비고                                                                                   |
| --------- | ------------------------- | ------------------------------------------------------------------------------------ |
| CPU       | 프로비저닝된 vCPU 대비 사용량(파이 차트) | 5초 주기 갱신                                                                             |
| Memory    | 프로비저닝된 메모리 대비 사용량(파이 차트)  | 5초 주기 갱신                                                                             |
| 최대 접속 세션수 | 활성 세션 수(라인 차트, 5초 주기 갱신)  | <ul><li>Tibero Standby: Read Only 상태일 때만 표시</li><li>OpenSQL Replica: 항상 표시</li></ul> |

### 네트워크 정보

| 항목        | 설명                      |
| --------- | ----------------------- |
| Host Name | 데이터베이스 서버가 실행 중인 호스트 이름 |
| End Point | 클라이언트 접속 주소(Private IP) |
| Port      | 데이터베이스 통신 포트 번호         |

### 데이터베이스 정보

{% hint style="info" %}
**참고**

데이터베이스 정보는 OpenSQL 엔진에서만 제공합니다.
{% endhint %}

| 항목          | 설명                                                                                |
| ----------- | --------------------------------------------------------------------------------- |
| Auto Vacuum | Auto Vacuum 사용 여부(On / Off)                                                       |
| 데이터베이스 목록   | 하위 데이터베이스를 이름, Data Size(GB), 활성 세션, Bloat Ratio(%), 생성일로 표시하며, 이름 클릭 시 상세 정보로 이동 |

활성 세션 값은 조회 중인 인스턴스가 Primary/Leader이면 Primary 노드 기준, Standby/Replica이면 Standby 노드 기준으로 표시됩니다.

{% hint style="warning" %}
**주의**

* Health가 `Available`이 아닌 경우 일부 정보가 누락되어 표시될 수 있습니다.
* Health가 `Retired`인 경우(Tibero의 Standby 인스턴스에서만 발생) Health를 제외한 모든 정보가 `-`로 표시되며, **재시작** 버튼 대신 **삭제** 버튼이 나타납니다.
  {% endhint %}
