

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Timestream for InfluxDB의 다중 AZ 읽기 전용 복제본 클러스터 사용
<a name="timestream-for-influx-working-read-replica"></a>

읽기 전용 복제본 클러스터 배포는 프라이머리 DB 인스턴스에 연결된 읽기 전용 복제본을 구성할 수 있는 Amazon Timestream for InfluxDB의 비동기식 배포 모드입니다. 읽기 전용 복제본 클러스터에는 동일한 AWS 리전내의 별도 가용 영역에 라이터 DB 인스턴스와 리더 DB 인스턴스가 있습니다. 읽기 전용 복제본 클러스터는 다중 AZ DB 인스턴스 배포와 비교했을 때 높은 가용성과 읽기 워크로드에 대한 증가된 용량을 제공합니다.

## 읽기 전용 복제본 클러스터의 인스턴스 클래스 가용성
<a name="timestream-for-influx-instance-class-rr"></a>

읽기 전용 복제본 클러스터 배포는 일반 Timestream for InfluxDB 인스턴스와 동일한 인스턴스 유형에서 지원됩니다.


****  

| 인스턴스 클래스 | vCPU | 메모리(GiB) | 스토리지 유형 | 네트워크 대역폭(Gbps) | 
| --- | --- | --- | --- | --- | 
| db.influx.medium | 1 | 8 | Influx IOPS 포함 | 10 | 
| db.influx.large | 2 | 16 | Influx IOPS 포함 | 10 | 
| db.influx.xlarge | 4 | 32 | Influx IOPS 포함 | 10 | 
| db.influx.2xlarge | 8 | 64 | Influx IOPS 포함 | 10 | 
| db.influx.4xlarge | 16 | 128 | Influx IOPS 포함 | 10 | 
| db.influx.8xlarge | 32 | 256 | Influx IOPS 포함 | 12 | 
| db.influx.12xlarge | 48 | 384 | Influx IOPS 포함 | 20 | 
| db.influx.16xlarge | 64 | 512 | Influx IOPS 포함 | 25 | 
| db.influx.24xlarge | 96 | 768 | Influx IOPS 포함 | 40 | 

## 읽기 전용 복제본 클러스터 아키텍처
<a name="timestream-for-influx-rr-cluster-architecture"></a>

읽기 전용 복제본 클러스터를 사용하면 Amazon Timestream for InfluxDB는 InfluxData의 라이선스가 부여된 읽기 전용 복제본 추가 기능을 통해 라이터 DB 인스턴스에 대한 모든 쓰기를 모든 리더 DB 인스턴스에 자동으로 복제합니다. 이 복제는 비동기식이며 모든 쓰기는 라이터 노드에서 커밋되자마자 확인됩니다. 쓰기는 성공적인 쓰기로 간주되기 위해 모든 리더 노드의 확인을 필요로 하지 않습니다. 데이터가 라이터 DB 인스턴스에서 커밋되면 거의 즉시 읽기 전용 복제본 인스턴스에 복제됩니다. 복구할 수 없는 라이터 장애가 발생하는 경우 최소한 하나의 리더로 복제되지 않은 데이터는 모두 손실됩니다.

읽기 전용 복제본 인스턴스는 라이터 DB 인스턴스의 읽기 전용 사본입니다. 애플리케이션에서 읽기 전용 복제본으로 일부 또는 모든 쿼리를 라우팅하여 라이터 DB 인스턴스의 로드를 줄일 수 있습니다. 이렇게 하면 읽기 중심의 데이터베이스 워크로드에 대한 단일 DB 인스턴스의 용량 제한에서 벗어나 탄력적으로 스케일 아웃할 수 있습니다.

다음 다이어그램은 다른 가용 영역의 읽기 전용 복제본으로 복제되는 프라이머리 DB 인스턴스를 보여줍니다. 클라이언트는 기본 DB 인스턴스에 대한 읽기/쓰기 액세스 권한과 복제본에 대한 읽기 전용 액세스 권한을 가집니다.

![\[가용 영역 A의 프라이머리 DB 인스턴스는 가용 영역 C의 읽기 전용 복제본 인스턴스에 비동기식으로 복제됩니다.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/rr_azs_diagram.png)


## 읽기 전용 복제본 클러스터의 파라미터 그룹
<a name="timestream-for-influx-rr-param-groups"></a>

읽기 전용 복제본 클러스터에서 *DB 파라미터 그룹*은 읽기 전용 복제본 클러스터의 모든 DB 인스턴스에 적용되는 엔진 구성 값의 컨테이너 역할을 합니다. 기본 DB 파라미터 그룹은 DB 엔진과 DB 엔진 버전에 따라 설정됩니다. DB 파라미터 그룹의 설정은 클러스터의 모든 DB 인스턴스에 사용됩니다.

다중 AZ DB 읽기 전용 복제본에 대해 [CreateDbCluster](https://docs.aws.amazon.com/ts-influxdb/latest/ts-influxdb-api/API_CreateDbCluster.html)나 [UpdateDbCluster](https://docs.aws.amazon.com/ts-influxdb/latest/ts-influxdb-api/API_UpdateDbCluster.html)를 사용하여 특정 DB 매개변수 그룹을 전달할 때는 `storage-wal-max-write-delay`가 최소 1시간으로 설정되어 있는지 확인합니다. DB 파라미터 그룹이 지정되지 않으면 `storage-wal-max-write-delay`는 기본적으로 1시간으로 설정됩니다.

## 읽기 전용 복제본 클러스터의 복제 지연
<a name="timestream-for-influx-replica-lag"></a>

다중 Timestream for InfluxDB 읽기 전용 복제본 클러스터는 높은 쓰기 성능을 허용하지만 엔진 기반 비동기식 복제의 특성으로 인해 복제본 지연이 계속 발생할 수 있습니다. 이러한 지연은 장애 조치 시 잠재적인 데이터 손실로 이어질 수 있으므로 모니터링이 필수적입니다.

 AWS Management Console 탐색 창에서 **모든 지표**를 선택하여 CloudWatch에서 복제본 지연을 추적할 수 있습니다. **Timestream/InfluxDB**를 선택한 다음 **By DbCluster**를 선택합니다. **DbClusterName**을 선택한 다음 **DbReaderInstanceName**을 선택합니다. 여기에는 모든 Timestream for InfluxDB 인스턴스에 대해 추적되는 일반적인 지표 세트(아래 목록 참조) 외에도 ReplicaLag가 밀리초 단위로 표시됩니다.
+ CPUUtilization
+ MemoryUtilization
+ DiskUtilization
+ ReplicaLag(복제본 인스턴스 모드 DB 인스턴스에만 해당)

### 복제본 지연의 일반적인 원인
<a name="timestream-for-influx-lag-causes"></a>

일반적으로 복제본 지연은 쓰기 및 읽기 워크로드가 너무 높아 리더 DB 인스턴스가 트랜잭션을 효율적으로 적용할 수 없을 때 발생합니다. 다양한 워크로드로 인해 일시적 또는 지속적인 복제본 지연이 발생할 수 있습니다. 다음은 몇 가지 일반적인 원인의 예입니다.
+ 라이터 DB 인스턴스의 높은 쓰기 동시성 또는 대량 일괄 업데이트로 인해 리더 DB 인스턴스의 적용 프로세스가 뒤쳐집니다.
+ 하나 이상의 리더 DB 인스턴스의 리소스를 사용하는 대량 읽기 워크로드입니다. 느리거나 큰 쿼리를 실행하면 적용 프로세스에 영향이 있고 복제본 지연이 발생할 수 있습니다.
+ 데이터베이스가 커밋 순서를 유지해야 하기 때문에 대량의 데이터 또는 DDL 문을 수정하는 트랜잭션으로 인해 복제본 지연 시간이 일시적으로 증가하는 경우가 있습니다.

복제본 지연이 설정된 시간을 초과할 때 CloudWatch 경보를 생성하는 방법을 보여주는 자습서는 [자습서: Amazon Timestream for InfluxDB에 대한 다중 AZ 클러스터 복제본 지연에 대한 Amazon CloudWatch 경보 생성](timestream-for-influx-creating-cw-alarms.md#timestream-for-influx-tutorial-alarm) 섹션을 참조하세요.

### 복제본 지연 완화
<a name="timestream-for-influx-mitigating-lag"></a>

Timestream for InfluxDB 읽기 전용 복제본 클러스터의 경우 라이터 DB 인스턴스의 로드를 줄여 복제 지연을 완화할 수 있습니다.

## 가용성과 내구성
<a name="timestream-for-influx-availability"></a>

라이터 장애 발생 시 자동으로 읽기 인스턴스 중 하나로 장애 조치하여 쓰기 가용성을 우선시하도록 구성하거나, 장애 조치를 피하여 팁 데이터 손실을 최소화하도록 읽기 전용 복제본 클러스터를 구성할 수 있습니다. 팁 데이터는 리더 노드 중 하나 이상에 아직 복제되지 않은 데이터의 복제 지연을 나타냅니다([읽기 전용 복제본 클러스터의 복제 지연](#timestream-for-influx-replica-lag) 참조). 읽기 전용 복제본 클러스터의 기본 및 권장 동작은 작성자 장애 발생 시 자동으로 장애 조치하는 것입니다. 그러나 사용 사례에서 팁 데이터 손실이 쓰기 가용성보다 더 중요한 경우 클러스터를 업데이트하여 기본값을 재정의할 수 있습니다.

읽기 전용 복제본 클러스터는 클러스터의 모든 DB 인스턴스가 최소 2개의 가용 영역에 배포되도록 하여 가용 영역 중단 시 쓰기 가용성과 데이터 내구성을 향상시킵니다.

**Topics**
+ [읽기 전용 복제본 클러스터의 인스턴스 클래스 가용성](#timestream-for-influx-instance-class-rr)
+ [읽기 전용 복제본 클러스터 아키텍처](#timestream-for-influx-rr-cluster-architecture)
+ [읽기 전용 복제본 클러스터의 파라미터 그룹](#timestream-for-influx-rr-param-groups)
+ [읽기 전용 복제본 클러스터의 복제 지연](#timestream-for-influx-replica-lag)
+ [가용성과 내구성](#timestream-for-influx-availability)
+ [Amazon Timestream for InfluxDB 읽기 전용 복제본 클러스터의 개요](timestream-for-influx-read-replica-overview.md)
+ [Timestream for InfluxDB 읽기 전용 복제본 클러스터 생성](timestream-for-influx-create-rr-cluster.md)
+ [Timestream for InfluxDB 읽기 전용 복제본 DB 클러스터에 연결](timestream-for-influx-connecting-cluster.md)
+ [Amazon Timestream for InfluxDB의 읽기 전용 복제본 클러스터 수정](timestream-for-influx-modifying-rr-cluster.md)
+ [Amazon Timestream for InfluxDB에서 읽기 전용 복제본 클러스터 재부팅](timestream-for-influx-rebooting-rr-cluster.md)
+ [Amazon Timestream for InfluxDB 모니터링을 위한 CloudWatch 경보 생성](timestream-for-influx-creating-cw-alarms.md)
+ [를 통해 복제본 라이선스 읽기 AWS Marketplace](timestream-for-influx-rr-licensing.md)

# Amazon Timestream for InfluxDB 읽기 전용 복제본 클러스터의 개요
<a name="timestream-for-influx-read-replica-overview"></a>

다음 섹션에서는 Timestream for InfluxDB 읽기 전용 복제본 클러스터에 대해 설명합니다.

**Topics**
+ [읽기 전용 복제본에 대한 사용 사례](#timestream-for-influx-rr-use-cases)
+ [읽기 전용 복제본의 작동 방식](#timestream-for-influx-how-rr-work)
+ [Timestream for InfluxDB 읽기 전용 복제본의 특성](#timestream-for-influx-rr-characteristics)
+ [읽기 전용 복제본 인스턴스 및 스토리지 유형](#timestream-for-influx-rr-instance-storage-types)
+ [복제본 삭제 시 고려 사항](#timestream-for-influx-rr-deletion)

## 읽기 전용 복제본에 대한 사용 사례
<a name="timestream-for-influx-rr-use-cases"></a>

읽기 전용 복제본 클러스터를 사용하면 다음과 같은 다양한 시나리오에서 유용할 수 있습니다.
+ 읽기 중심의 데이터베이스 워크로드를 위해 단일 DB 인스턴스의 컴퓨팅 파워 또는 I/O 용량을 확장합니다. 이 과도한 읽기 트래픽을 하나 이상의 읽기 전용 복제본으로 이동할 수 있습니다.
+ 프라이머리 라이터 인스턴스를 사용할 수 없는 동안 읽기 트래픽을 처리합니다. 경우에 따라 백업 또는 예약된 유지 관리를 위한 I/O 일시 중단 등으로 인해 프라이머리 DB 인스턴스가 I/O 요청을 처리하지 못할 수 있습니다. 이러한 경우 읽기 트래픽을 읽기 전용 복제본으로 리디렉션할 수 있습니다. 이 사용 사례의 경우 프라이머리 DB 인스턴스를 사용할 수 없으므로 읽기 전용 복제본의 데이터가 ‘무효’일 수 있다는 점에 유의하세요. 또한 이러한 시나리오가 작동하려면 자동 장애 조치를 꺼야 한다는 점을 명심하세요.
+ 비즈니스 보고 또는 데이터 웨어하우징 시나리오에서는 프로덕션 DB 인스턴스가 아닌 읽기 전용 복제본에 대한 비즈니스 보고 쿼리를 실행할 수 있습니다.
+ 재해 복구 구현 프라이머리 DB 인스턴스가 실패할 경우 재해 복구 솔루션으로 읽기 전용 복제본을 프라이머리로 승격할 수 있습니다.
+ 내구성보다 가용성이 더 중요한 시나리오에서 더 빠른 장애 조치. 읽기 전용 복제본은 비동기식 복제를 사용하므로 장애 조치 전에 프라이머리 라이터 인스턴스에서 커밋된 일부 데이터가 복제되지 않았을 가능성이 있습니다. 그러나 가동 시간이 최우선인 애플리케이션의 경우 이러한 단점은 수용 가능합니다. 워크로드 특성에 따라 읽기 전용 복제본에 대한 장애 조치가 동기식 복제를 사용하는 대기 DB 인스턴스에 대한 장애 조치보다 훨씬 빠를 수 있습니다. 복제본 인스턴스가 이미 실행 중이고 엔진을 시작할 필요가 없기 때문입니다. 이는 특히 1분 1초가 중요한 사용 사례에서 유용할 수 있습니다.

## 읽기 전용 복제본의 작동 방식
<a name="timestream-for-influx-how-rr-work"></a>

읽기 전용 복제본 클러스터를 생성하기 위해 Amazon Timestream for InfluxDB는 InfluxData의 라이선스가 부여된 읽기 전용 복제본 추가 기능을 사용합니다. 추가 기능 구독은를 통해 Amazon Timestream 관리 콘솔에서 AWS Marketplace직접 활성화됩니다. 자세한 내용은 [를 통해 복제본 라이선스 읽기 AWS Marketplace읽기 전용 복제본 라이선스 용어](timestream-for-influx-rr-licensing.md) 섹션을 참조하세요.

읽기 전용 복제본은 클러스터의 각 노드에 사용된 DB 인스턴스 유형과 동일한 요금으로 표준 DB 인스턴스로 청구되며, 여기에 InfluxData의 라이선스 추가 기능 비용이 추가됩니다. 추가 기능 비용은 AWS Marketplace를 통해 인스턴스 시간 단위로 청구됩니다. 동일한 AWS 리전내에서 원본 DB 인스턴스와 읽기 전용 복제본 간의 데이터 복제로 발생한 데이터 전송에 대해서는 요금이 부과되지 않습니다.

읽기 전용 복제 클러스터를 생성 및 구성하고 쓰기 작업을 수락하기 시작하면 Amazon Timestream for InfluxDB는 프라이머리 DB 인스턴스에 변경 사항이 있을 때마다 비동기식 복제 방식을 사용하여 읽기 전용 복제를 업데이트합니다.

읽기 전용 복제본은 전용 DB 인스턴스로 작동하며, 읽기 전용 연결만 수락합니다. 애플리케이션은 다른 DB 인스턴스에 연결하는 것과 동일한 방식으로 읽기 전용 복제본에 연결할 수 있어, 원활하고 익숙한 경험을 제공합니다. Amazon Timestream for InfluxDB는 프라이머리 DB 인스턴스의 모든 데이터를 읽기 전용 복제본으로 자동 복제하여 데이터 일관성과 정확성을 보장합니다. 업데이트는 클러스터 수준에서 수행되며 프라이머리와 복제본 모두에 동시에 적용됩니다.

## Timestream for InfluxDB 읽기 전용 복제본의 특성
<a name="timestream-for-influx-rr-characteristics"></a>


****  

| 기능 또는 특성 | Timestream for InfluxDB | 
| --- | --- | 
| 어떤 복제 방식을 사용합니까? | 논리적 복제 | 
| 복제본에 쓰기가 가능합니까? | 아니요, Timestream for InfluxDB 읽기 전용 복제본은 읽기 전용으로 설계되어 쓰기 가능하도록 설정할 수 없습니다. 장애 조치 시 읽기 전용 복제본을 프라이머리로 승격하여 쓰기를 수락할 수 있지만 Timestream for InfluxDB 읽기 전용 복제본 클러스터에는 항상 하나의 라이터 DB 인스턴스만 있을 수 있습니다. 이를 통해 데이터 일관성이 보장되고 여러 쓰기 가능 인스턴스에서 발생할 수 있는 충돌이 방지됩니다. 읽기 전용 복제본의 역할은 데이터의 중복된 읽기 전용 사본을 제공하는 것이며, 데이터 무결성을 유지하기 위해 쓰기 요청을 자동으로 거부합니다. | 
| 복제본에 대해서도 백업이 가능합니까? | 예, 내장 엔진 기능을 통해 Influx CLI를 사용하여 백업을 생성할 수 있습니다. | 
| 병렬 복제 기능을 사용할 수 있습니까? | 아니요, Timestream for InfluxDB에는 복제를 처리하는 단일 프로세스가 있습니다. | 

## 읽기 전용 복제본 인스턴스 및 스토리지 유형
<a name="timestream-for-influx-rr-instance-storage-types"></a>

읽기 전용 복제본은 프라이머리 DB 인스턴스와 동일한 인스턴스 및 스토리지 유형과 함께 생성됩니다. 구성에 대한 모든 변경 사항은 클러스터 수준에서 이루어져야 하며 클러스터 내의 모든 인스턴스에 적용됩니다. Timestream for InfluxDB DB 인스턴스에 사용 가능한 모든 인스턴스 및 스토리지 구성은 Timestream for InfluxDB 읽기 전용 복제본 클러스터에 사용할 수 있습니다.

**인스턴스 유형**


****  

| 인스턴스 클래스 | vCPU | 메모리(GiB) | 스토리지 유형 | 네트워크 대역폭(Gbps) | 
| --- | --- | --- | --- | --- | 
| db.influx.medium | 1 | 8 | Influx IOPS 포함 | 10 | 
| db.influx.large | 2 | 16 | Influx IOPS 포함 | 10 | 
| db.influx.xlarge | 4 | 32 | Influx IOPS 포함 | 10 | 
| db.influx.2xlarge | 8 | 64 | Influx IOPS 포함 | 10 | 
| db.influx.4xlarge | 16 | 128 | Influx IOPS 포함 | 10 | 
| db.influx.8xlarge | 32 | 256 | Influx IOPS 포함 | 12 | 
| db.influx.12xlarge | 48 | 384 | Influx IOPS 포함 | 20 | 
| db.influx.16xlarge | 64 | 512 | Influx IOPS 포함 | 25 | 
| db.influx.24xlarge | 96 | 768 | Influx IOPS 포함 | 40 | 

**스토리지 옵션**


****  

| Timestream for InfluxDB DB 클러스터 스토리지 | 원본 DB 인스턴스 스토리지 할당 | 포함된 IOPS | 
| --- | --- | --- | 
| Influx IO 포함(3K) | 20GiB\$116TiB | 3,000IOPS | 
| Influx IO 포함(12K) | 400GiB\$116TiB | 12,000IOPS | 
| Influx IO 포함(16K) | 400GiB\$116TiB | 16,000IOPS | 

## 복제본 삭제 시 고려 사항
<a name="timestream-for-influx-rr-deletion"></a>

더 이상 읽기 전용 복제본이 필요하지 않으면 `delete-db-cluster` API를 직접적으로 호출하여 클러스터를 명시적으로 삭제할 수 있습니다. 다음은 자신의 정보를 각각의 *사용자 입력 자리 표시자*로 변경하는 예제입니다. 지금은 클러스터에서 단일 노드를 제거할 수 없다는 점을 명심하세요.

```
aws timestream-influxdb delete-db-cluster \
            --region region \
            --endpoint endpoint \
            --db-cluster-id cluster-id
```

# Timestream for InfluxDB 읽기 전용 복제본 클러스터 생성
<a name="timestream-for-influx-create-rr-cluster"></a>

Timestream for InfluxDB 읽기 전용 복제본 클러스터에는 별도 가용 영역에 라이터 DB 인스턴스와 리더 DB 인스턴스가 있습니다. Timestream for InfluxDB 읽기 전용 복제본 클러스터는 고가용성을 제공하고, 읽기 워크로드에 대한 용량을 늘리고, 복제본에 대한 장애 조치가 구성된 경우 더 빠른 장애 조치를 지원합니다.

## DB 클러스터 사전 조건
<a name="timestream-for-influx-create-prereq"></a>

**중요**  
다음은 읽기 전용 복제본 클러스터를 생성하기 전에 완료해야 하는 전제 조건입니다.

**Topics**
+ [DB 클러스터의 네트워크 구성](#timestream-for-influx-config-network)
+ [추가 사전 조건](#timestream-for-influx-addl-prereqs)

### DB 클러스터의 네트워크 구성
<a name="timestream-for-influx-config-network"></a>

Amazon VPC 서비스 기반의 가상 프라이빗 클라우드(VPC)에서만 Timestream for InfluxDB 읽기 전용 복제본 DB 클러스터를 생성할 수 있습니다. 가용 영역 AWS 리전 이 3개 이상인에 있어야 합니다. DB 클러스터에 대해 선택한 DB 서브넷 그룹은 세 개 이상의 가용 영역을 포함해야 합니다. 이 구성은 DB 클러스터의 각 DB 인스턴스가 서로 다른 가용 영역에 있도록 합니다.

동일한 VPC의 EC2 인스턴스 이외의 리소스에서 DB 클러스터에 연결하려는 경우 네트워크 연결을 수동으로 구성합니다.

### 추가 사전 조건
<a name="timestream-for-influx-addl-prereqs"></a>

**읽기 전용 복제본 클러스터를 만들려면 먼저 다음과 같은 추가 사전 조건을 고려하세요.**

DB 클러스터에 대한 구성 파라미터를 사용자 지정하려면 필요한 파라미터 설정으로 DB 클러스터 파라미터 그룹을 지정해야 합니다. DB 클러스터 파라미터 그룹 생성 또는 수정에 대한 자세한 내용은 [읽기 전용 복제본 클러스터의 파라미터 그룹](timestream-for-influx-working-read-replica.md#timestream-for-influx-rr-param-groups) 섹션을 참조하세요.

DB 클러스터에 지정할 TCP/IP 포트 번호를 정합니다. 일부 기업에서는 방화벽이 이러한 기본 포트 연결을 차단하는 경우도 있습니다. 이처럼 기업 방화벽이 기본 포트를 차단할 경우 DB 클러스터에 다른 포트를 선택해야 합니다. DB 클러스터의 모든 DB 인스턴스는 동일한 포트를 사용합니다.

## DB 클러스터 생성
<a name="timestream-for-influx-create-cluster"></a>

 AWS CLI, 또는 Amazon Timestream for InfluxDB API를 사용하여 Timestream for InfluxDB 읽기 전용 복제본 DB 클러스터 AWS Management Console를 생성할 수 있습니다.

------
#### [ Using the AWS Management Console ]

**배포 설정** 섹션에서 **읽기 전용 복제본이 있는 클러스터**를 선택하여 Timestream for InfluxDB 읽기 전용 복제본 DB 클러스터를 생성할 수 있습니다.

콘솔을 사용하여 읽기 전용 복제본 DB 클러스터를 생성하려면 다음을 수행하세요.

1. [AWS Management Console](https://console.aws.amazon.com/timestream)에 로그인하고 Amazon Timestream 콘솔을 엽니다.

1. 의 오른쪽 상단 모서리에서 읽기 전용 복제본 DB 클러스터 AWS 리전 를 생성할를 AWS Management Console선택합니다.

1. 탐색 창에서 **InfluxDB 데이터베이스**를 선택합니다.

1. **InfluxDB 데이터베이스 생성**을 선택합니다.

1. **배포 설정**에서 **읽기 전용 복제본이 있는 클러스터**를 선택합니다.

   이 옵션을 선택하면 AWS Marketplace 위젯을 통해 구독을 활성화해야 한다는 메시지가 나타납니다. **구독 옵션 보기**를 클릭합니다. 구독이 활성화되기까지 1\$12분가량 소요될 수 있습니다.  
![\[새 데이터베이스에 사용 가능한 다양한 배포 설정을 보여주는 InfluxDB 데이터베이스 생성 인터페이스. 읽기 전용 복제본이 있는 클러스터 옵션이 선택되었습니다.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/deployment_settings_rr.jpg)  
![\[구독이 진행 중이라는 메시지가 표시된 배포 설정 인터페이스.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/subscription_in_progress.jpg)

1. 구독이 활성화되면 **구독 보기**를 클릭합니다.  
![\[이제 구독이 활성화되었다는 메시지가 표시된 배포 설정 인터페이스.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/subscription_success_message.jpg)

1. 각 리전의 인스턴스 시간당 vCPU당 비용 정보가 표시된 창이 나타납니다. 이는 동일한 컴퓨팅 요금 모델을 따르며, 선택한 인스턴스 유형에 따라 인스턴스가 활성화된 시간 수에 따라 요금이 부과됩니다. 추가 기능은 한 번만 구독하면 되며, 구독하면 Timestream for InfluxDB를 사용할 수 있는 모든 리전에서 인스턴스를 생성할 수 있습니다.  
![\[각 리전의 인스턴스 시간당 vCPU당 비용에 대한 요금 세부 정보가 표시된 구독 옵션 양식.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/purchase_subscription.png)
**중요**  
제안을 구독하려면 AWSMarketplaceManageSubscriptions 또는 AWSMarketplaceFullAccess 권한이 있어야 합니다. 이러한 권한에 대한 자세한 내용은 [AWS Marketplace 구독에 대한 액세스 제어를 참조하세요](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-iam-users-groups-policies.html).

1. 구독을 확인하면 서비스가 인스턴스의 리전에 따라 자동으로 리전을 선택합니다.

1. **데이터베이스 자격 증명**에서 다음 필드를 작성합니다.

   1. **DB 클러스터 식별자**에 DB 클러스터의 식별자를 입력합니다.

   1. InfluxDB 기본 초기 구성 파라미터인 **사용자 이름**, **조직 이름**, **버킷 이름** 및 **암호**를 제공합니다.

1. **인스턴스 구성**에서 **DB 인스턴스 클래스**를 지정합니다. 워크로드 요구 사항에 가장 적합한 인스턴스 크기를 선택합니다. 이 인스턴스 유형은 읽기 전용 복제본 DB 클러스터의 모든 인스턴스에 사용된다는 점을 명심하세요.

1. **스토리지 구성**에서 요구 사항에 적합한 **스토리지 유형**을 선택합니다. 어떤 경우든 할당된 스토리지만 구성하면 됩니다. 이 스토리지 유형은 읽기 전용 복제본 DB 클러스터의 모든 인스턴스에 사용된다는 점을 명심하세요.

1. **연결 구성** 섹션에서 InfluxDB 클러스터가 Timestream for InfluxDB DB 인스턴스에 대한 연결이 필요한 클라이언트와 동일한 서브넷에 있는지 확인합니다. **퍼블릭 액세스** 하위 섹션에서 DB 인스턴스를 공개적으로 사용할 수 있게 설정할 수도 있습니다.

1. **InfluxDB 데이터베이스 생성**을 선택합니다.

1. **InfluxDB 데이터베이스** 목록에서 새 InfluxDB 클러스터의 이름을 선택하면 세부 정보가 표시됩니다. 사용할 준비가 될 때까지 DB 클러스터의 상태는 **생성 중**입니다.

1. 상태가 **사용 가능**으로 변경되면 DB 클러스터에 연결할 수 있습니다. DB 인스턴스 클래스와 스토리지의 양에 따라 새 인스턴스를 사용할 수 있을 때까지 최대 20분이 걸릴 수 있습니다.  
![\[‘사용 가능’ 상태인 2개의 인스턴스가 표시된 DB 클러스터 요약 페이지.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/cluster_details_page.png)

1. 클러스터가 생성되면 DB 클러스터 식별자를 클릭하여 새로 생성된 클러스터에 대한 정보를 검색할 수 있습니다. **PRIMARY** 인스턴스 모드를 표시하는 엔드포인트가 쓰기 작업 및 엔진 관리에 사용해야 하는 엔드포인트입니다.

------
#### [ Using the AWS CLI ]

를 사용하여 DB 인스턴스를 생성하려면 다음 파라미터를 사용하여 `create-db-cluster` 명령을 AWS Command Line Interface호출합니다. *user input placeholder*를 사용자의 정보로 바꿉니다.

```
aws timestream-influxdb create-db-cluster \
      --region region \
      --vpc-subnet-ids subnet-ids \
      --vpc-security-group-ids security-group-ids \
      --db-instance-type db.influx.large \
      --db-storage-type InfluxIOIncludedT2 \
      --allocated-storage 400 \
      --password password \ 
      --name cluster-name \
      --deployment-type MULTI_NODE_READ_REPLICAS \
      --publicly-accessible
      //--failover-mode is optional and defaults to AUTOMATIC.
```

------

### 읽기 전용 복제본 클러스터 생성 설정
<a name="timestream-for-influx-rr-create-settings"></a>

읽기 전용 복제본 클러스터를 생성할 때 선택하는 설정에 대한 자세한 내용은 다음 표를 참조하세요. AWS CLI 옵션에 대한 자세한 내용은 [create-db-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/timestream-influxdb/create-db-cluster.html)를 참조하세요. Amazon Timestream for InfluxDB API 파라미터에 대한 자세한 내용은 [CreateDbCluster](https://docs.aws.amazon.com/ts-influxdb/latest/ts-influxdb-api/API_CreateDbCluster.html)를 참조하세요.


****  

| 콘솔 설정 | 설정 설명 | CLI 옵션 및 Timestream for InfluxDB API 파라미터 | 
| --- | --- | --- | 
| 할당된 스토리지 | DB 클러스터의 각 DB 인스턴스에 할당할 스토리지 양(기비바이트)입니다. 자세한 내용은 [InfluxDB 인스턴스 스토리지](timestream-for-influxdb.md#timestream-for-influx-dbi-storage) 단원을 참조하십시오. |  **CLI 옵션: ** `--allocated-storage` **API 파라미터: **`allocatedStorage`  | 
| 데이터베이스 포트 | InfluxDB가 연결을 허용하는 포트 번호입니다. 유효한 값: 1,024\$165,535 기본값: 8086 제약 조건: 값은 2,375\$12,376, 7,788\$17,799, 8,090 또는 51,678\$151,680일 수 없습니다.  |  **CLI 옵션: ** `--port` **API 파라미터: **`port`  | 
| DB 클러스터 이름 | DB 클러스터를 고유하게 식별하는 이름입니다. DB 인스턴스 이름은 고객 및 리전별로 고유해야 합니다. |  **CLI 옵션: ** `--name` **API 파라미터: **`name`  | 
| DB 인스턴스 유형 | Timestream for InfluxDB DB 클러스터에 있는 각 DB 인스턴스의 컴퓨팅 및 메모리 용량입니다(예: db.influx.xlarge).가능하면 일반 쿼리 작업 세트가 메모리에 상주할 수 있을 정도로 큰 DB 인스턴스 클래스를 선택합니다. 작업 세트가 메모리에 상주할 경우 시스템의 디스크 쓰기가 불필요하여 성능이 향상됩니다.  |  **CLI 옵션: ** `--db-instance-type` **API 파라미터: **`dbInstanceType`  | 
| DB 클러스터 파라미터 그룹 |  DB 클러스터에 할당할 DB 파라미터 그룹의 ID입니다. DB 파라미터 그룹은 데이터베이스가 구성되는 방식을 지정합니다. 예를 들어, DB 파라미터 그룹은 쿼리 동시성에 대한 제한을 지정할 수 있습니다. |  **CLI 옵션: ** `--db-parameter-group-identifier` **API 파라미터: **`dbParameterGroupIdentifier`  | 
| 배포 유형 |  DB 클러스터를 다중 노드 읽기 전용 복제본으로 배포할지 아니면 다중 AZ 다중 노드 읽기 전용 복제본으로 배포할지 지정합니다. 가능한 값: `MULTI_NODE_READ_REPLICAS`  |  **CLI 옵션: ** `--deployment-type` **API 파라미터: **`deploymentType`  | 
| VPC 서브넷 ID | DB 클러스터에 사용할 DB 서브넷 ID입니다. 기존 DB 서브넷 그룹을 사용하려면 기존 항목 선택을 선택한 다음 기존 DB 서브넷 그룹 드롭다운 목록에서 필요한 서브넷 그룹을 선택합니다. Timestream for InfluxDB가 호환되는 DB 서브넷 그룹을 선택하도록 하려면 자동 설정을 선택합니다. |  **CLI 옵션: ** `--vpc-subnet-ids` **API 파라미터: **`vpcSubnetIds`  | 
| Organization | InfluxDB의 초기 관리자 사용자에 대한 초기 조직의 이름입니다. InfluxDB 조직은 사용자 그룹을 위한 작업 공간입니다. |  **CLI 옵션: ** `--organization` **API 파라미터: **`organization`  | 
| 버킷 | 초기 InfluxDB 버킷의 이름입니다. 모든 InfluxDB 데이터는 버킷에 저장됩니다. 버킷은 데이터베이스 개념과 보존 기간(각 데이터 포인트가 유지되는 기간)을 결합한 것입니다. 버킷은 조직에 속합니다. |  **CLI 옵션: ** `--bucket` **API 파라미터: **`bucket`  | 
| 로그 내보내기 |  지정된 S3 버킷으로 InfluxDB 엔진 로그를 전송하기 위한 구성 S3 버킷 로그 전송을 위한 구성: `s3Configuration -> (structure)` 로그를 보낼 S3 버킷의 이름: `bucketName -> (string)` S3 버킷으로 로그 전송이 활성화되었는지 여부 표시: `enabled -> (boolean)` 간편 구문: `s3Configuration={bucketName=string, enabled=boolean}`  |  **CLI 옵션: ** `--log-delivery-configuration` **API 파라미터: **`logDeliveryConfiguration`  | 
| 암호 | InfluxDB에서 생성한 초기 관리자 사용자의 암호입니다. 이 암호를 사용하면 InfluxDB UI에 액세스하여 다양한 관리 태스크를 수행할 수 있으며, InfluxDB CLI를 사용하여 연산자 토큰을 생성할 수도 있습니다. 이러한 속성은 계정의 AWS Secrets Manager 에서 생성된 시크릿에 저장됩니다. |  **CLI 옵션: ** `--password` **API 파라미터: **`password`  | 
| 사용자 이름 | InfluxDB에서 생성된 초기 관리자 사용자의 사용자 이름입니다. 문자로 시작해야 하며 하이픈으로 끝나거나 하이픈이 2개 연속으로 이어져서는 안 됩니다. 예를 들면 my-user1입니다. 이 사용자 이름을 사용하면 InfluxDB UI에 액세스하여 다양한 관리 태스크를 수행할 수 있으며, InfluxDB CLI를 사용하여 연산자 토큰을 생성할 수도 있습니다. 이러한 속성은 계정의 AWS Secrets Manager 에서 생성된 시크릿에 저장됩니다. |  **CLI 옵션: ** `--username` **API 파라미터: **`username`  | 
| 공개 액세스(Public access) | VPC 외부에서 DB 클러스터에 액세스할 수 있는지 여부를 나타냅니다.**공개적으로 액세스할 수 있음**을 선택하면 DB 클러스터에 퍼블릭 IP 주소를 제공하여 VPC 외부에서 액세스할 수 있습니다. 공개적으로 액세스가 가능하려면 DB 클러스터도 VPC의 퍼블릭 서브넷에 있어야 합니다. **공개적으로 액세스할 수 없음**을 선택하면 VPC 내에서만 DB 클러스터에 액세스할 수 있습니다.  |  **CLI 옵션: ** `--publicly-accessible``--no-publicly-accessible` **API 파라미터: **`publiclyAccessible`  | 
| DB 스토리지 유형 | InfluxDB 데이터입니다.워크로드의 요구 사항에 따라 3가지 유형의 프로비저닝된 Influx IOPS 포함 스토리지 중에서 선택할 수 있습니다. 가능한 값은 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/timestream-for-influx-create-rr-cluster.html)  |  **CLI 옵션: ** `--db-storage-type``--no-publicly-accessible` **API 파라미터: **`dbStorageType`  | 
| VPC 보안 그룹 | DB 인스턴스와 연결할 VPC 보안 그룹 ID의 목록입니다. |  **CLI 옵션: ** `--vpc-security-group-ids``--no-publicly-accessible` **API 파라미터: **`vpcSecurityGroupIds`  | 
| VPC 서브넷 ID | DB 인스턴스와 연결할 VPC 서브넷 ID의 목록입니다. Timestream for InfluxDB DB 클러스터와 함께 배포할 때 서로 다른 가용 영역에 위치한 최소 2개의 VPC 서브넷 ID를 제공합니다. |  **CLI 옵션: ** `--vpc-subnet-ids` **API 파라미터: **`vpcSubnetIds`  | 
| 장애 조치 모드 | 클러스터가 프라이머리 인스턴스 장애에 대응하는 방식입니다. 다음 옵션으로 이를 구성할 수 있습니다.`AUTOMATIC`: 프라이머리 인스턴스에 장애가 발생하면 시스템은 자동으로 읽기 전용 복제본을 새 프라이머리 인스턴스로 승격합니다. `NO_FAILOVER`: 프라이머리 인스턴스에 장애가 발생하면 시스템은 읽기 전용 복제본을 승격하지 않고 프라이머리 인스턴스 복원을 시도합니다. 클러스터는 프라이머리 인스턴스가 복원될 때까지 사용 불가 상태를 유지합니다.  |  **CLI 옵션: ** `--failover-mode` **API 파라미터: **`failoverMode`  | 

**중요**  
DB 클러스터 응답 객체의 일부로 `influxAuthParametersSecretArn`을 받게 됩니다. 이는 계정의 Secrets Manager 시크릿에 대한 ARN을 보유합니다. 이 ARN은 InfluxDB DB 인스턴스가 사용 가능해진 후에만 채워집니다. 이 시크릿은 `CreateDbInstance` 프로세스 중 제공된 influx 인증 파라미터를 포함하며, **읽기 전용** 사본이므로 이 시크릿에 대한 모든 업데이트/수정/삭제는 생성된 DB 인스턴스에 영향을 미치지 않습니다. 이 시크릿을 삭제하더라도, API 응답은 여전히 삭제된 시크릿 ARN을 참조합니다.

# Timestream for InfluxDB 읽기 전용 복제본 DB 클러스터에 연결
<a name="timestream-for-influx-connecting-cluster"></a>

Timestream for InfluxDB 읽기 전용 복제본 DB 클러스터에는 단일 DB 인스턴스 대신 2개의 연결 가능한 DB 인스턴스가 있습니다. 각 연결은 특정 DB 인스턴스에서 처리합니다. 읽기 전용 복제본 DB 클러스터에 연결하면 지정한 호스트 이름과 포트가 *엔드포인트*라는 정규화된 도메인 이름으로 연결됩니다.

프라이머리(라이터) 엔드포인트는 읽기 및 쓰기 작업을 모두 지원하는 읽기 전용 복제본 DB 클러스터의 라이터 DB 인스턴스에 연결됩니다. 리더 엔드포인트는 읽기 작업만 지원하는 리더 DB 인스턴스에 연결됩니다.

엔드포인트를 사용하면 사용 사례에 따라 각 연결을 적절한 DB 인스턴스에 매핑할 수 있습니다. 예를 들어, 관리 또는 쓰기 명령을 수행하기 위해 라이터 DB 인스턴스인 어떤 DB 인스턴스에나 연결할 수 있습니다. 쿼리를 수행하기 위해 리더 엔드포인트에 연결할 수 있습니다. 진단 또는 튜닝의 경우 특정 DB 인스턴스 엔드포인트인 `/metrics`에 연결하여 특정 DB 인스턴스에 대한 세부 정보를 검토할 수 있습니다.

DB 인스턴스 연결에 대한 정보는 [Amazon Timestream for InfluxDB DB 인스턴스에 연결](timestream-for-influx-db-connecting.md) 섹션을 참조하세요. 읽기 전용 복제본 클러스터 연결에 대한 자세한 내용은 다음 주제를 참조하세요.

## 읽기 전용 복제본 클러스터 엔드포인트의 유형
<a name="timestream-for-influx-rr-cluster-endpoint-types"></a>

엔드포인트는 호스트 주소를 포함하는 고유 식별자로 표시됩니다. 각 Timestream for InfluxDB 클러스터에는 다음이 포함됩니다.
+ 클러스터 엔드포인트입니다.
+ 클러스터 읽기 전용 엔드포인트
+ 클러스터의 각 인스턴스에 대한 인스턴스 엔드포인트

### 클러스터 엔드포인트
<a name="timestream-for-influx-rr-cluster-endpoints"></a>

읽기 전용 복제본 클러스터의 *클러스터 엔드포인트*(또는 *라이터 엔드포인트*)는 해당 DB 클러스터의 현재 라이터 DB 인스턴스에 연결됩니다. 이 엔드포인트는 다음과 같은 쓰기 작업을 수행할 수 있는 유일한 엔드포인트입니다.
+ InfluxDB 관련 관리 명령(예: 조직, 사용자, 버킷, 태스크 등 생성, 수정 또는 삭제)
+ 데이터베이스 클러스터에 데이터 쓰기

쓰기, 업서트, 삭제, 모든 구성 및 관리 변경을 포함한 DB 클러스터의 모든 쓰기 작업에 클러스터 엔드포인트를 사용합니다.

또한 쿼리와 같은 읽기 작업에 클러스터 엔드포인트를 사용할 수 있습니다.

DB 클러스터의 현재 라이터 DB 인스턴스에 장애가 발생하면 읽기 전용 복제본 클러스터가 자동으로 해당 복제본 중 하나로 장애 조치를 수행하여 새 라이터 DB 인스턴스로 승격시킵니다. 장애 조치가 이루어지는 동안에도 DB 클러스터가 새로운 라이터 DB 인스턴스의 클러스터 엔드포인트 연결 요청을 처리하여 서비스 중단 시간을 최소화합니다. 라이터로 승격된 읽기 전용 복제본 엔드포인트는 새 복제본이 배포될 때까지 읽기 서비스를 중단합니다.

다음은 읽기 전용 복제본 클러스터의 클러스터 엔드포인트를 보여주는 예제입니다.

```
ipvtdwa5se-wmyjrrjko.us-west-2.timestream-influxdb.amazonaws.com
```

### 읽기 전용 엔드포인트
<a name="timestream-for-influx-rr-readonly-endpoints"></a>

*읽기 전용 엔드포인트*는 클러스터의 읽기 전용 복제본 인스턴스 중 하나에 연결됩니다. 읽기 전용 복제본은 Flux 쿼리, InfluxQL 쿼리 등의 읽기 작업만 지원합니다. 여기에는 `/api/v2/query` 엔드포인트에 대해 실행되는 모든 작업(Flux 쿼리의 경우)이나 `/api/query` 엔드포인트에 대해 실행되는 모든 작업(InfluxQL v1 호환 쿼리의 경우)이 포함됩니다. 리더 DB 인스턴스에서 이러한 문을 처리하여 이 엔드포인트에서 라이터 DB 인스턴스의 오버헤드를 줄입니다. 또한 클러스터가 더 많은 동시 쿼리를 처리하는 데 도움이 됩니다.

다음은 읽기 전용 복제본 클러스터의 리더 엔드포인트를 보여주는 예제입니다. 리더 엔드포인트의 읽기 전용 인텐트는 클러스터 엔드포인트 이름 내에서 `-ro`로 표시됩니다.

```
ipvtdwa5se-wmyjrrjko-ro.us-west-2.timestream-influxdb.amazonaws.com
```

### 인스턴스 엔드포인트
<a name="timestream-for-influx-rr-instance-endpoints"></a>

*인스턴스 엔드포인트*는 읽기 전용 복제본 클러스터에 있는 특정 DB 인스턴스에 연결됩니다. DB 클러스터의 DB 인스턴스에는 각각 고유한 인스턴스 엔드포인트가 있습니다. 따라서 DB 클러스터(프라이머리)의 현재 라이터 DB 인스턴스에 대해 인스턴스 엔드포인트가 하나씩 있고 DB 클러스터의 각 리더 DB 인스턴스에 대해 인스턴스 엔드포인트가 하나씩 있습니다.

인스턴스 엔드포인트에서는 DB 클러스터에 대한 연결을 직접 제어할 수 있습니다. 이 제어 기능은 클러스터 엔드포인트 또는 리더 엔드포인트를 사용하는 것이 적절하지 않을 수 있는 상황에서 문제를 해결하는 데 도움이 될 수 있습니다. 예를 들어 클라이언트 애플리케이션에서 워크로드 유형에 따라 더욱 세분화된 로드 밸런싱이 필요할 수 있습니다. 이 경우, 여러 클라이언트가 DB 클러스터의 다른 리더 DB 인스턴스에 연결하여 읽기 워크로드를 분산하도록 구성할 수 있습니다.

다음은 읽기 전용 복제본 클러스터의 DB 인스턴스에 대한 인스턴스 엔드포인트를 보여주는 예제입니다.

```
mydbinstance-123456789012.us-east-1.timestream-influxdb.amazonaws.com
```

# Amazon Timestream for InfluxDB의 읽기 전용 복제본 클러스터 수정
<a name="timestream-for-influx-modifying-rr-cluster"></a>

읽기 전용 복제본 클러스터에는 별도의 가성 영역에 라이터 DB 인스턴스와 리더 DB 인스턴스가 있습니다. 읽기 전용 복제본 클러스터는 다중 AZ 배포에 비해 고가용성, 높은 읽기 워크로드 용량 및 더 빠른 장애 조치를 제공합니다. 읽기 전용 복제본 클러스터에 대한 자세한 내용은 [Amazon Timestream for InfluxDB 읽기 전용 복제본 클러스터의 개요](timestream-for-influx-read-replica-overview.md) 섹션을 참조하세요.

읽기 전용 복제본 클러스터를 수정하여 해당 설정을 변경할 수 있습니다.

**중요**  
읽기 전용 복제본 클러스터에 있는 DB 인스턴스를 수정할 수 없습니다. 모든 수정은 DB 클러스터 수준에서 이루어져야 합니다.  
 AWS CLI, 또는 Amazon Timestream for InfluxDB API AWS Management Console를 사용하여 읽기 전용 복제본 클러스터를 수정할 수 있습니다.

## Amazon Timestream for InfluxDB의 읽기 전용 복제본 클러스터 수정
<a name="timestream-for-influx-modify-rr-db-cluster"></a>

------
#### [ Using the AWS Management Console ]

콘솔을 사용하여 읽기 전용 복제본 DB 클러스터를 수정하려면 다음을 수행하세요.

1. [AWS Management Console](https://console.aws.amazon.com/timestream)에 로그인하고 Amazon Timestream 콘솔을 엽니다.

1. 탐색 창에서 **InfluxDB 데이터베이스**를 선택한 다음 수정하려는 읽기 전용 복제본 클러스터를 선택합니다.

1. **수정**을 선택합니다. **DB 클러스터 수정** 페이지가 나타납니다.

1. 원하는 설정을 선택합니다. 각 설정에 대한 자세한 내용은 [읽기 전용 복제본 클러스터 수정 설정](#timestream-for-influx-rr-modify-settings) 섹션을 참조하세요.

1. 변경 후 **계속**을 선택하고 수정 사항 요약을 확인합니다.

1. 확인 페이지에서 변경 내용을 검토합니다. 변경 내용이 올바른 경우 **DB 클러스터 수정(Modify DB cluster)**을 선택하여 변경 내용을 저장합니다. 그렇지 않으면 **뒤로**를 선택하여 변경 내용을 편집하거나 **취소**를 선택하여 변경 내용을 취소합니다.

**중요**  
 현재 Amazon Timestream for InfluxDB는 읽기 전용 복제본 클러스터에 대해 **즉시 적용** 업데이트만 지원합니다. 변경 사항을 확인하면 변경 사항이 적용되는 동안 DB 클러스터에 가동 중지 시간이 발생합니다.

------
#### [ Using the AWS CLI ]

를 사용하여 DB 인스턴스를 수정하려면 다음 파라미터와 함께 `update-db-cluster` 명령을 AWS Command Line Interface사용합니다. *user input placeholder*를 사용자의 정보로 바꿉니다.

```
aws timestream-influxdb update-db-cluster \
      --region region \
      --db-cluster-id db-cluster-id \                      
      --db-instance-type db.influx.4xlarge \
      --port 10000 \
      --failover mode NO_FAILOVER
```

------

## 읽기 전용 복제본 클러스터 수정 설정
<a name="timestream-for-influx-rr-modify-settings"></a>

읽기 전용 복제본 클러스터를 수정하는 데 사용할 수 있는 설정에 대한 자세한 내용은 다음 표를 참조하세요. AWS CLI 옵션에 대한 자세한 내용은 [update-db-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/timestream-influxdb/update-db-cluster.html)를 참조하세요.


****  

| 콘솔 설정 | 설정 설명 | CLI 옵션 및 Timestream for InfluxDB API 파라미터 | 
| --- | --- | --- | 
| 데이터베이스 포트 | InfluxDB가 연결을 허용하는 포트 번호입니다. 유효한 값: 1,024\$165,535 기본값: 8086 제약 조건: 값은 2,375\$12,376, 7,788\$17,799, 8,090 또는 51,678\$151,680일 수 없습니다.  |  **CLI 옵션: ** `--port` **API 파라미터: **`port`  | 
| DB 인스턴스 유형 | Timestream for InfluxDB DB 클러스터에 있는 각 DB 인스턴스의 컴퓨팅 및 메모리 용량입니다(예: db.influx.xlarge). 가능하면 일반 쿼리 작업 세트가 메모리에 상주할 수 있을 정도로 큰 DB 인스턴스 클래스를 선택합니다. 작업 세트가 메모리에 상주할 경우 시스템의 디스크 쓰기가 불필요하여 성능이 향상됩니다. |  **CLI 옵션: ** `--db-instance-type` **API 파라미터: **`dbInstanceType`  | 
| DB 클러스터 파라미터 그룹 |  DB 클러스터에 할당할 DB 파라미터 그룹의 ID입니다. DB 파라미터 그룹은 데이터베이스가 구성되는 방식을 지정합니다. 예를 들어, DB 파라미터 그룹은 쿼리 동시성에 대한 제한을 지정할 수 있습니다. |  **CLI 옵션: ** `--db-parameter-group-identifier` **API 파라미터: **`dbParameterGroupIdentifier`  | 
| 로그 내보내기 |  지정된 S3 버킷으로 InfluxDB 엔진 로그를 전송하기 위한 구성 S3 버킷 로그 전송을 위한 구성: `s3Configuration -> (structure)` 로그를 보낼 S3 버킷의 이름: `bucketName -> (string)` S3 버킷으로 로그 전송이 활성화되었는지 여부 표시: `enabled -> (boolean)` 간편 구문: `s3Configuration={bucketName=string, enabled=boolean}`  |  **CLI 옵션: ** `--log-delivery-configuration` **API 파라미터: **`logDeliveryConfiguration`  | 
| 장애 조치 모드 | 다음 옵션을 사용하여 클러스터가 프라이머리 인스턴스 장애에 대응하는 방식을 구성합니다.`AUTOMATIC`: 프라이머리 인스턴스에 장애가 발생하면 시스템은 자동으로 읽기 전용 복제본을 새 프라이머리 인스턴스로 승격합니다. `NO_FAILOVER`: 프라이머리 인스턴스에 장애가 발생하면 시스템은 읽기 전용 복제본을 승격하지 않고 프라이머리 인스턴스 복원을 시도합니다. 클러스터는 프라이머리 인스턴스가 복원될 때까지 사용 불가 상태를 유지합니다.  | **CLI 옵션: ** `--failover-mode` **API 파라미터: **`failoverMode` | 

# Amazon Timestream for InfluxDB에서 읽기 전용 복제본 클러스터 재부팅
<a name="timestream-for-influx-rebooting-rr-cluster"></a>

상태 문제가 발생할 경우 읽기 전용 복제본 클러스터를 재부팅할 수 있습니다.

## Amazon Timestream for InfluxDB에 대한 읽기 전용 복제본 클러스터 재부팅
<a name="timestream-for-influx-rebooting-rr-db-cluster"></a>

------
#### [ Using the AWS Management Console ]

콘솔을 사용하여 읽기 전용 복제본 DB 클러스터를 재부팅하려면:

1. [AWS Management Console](https://console.aws.amazon.com/timestream)에 로그인하고 Amazon Timestream 콘솔을 엽니다.

1. 탐색 창에서 **InfluxDB 데이터베이스를** 선택한 다음 재부팅하려는 읽기 전용 복제본 클러스터를 선택합니다.

1. **데이터베이스 다시 시작**을 선택합니다.

1. **확인 및 재시작**을 선택합니다.

------
#### [ Using the AWS CLI ]

를 사용하여 DB 인스턴스를 재부팅하려면 다음 파라미터와 함께 `reboot-db-cluster` 명령을 AWS Command Line Interface사용합니다. *user input placeholder*를 사용자의 정보로 바꿉니다.

```
aws timestream-influxdb reboot-db-cluster \
      --region region \
      --db-cluster-id db-cluster-id \
```

------

# Amazon Timestream for InfluxDB 모니터링을 위한 CloudWatch 경보 생성
<a name="timestream-for-influx-creating-cw-alarms"></a>

경보로 인해 상태가 변경되면 Amazon SNS 메시지를 보내는 CloudWatch 경보를 생성할 수 있습니다. 경보는 지정한 기간 동안 단일 지표를 감시합니다. 또한 경보는 여러 기간에 대해 주어진 임계값과 지표 값을 비교하여 하나 이상의 작업을 수행할 수 있습니다. 이 작업은 Amazon SNS 주제나 Amazon EC2 Auto Scaling 정책으로 전송되는 알림입니다.

경보는 지속적인 상태 변경에 대해서만 작업을 호출합니다. CloudWatch 경보는 특정 상태에 있다고 해서 작업을 호출하지는 않습니다. 상태가 변경되어 지정된 기간 동안 유지되어야 합니다.

`CPUUtilization`, `MemoryUtilization`, `DiskUtilization`, `ReplicaLag`를 포함하여 Timestream for InfluxDB에 사용 가능한 모든 지표에 대해 CloudWatch 경보를 설정할 수 있습니다.

스토리지 공간 부족 문제는 InfluxDB에 큰 문제가 될 수 있으므로 Timestream for InfluxDB 데이터베이스에 대한 `DiskUtilization` 관련 경보 생성을 시작하는 것이 좋습니다. `DiskUtilization`이 약 75\$180%를 넘을 때마다 알림을 보내도록 설정하는 것이 좋습니다.

## 를 사용하여 경보를 설정하려면 AWS CLI
<a name="timestream-for-influx-alarm-cli"></a>

`put-metric-alarm`를 호출합니다. 자세한 내용은 *AWS CLI 명령 레퍼런스*의 [put-metric-alarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-alarm.html)을 참조하세요.

## CloudWatch API를 사용하여 경보 설정
<a name="timestream-for-influx-alarm-api"></a>

`PutMetricAlarm`를 호출합니다. 자세한 내용은 *Amazon CloudWatch API 참조*의 [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)을 참조하세요. Amazon SNS 주제 및 경보 설정에 대한 자세한 내용은 [Amazon CloudWatch 경보 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)을 참조하세요.

## 자습서: Amazon Timestream for InfluxDB에 대한 다중 AZ 클러스터 복제본 지연에 대한 Amazon CloudWatch 경보 생성
<a name="timestream-for-influx-tutorial-alarm"></a>

다중 AZ DB 클러스터의 복제본 지연이 임계값을 초과하면 Amazon SNS 메시지를 보내는 Amazon CloudWatch 경보를 생성할 수 있습니다. 경보는 지정한 기간 동안 `ReplicaLag` 지표를 감시합니다. 이 작업은 Amazon SNS 주제나 Amazon EC2 Auto Scaling 정책으로 전송되는 알림입니다.

### 다중 AZ DB 클러스터 복제본 지연에 대한 CloudWatch 경보 설정
<a name="timestream-for-influx-alarm-tutorial-steps"></a>

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch) CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **경보**, **모든 경보**를 차례로 선택합니다.

1. **경보 생성**을 선택합니다.

1. **지표 및 조건 지정(Specify metric and conditions)** 페이지에서 **지표 선택(Select metric)**을 선택합니다.

1. 검색 상자에 DB 클러스터의 이름을 입력하고 **Timestream/InfluxDB**, **By DbCluster**를 선택한 다음 클러스터를 선택합니다.  
![\[빈 CloudWatch 그래프와 2개의 선택 가능한 Timestream for InfluxDB 정렬 옵션이 표시된 지표 선택 페이지.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/select_metric_page.png)

1. 다음 이미지는 `inframonitoringcluster`라는 읽기 전용 복제본 클러스터가 선택된 **지표 선택** 페이지를 보여줍니다. 경보를 생성할 지표를 선택합니다. 이 경우에는 `ReplicaLag`입니다. **지표 선택**을 클릭합니다.  
![\[빈 CloudWatch 그래프와 7개의 선택 가능한 CloudWatch 지표가 표시된 지표 선택 페이지.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/select_metric_cluster_selected.png)

1. **지표 및 조건 지정** 페이지에서 다음 필드를 사용자 지정합니다.  
![\[Inframonitoringcluster 클러스터에 대해 선택한 설정이 표시된 지표 및 조건 지정 페이지.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/replica_lag_metrics_conditions.png)

   1. **기간** 섹션에서 계산할 기간을 선택합니다.

   1. 경보와 관련된 조건을 설정합니다. **임곗값 유형**에서 **정적**과 **이상 탐지** 중에서 선택할 수 있습니다.

      이 경우 워크로드가 어떻게 작동하는지 알기 때문에 **정적**을 사용합니다. ‘정상’으로 간주되는 기준은 워크로드마다 다를 수 있습니다.

   1. 임곗값을 선택합니다. **정적** 임곗값의 경우 밀리초 단위입니다.

   1. **다음**을 선택합니다.

1. **작업 구성** 페이지의 **알림** 섹션에서 다음 설정을 사용자 지정합니다.  
![\[서로 다른 6개 작업의 목록이 표시된 작업 구성 페이지. 알림 섹션이 완료되었습니다.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/configure_actions.png)

   1. **경보 상태 트리거**에서 **경보 내**를 선택합니다.

   1. **다음 SNS 주제로 알림 전송**에서 **새 주제 생성**을 선택합니다.

   1. 고유한 주제 이름과 알림을 받을 유효한 이메일 주소를 입력합니다.

   1. **주제 생성**을 선택합니다. 아래로 스크롤하여 **Next(다음)**를 선택합니다.

1. **이름 및 설명 추가** 페이지에서 **경보 이름** 및 **경보 설명**을 입력합니다. **다음**을 선택합니다.  
![\[경보 이름 및 경보 설명에 대한 필드가 표시된 이름 및 설명 추가 페이지.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/add_name_desc.png)

1. **미리 보기 및 생성** 페이지에서 경보 설정을 검토하고 **경보 생성**을 선택합니다.

**중요**  
Timestream for InfluxDB 클러스터를 정상 상태로 유지하려면 `CPUUtilization`과 `MemoryUtilization`이 지속적으로 정상 범위를 초과하는 85% 이상으로 유지되는 경우와 `DiskUtilization`이 75%를 초과하는 경우를 모니터링하고 경보를 생성하는 것이 좋습니다.

# 를 통해 복제본 라이선스 읽기 AWS Marketplace
<a name="timestream-for-influx-rr-licensing"></a>

Timestream for InfluxDB 읽기 전용 복제본을 사용하려면 Timestream for InfluxDB 읽기 전용 복제본 추가 기능 라이선스를 활성화해야 합니다 AWS Marketplace. 라이선스가 활성화되면 읽기 전용 복제본 클러스터 사용 시 시간당 요금을 지불합니다. 읽기 전용 복제본 클러스터가 활성화된 시간에 대해서만 비용을 지불합니다. 라이선스를 구독하지만 활성 Timestream for InfluxDB 읽기 전용 복제본 클러스터가 없는 경우 요금이 부과되지 않습니다.

**Topics**
+ [읽기 전용 복제본 라이선스 용어](#timestream-for-influx-rr-licensing-terminology)
+ [결제 및 청구](#timestream-for-influx-rr-license-billing)
+ [Marketplace 목록의 InfluxDB 읽기 전용 복제본 추가 기능 구독](#timestream-for-influx-subscribe-rr-add-on)

## 읽기 전용 복제본 라이선스 용어
<a name="timestream-for-influx-rr-licensing-terminology"></a>

이 페이지에서는 Amazon Timestream for InfluxDB 통합에 대해 설명할 때 다음 용어를 사용합니다 AWS Marketplace.

**SaaS 구독**  <a name="saassub"></a>
에서 pay-as-you-go제 라이선스 모델과 같은 서비스형 AWS Marketplace소프트웨어(SaaS) 제품은 사용량 기반 구독 모델을 채택합니다. software-as-a-service 읽기 전용 복제본 추가 기능의 소프트웨어 판매자인 InfluxData는 사용량을 추적하고, 고객은 사용한 만큼 요금을 지불합니다.

**InfluxData Marketplace 요금**  <a name="influxdatafees"></a>
InfluxData에서 InfluxDB 읽기 전용 복제본 추가 기능 소프트웨어 라이선스 사용에 대해 부과하는 요금입니다. 이러한 서비스 요금은를 통해 측정 AWS Marketplace 되며 AWS Marketplace 섹션 아래의 AWS 청구서에 표시됩니다.

**Amazon Timestream for InfluxDB 요금**  <a name="timestreamfees"></a>
Amazon Timestream for InfluxDB 서비스 AWS 요금이 부과되며, InfluxDB용 Timestream 읽기 전용 복제본 클러스터를 사용할 때 라이선스가 제외됩니다. 요금은 사용 중인 Amazon Timestream for InfluxDB 서비스를 통해 측정되며 AWS 청구서에 표시됩니다.

## 결제 및 청구
<a name="timestream-for-influx-rr-license-billing"></a>

Timestream for InfluxDB는와 통합되어 읽기 전용 복제본 추가 기능에 시간당 pay-as-you-go제 라이선스를 AWS Marketplace 제공합니다. 읽기 전용 복제본 Marketplace 요금에는 읽기 전용 복제본 추가 기능의 라이선스 비용이 포함되고, Amazon Timestream 요금에는 Timestream for InfluxDB 읽기 전용 복제본 클러스터 사용 비용이 포함됩니다. 요금에 대한 자세한 내용은 [Amazon Timestream 요금](https://aws.amazon.com/timestream/pricing)을 참조하세요.

이러한 요금을 중지하려면 Timestream for InfluxDB 읽기 전용 복제본 클러스터를 삭제해야 합니다. 또한 읽기 전용 복제본 추가 기능 라이선스에 AWS Marketplace 대한 구독을 제거할 수 있습니다. 읽기 전용 복제본 클러스터를 삭제하지 않고 구독을 제거하는 경우 Amazon Timestream은 읽기 전용 복제본 클러스터 사용에 대해 계속해서 요금을 청구합니다. 자세한 내용은 [복제본 삭제 시 고려 사항](timestream-for-influx-read-replica-overview.md#timestream-for-influx-rr-deletion) 단원을 참조하십시오.

 AWS Billing 콘솔에서 Timestream for InfluxDB 읽기 전용 복제본 클러스터에 대한 청구서를 보고 결제를 관리할 수 있습니다. 청구서에는 InfluxData의 라이선스가 부여된 추가 기능 사용에 대한 요금 AWS Marketplace과 Amazon Timestream 사용에 대한 요금이라는 두 가지 요금이 포함됩니다. 청구에 대한 자세한 내용은 *AWS 결제 및 비용 관리 사용 설명서*의 [Understanding your bill](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/getting-viewing-bill.html)을 참조하세요.

## Marketplace 목록의 InfluxDB 읽기 전용 복제본 추가 기능 구독
<a name="timestream-for-influx-subscribe-rr-add-on"></a>

를 통해 읽기 전용 복제본 추가 기능 라이선스를 사용하려면 Amazon Timestream AWS Management Console 을 사용하여 InfluxDB 읽기 전용 복제본 추가 기능을 구독 AWS Marketplace해야 합니다. AWS CLI 또는 Timestream for InfluxDB API를 통해 이러한 작업을 완료할 수 없습니다.

**Topics**
+ [Amazon Timestream 구독 AWS Management Console](#timestream-for-influx-subscribe-console)
+ [에서 InfluxDB 읽기 전용 복제본 추가 기능 구독 AWS Marketplace](#timestream-for-influx-subscribe-marketplace)

**참고**  
 AWS CLI 또는 Timestream for InfluxDB API를 사용하여 읽기 전용 복제본 클러스터를 생성하려면 먼저이 단계를 완료해야 합니다.

### Amazon Timestream 구독 AWS Management Console
<a name="timestream-for-influx-subscribe-console"></a>

Timestream Management Console을 사용하여 InfluxDB 읽기 전용 복제본 추가 기능을 구독할 수 있습니다. **InfluxDB 데이터베이스 생성** 흐름을 시작하고 단계를 따르세요. 자세한 내용은 [Timestream for InfluxDB 읽기 전용 복제본 클러스터 생성](timestream-for-influx-create-rr-cluster.md) 단원을 참조하십시오.

### 에서 InfluxDB 읽기 전용 복제본 추가 기능 구독 AWS Marketplace
<a name="timestream-for-influx-subscribe-marketplace"></a>

InfluxDB 추가 기능 라이선스를와 함께 사용하려면 InfluxDB 읽기 전용 복제본 추가 기능에 대한 활성 AWS Marketplace 구독이 AWS Marketplace있어야 합니다. 단일 추가 기능 오퍼를 구독해야 하며, 이를 통해 사용 가능한 모든 리전에서 필요한 인스턴스 유형을 생성할 수 있습니다. AWS Marketplace 구독에 대한 자세한 내용은 *AWS Marketplace 구매자 설명서*의 [SaaS products through AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-saas-products.html#saas-pricing-models)를 참조하세요.

DB 인스턴스 생성을 시작하기 *전에* AWS Marketplace 에서 InfluxDB를 구독하는 것이 좋습니다.

1. [AWS Marketplace](https://console.aws.amazon.com/marketplace)로 이동하고 InfluxData를 검색합니다.  
![\[AWS Marketplace 검색에 표시되는 InfluxDB 읽기 전용 복제본 추가 기능의 Timestream입니다.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/search_mkt_influxdb.png)

1. **Timestream for InfluxDB 읽기 전용 복제본(추가 기능)**을 선택합니다.

1. **구매 옵션 보기**를 선택합니다.

1. 최종 사용자 라이선스 계약을 검토하고 **구독**을 선택합니다.  
![\[Timestream for InfluxDB 읽기 전용 복제본 추가 기능에 대한 오퍼 및 요금 세부 정보.\]](http://docs.aws.amazon.com/ko_kr/timestream/latest/developerguide/images/kronos/addon_details.png)

1. 이제 Timestream Management Console, CLI 또는 API를 사용하여 Timestream for InfluxDB 읽기 전용 복제본 클러스터를 생성할 수 있습니다.