> For the complete documentation index, see [llms.txt](https://docs.tibero.com/sysmasterdb/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/sysmasterdb/8.4_manual/analysis/report/tpr-report/create-report.md).

# Create Report

**\[TPR Report] 페이지**에서 Create Report 버튼을 통해 특정 인스턴스에 대한 TPR Report를 생성할 수 있다.

Create Report 버튼 클릭 시 인스턴스 선택 창이 노출되며, 인스턴스 선택 시 TPR Report Create 화면이 표시된다.

<figure><img src="https://content.gitbook.com/content/gw24XwSa6QXLFywb7Txd/blobs/ndEnnq7CE9djfZZkke1S/image.png" alt=""><figcaption><p>Create Report 클릭 시</p></figcaption></figure>

만약 파라미터에 TPR Report를 생성할 수 있는 Snapshot과 Baseline이 없을 경우 리포트 생성이 불가능하다는 안내 메세지가 출력된다.

<figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2FNYfDNNv6ImY3fusdy2oG%2F239_unavailable.png?alt=media" alt=""><figcaption><p>Report Creation Unavailable</p></figcaption></figure>

TPR Report 페이지의 Create Report는 2단계에 걸쳐 진행된다.

### 1**단계) 리포트 이름과 파라미터를 설정한다.**

<figure><img src="https://content.gitbook.com/content/gw24XwSa6QXLFywb7Txd/blobs/53iaD6VBlBbmESCtD8b2/image.png" alt=""><figcaption><p>Step 1</p></figcaption></figure>

* Report Name은 기본값이 제공되며(\[Instance Alias]\_TPR\_\[Created Time]) 사용자가 1\~40자로 변경하여 사용할 수 있다. 파일명에 쓸 수 없는 문자(\ / : \* ? " < > |)는 입력할 수 없다.
* Parameters는 By Snapshot과 By Baseline 중 하나를 선택할 수 있다. 해당 인스턴스에 Snapshot이나 Baseline이 없으면 그 항목은 비활성화된다.
  * By Snapshot 선택 시 Created by에서 Snapshot ID, Snapshot Global ID, Datetime 중 하나를 선택하여 TPR 리포트를 생성할 수 있다.
  * By Baseline 선택 시 상세 설정 없이 다음 단계로 진행한다.

### 2**단계) 추출 방식에 따라 2단계에서 설정할 하위 항목이 달라진다.**

#### 1. Snapshot - Snapshot ID 선택 시

특정 Snapshot ID 하나를 선택하거나, 특정 Snapshot 구간을 선택하여 TPR Report를 생성한다. Snapshot ID Option과 Specific Snapshot Settings는 서로 배타적으로 동작한다. (Specific Snapshot Settings 옵션 설정 시 Snapshot ID Option은 비활성화 된다.)

<figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2FEVMl0kNy1joY8wp7sDTx%2F241_step2-snapshot-id.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Snapshot ID Option**
  * 하나의 스냅샷으로 TPR Report를 생성하는 기능이다.

<figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2FTQAMV7jyu55qm0HMuHmi%2F242_snapshot-id-list.png?alt=media" alt=""><figcaption></figcaption></figure>

* 드롭다운으로 스냅샷 리스트를 제공하며 스냅샷 리스트에서는 Snapshot ID, Instance 이름, 해당 Snapshot의 시간대 정보가 제공된다.
* Snapshot ID와 기간을 선택하여 검색할 수 있으며, 사용자는 스냅샷 리스트 중 하나의 항목만 선택 가능하다. Snapshot ID 검색창에는 숫자만 입력할 수 있고, 검색 기간에는 데이터 보존 기간 제한이 적용되지 않는다.
* **Specific Snapshot Settings**

  * 구간을 선택하여 TPR Report를 생성하는 기능이다.

  <figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2F9xjvCzOnI69FBg3e1FRH%2F243_begin-snapshot.png?alt=media" alt=""><figcaption></figcaption></figure>

  * Begin Snapshot, End Snapshot을 하나씩 선택하여 해당 구간내의 스냅샷으로 TPR Report가 생성된다.

  <figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2F3g111BjuE8nY7Aqssjy3%2F244_end-snapshot.png?alt=media" alt=""><figcaption></figcaption></figure>

  * &#x20;스냅샷 선택 시 노출되는 리스트는 Snapshot ID와 동일하다.
  * Instance 선택 드롭다운에서 하나의 항목을 선택할 수 있으며 드롭다운 항목으로는 All Instances in this cluster(클러스터 내 모든 인스턴스), 클러스터 내 인스턴스 중 SysMasterDB에 등록된 인스턴스명만 노출된다.
  * Instance 선택 시 스냅샷 리스트에서도 선택한 인스턴스에 해당하는 항목만 표시된다.
* **Report Settings**
  * Report type 설정이 가능하다.
  * 스냅샷으로 추출할 경우 HTML과 TXT 두 개의 형식을 지원한다.

#### 2. Snapshot - Snapshot Global ID 선택 시

기 생성된 GID로 TPR Report를 생성한다. Snapshot Global ID Option과 Specific Snapshot Global ID Settings는 서로 배타적으로 동작한다. (Specific Snapshot Global ID Settings 옵션 설정 시 Snapshot Global ID Option은 비활성화 된다.)

<figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2FpLg9fWyh4ki5bodXa3kW%2F245_step2-gid.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Snapshot Global ID Option**
  * 하나의 Global 스냅샷으로 TPR Report를 생성하는 기능이다.
  * 드롭다운으로 스냅샷 리스트를 제공하며 스냅샷 리스트에서는 Snapshot GID, Instance 이름, 해당 Snapshot의 시간대 정보가 제공된다.
  * Snapshot GID와 기간을 선택하여 검색할 수 있으며, 사용자는 스냅샷 리스트 중 하나의 항목만 선택 가능하다.
* **Specific Snapshot Global ID Settings**
  * GID 구간을 선택하여 TPR Report를 생성하는 기능이다.
  * Begin Snapshot Global ID, End Snapshot Global ID를 하나씩 선택하여 해당 구간 내의 스냅샷으로 TPR Report가 생성된다.
  * 스냅샷 선택 시 노출되는 리스트는 Snapshot Global ID 옵션과 동일하다.
* **Report Settings**
  * Report type 설정이 가능하다.
  * 스냅샷으로 추출할 경우 HTML과 TXT 두 개의 형식을 지원한다.

#### 3. Snapshot - Datetime 선택 시

사용자가 원하는 시간대의 스냅샷을 선택하여 TPR Report를 생성한다. Datetime Option과 Specific Datetime Settings 옵션은 상호 연관되어 동작한다. (Specific Datetime Settings 옵션 설정 위해서는 Datetime Option 설정이 필수적이다)

<figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2FflJnAtKAbtSpwAky9PU3%2F246_step2-datetime.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Datetime Option**
  * TPR Report 생성을 위해 Snapshot의 시간대를 설정하는 옵션이다.
  * Begin Time과 End Time은 각각 드롭다운의 스냅샷 리스트에서 스냅샷을 선택하여 설정하며, Begin Time에는 선택한 스냅샷의 Begin Time이, End Time에는 선택한 스냅샷의 End Time이 적용된다.
    * End Time의 기본값은 최근 Snapshot의 End Time값으로 설정되고, Begin Time의 기본값은 End Time 기본값 기준 24시간 이전 시각으로 설정된다.
  * Instance 선택은 Specific Snapshot Settings의 Instance 선택과 동일하다.
* **Specific Datetime Settings**

  * Datetime Option에서 선택한 시간대 중 특정한 날짜나 시간대를 설정하여 TPR을 생성하는 기능이다.&#x20;
  * On/Off 토글로 켜고 끌 수 있으며, 해당 옵션이 켜질 경우 상세 시간대를 설정할 수 있다. 요일(Specific Days)은 기본적으로 모두 선택되어 있다.
  * 만약 Datetime Option에서 2025/1/1 - 2025/1/31로 설정하고, Specific Datetime Settings에서 Mon,  Tue, Wed, 09:00-18:00을 설정할 경우 2025/1/1 - 2025/1/31 중 월, 화, 수요일의 09:00-18:00 시간대의 스냅샷으로 TPR이 생성된다.

  <figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2FLHqfL9IupXSRspylwkrx%2F247_specific-datetime.png?alt=media" alt=""><figcaption></figcaption></figure>

  * Specific Days로 원하는 날짜를 선택할 수 있으며 Begin Time, End Time으로 원하는 시간대를 설정할 수 있다. 단 Specific Datetime Settings의 Begin/End Time에서는 시간대(24시간 기준, 시, 분 단위까지 설정 가능, 초 단위 설정 불가)만 설정 가능하다.
* **Report Settings**
  * Report type 설정이 가능하다.
  * 스냅샷으로 추출할 경우 HTML과 TXT 두 개의 형식을 지원한다.

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

Specific Datetime Settings를 켠 상태에서 지정한 요일·시간대에 해당하는 스냅샷이 없으면 \
\
Report Creation Unavailable\
No snapshot exists for this instance to create a report.
\
Please modify the settings or turn off \[Specific Datetime Settings].\
\
위와 같은 알림이 발생한다.
{% endhint %}

#### 4. Baseline 선택 시

<figure><img src="https://content.gitbook.com/content/gw24XwSa6QXLFywb7Txd/blobs/PBILnqi91CGA87uAEgwd/image.png" alt=""><figcaption><p>Step 1) By Baseline</p></figcaption></figure>

<figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2FLRIk7Kdg0rY8S0PuDBnw%2F249_step2-baseline.png?alt=media" alt=""><figcaption><p>Step 2) Choose Baseline</p></figcaption></figure>

기 생성된 베이스라인중 하나를 선택하여 TPR Report를 생성한다. 베이스라인 리스트에서는 Baseline ID, Baseline Name을 표시하며, 검색 기능을 제공한다 베이스라인으로 추출할 경우 TXT 형식만 지원한다.

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

리포트 생성 중에는 리포트 목록 테이블의 Begin Time·End Time 컬럼에 하이픈(-)이 표시된다.
{% endhint %}