# DB クラスターに Aurora レプリカを追加する
レプリケーションがある Aurora DB クラスターには、1 つのプライマリ DB インスタンスと最大 15 の Aurora レプリカがあります。プライマリ DB インスタンスは読み書きオペレーションをサポートし、クラスターボリュームに対するすべてのデータ変更を実行します。Aurora レプリカは、プライマリ DB インスタンスと同じストレージボリュームに接続しますが、読み取りオペレーションのみサポートしています。Aurora レプリカを使用して、プライマリ DB インスタンスから読み取りワークロードをオフロードします。詳細については、「[Aurora レプリカ](Aurora.Replication.md#Aurora.Replication.Replicas)」を参照してください。
Amazon Aurora レプリカには以下の制限事項があります。
+ Aurora Serverless v1 DB クラスターの Aurora レプリカを作成することはできません。Aurora Serverless v1 には、データベースのすべての読み取りおよび書き込みオペレーションをサポートするために、自動的にスケールアップおよびスケールダウンする単一の DB インスタンスがあります。
ただし、リーダーインスタンスを Aurora Serverless v2 DB クラスターに追加することはできます。詳細については、「[Aurora Serverless v2 リーダーの追加](aurora-serverless-v2-administration.md#aurora-serverless-v2-adding-reader)」を参照してください。
Aurora DB クラスターのプライマリインスタンスと Aurora レプリカを複数のアベイラビリティーゾーンに分散させて、DB クラスターの可用性を改善することをお勧めします。詳細については、「[リージョンの可用性](Concepts.RegionsAndAvailabilityZones.md#Aurora.Overview.Availability)」を参照してください。
Aurora レプリカを Aurora DB クラスターから削除するには、「[Aurora DB クラスターからの DB インスタンスの削除](USER_DeleteCluster.md#USER_DeleteInstance)」の手順に従って、Aurora レプリカ DB インスタンスを削除します。
**注記**
Amazon Aurora では、RDS DB インスタンスなどの外部データベースとのレプリケーションもサポートします。RDS DB インスタンスは、Amazon Aurora と同じ AWS リージョンにある必要があります。詳細については、「[Amazon Aurora でのレプリケーション](Aurora.Replication.md)」を参照してください。
Aurora レプリカを DB クラスターに追加するには AWS マネジメントコンソール、AWS CLI、または RDS API を使用します。
## コンソール
**Aurora レプリカを DB クラスターに追加するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。
1. ナビゲーションペインで、[**データベース**] を選択し、新しい DB インスタンスを追加する DB クラスターを選択します。
1. クラスターとプライマリインスタンスの両方が [**使用可能**] 状態であることを確認します。DB クラスターまたはプライマリインスタンスが [**作成中**] などの移行状態にある場合、レプリカを追加することはできません。
クラスターにプライマリインスタンスがない場合は、[create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI コマンドを使用してプライマリインスタンスを作成します。この状況は、CLI を使用して DB クラスタースナップショットを復元し、AWS マネジメントコンソール でクラスターを表示した場合に発生する可能性があります。
1. [**アクション**] で、[**リーダーの追加**] を選択します。
[**リーダーの追加**] ページが表示されます。
1. [**リーダーの追加**] ページで、Aurora レプリカのオプションを指定します。次の表は、Aurora レプリカの設定を示しています。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/aurora-replicas-adding.html)
1. [**リーダーの追加**] を選択して、Aurora レプリカを作成します。
## AWS CLI
DB クラスターに Aurora レプリカを作成するには、AWS CLI コマンドの [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) を実行します。`--db-cluster-identifier` オプションとして DB クラスターの名前を含めます。次の例に示すように、オプションで `--availability-zone` パラメータを使用して Aurora レプリカのアベイラビリティーゾーンを指定できます。
例えば、次のコマンドは `sample-instance-us-west-2a` という名前の新しい MySQL 5.7 互換 Aurora レプリカを作成します。
Linux、macOS、Unix の場合:
```
aws rds create-db-instance --db-instance-identifier sample-instance-us-west-2a \
--db-cluster-identifier sample-cluster --engine aurora-mysql --db-instance-class db.r5.large \
--availability-zone us-west-2a
```
Windows の場合:
```
aws rds create-db-instance --db-instance-identifier sample-instance-us-west-2a ^
--db-cluster-identifier sample-cluster --engine aurora-mysql --db-instance-class db.r5.large ^
--availability-zone us-west-2a
```
次のコマンドは、`sample-instance-us-west-2a` という名前の新しい MySQL 5.7 互換 Aurora レプリカを作成します。
Linux、macOS、Unix の場合:
```
aws rds create-db-instance --db-instance-identifier sample-instance-us-west-2a \
--db-cluster-identifier sample-cluster --engine aurora-mysql --db-instance-class db.r5.large \
--availability-zone us-west-2a
```
Windows の場合:
```
aws rds create-db-instance --db-instance-identifier sample-instance-us-west-2a ^
--db-cluster-identifier sample-cluster --engine aurora --db-instance-class db.r5.large ^
--availability-zone us-west-2a
```
次のコマンドは `sample-instance-us-west-2a` という名前の新しい PostgreSQL 互換 Aurora レプリカを作成します。
Linux、macOS、Unix の場合:
```
aws rds create-db-instance --db-instance-identifier sample-instance-us-west-2a \
--db-cluster-identifier sample-cluster --engine aurora-postgresql --db-instance-class db.r5.large \
--availability-zone us-west-2a
```
Windows の場合:
```
aws rds create-db-instance --db-instance-identifier sample-instance-us-west-2a ^
--db-cluster-identifier sample-cluster --engine aurora-postgresql --db-instance-class db.r5.large ^
--availability-zone us-west-2a
```
## RDS API
DB クラスターに Aurora レプリカを作成するには、[CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) オペレーションを呼び出します。`DBClusterIdentifier` パラメータとして DB クラスターの名前を含めます。オプションで、`AvailabilityZone` パラメータを使用して Aurora レプリカのアベイラビリティーゾーンを指定できます。
Aurora レプリカでの Amazon Aurora の Auto Scaling については、以下のセクションを参照してください。
**Topics**
+ [Aurora レプリカでの Amazon Aurora Auto Scaling](Aurora.Integrating.AutoScaling.md)
+ [Amazon Aurora DB クラスターへの自動スケーリングポリシーの追加](Aurora.Integrating.AutoScaling.Add.md)
+ [Amazon Aurora DB クラスターの自動スケーリングポリシーの編集](Aurora.Integrating.AutoScaling.Edit.md)
+ [Amazon Aurora DB クラスターからの自動スケーリングポリシーの削除](Aurora.Integrating.AutoScaling.Delete.md)
# Aurora レプリカでの Amazon Aurora Auto Scaling
接続およびワークロード要件を満たすために、Aurora Auto Scaling は、Aurora DB クラスター用にプロビジョニングされる Aurora レプリカ (リーダー DB インスタンス) の数を動的に調整します。Aurora Auto Scaling は、Aurora MySQL と Aurora PostgreSQL の両方で使用できます。Aurora Auto Scaling により、お使いの Aurora DB クラスターは急激な接続やワークロードの増加を処理できます。接続やワークロードが減ると、Aurora Auto Scaling は未使用のプロビジョニングされた DB インスタンスに対する料金が発生しないように、不要な Aurora レプリカを削除します。
スケーリングポリシーを定義して Aurora DB クラスターに適用します。*スケーリングポリシー*は、Aurora Auto Scaling で管理できる Aurora レプリカの最小数と最大数を定義します。そのポリシーに基づいて、Aurora Auto Scaling は Amazon CloudWatch メトリクスとターゲット値を使用して決定される実際のワークロードに応じて、Aurora レプリカの数を上下に調整します。
**注記**
Aurora Auto Scaling は、ライター DB インスタンスのワークロードには適用されません。Aurora Auto Scaling は、リーダーインスタンス上のワークロードにのみ役立ちます。
AWS マネジメントコンソール を使用し、事前定義されたメトリクスに基づいてスケーリングポリシーを適用できます。代わりに、AWS CLI または Aurora Auto Scaling API を使用し、事前定義済みまたはカスタムのメトリクスに基づいたスケーリングポリシーを適用することも可能です。
**Topics**
+ [開始する前に](#Aurora.Integrating.AutoScaling.BYB)
+ [Aurora Auto Scaling ポリシー](#Aurora.Integrating.AutoScaling.Concepts)
+ [DB インスタンス ID とタグ付け](#Aurora.Integrating.AutoScaling.Concepts.Tagging)
+ [Aurora Auto Scaling と Performance Insights](#aurora-auto-scaling-pi)
## 開始する前に
Aurora DB クラスターで Aurora Auto Scaling を使用する前に、まず、プライマリ (書き込み) DB インスタンスで Aurora DB クラスターを作成する必要があります。Aurora DB クラスター作成の詳細については、「[Amazon Aurora DB クラスターの作成](Aurora.CreateInstance.md)」を参照してください。
Aurora Auto Scaling は、DB クラスターが利用可能な状態にある場合のみ、DB クラスターをスケーリングします。
Aurora Auto Scaling が新しい Aurora レプリカを追加すると、その新しい Aurora レプリカはプライマリインスタンスが使用するのと同じ DB インスタンスクラスになります。DB インスタンスクラスの詳細については、「[Amazon Aurora DB インスタンスクラス](Concepts.DBInstanceClass.md)」を参照してください。また、新しい Aurora レプリカの昇格階層は、最も低い優先順位 (デフォルトでは 15) に設定されています。つまり、フェイルオーバー時には、手動で作成されたものなど、優先順位の高いレプリカが最初に昇格されます。詳細については、「[Aurora DB クラスターの耐障害性](Concepts.AuroraHighAvailability.md#Aurora.Managing.FaultTolerance)」を参照してください。
Aurora Auto Scaling では、自身が作成した Aurora レプリカのみ削除されます。
Aurora Auto Scaling から益を得るには、お使いのアプリケーションが新しい Aurora レプリカへの接続をサポートしている必要があります。これを行うには、Aurora 読み込みエンドポイントを使用することをお勧めします。AWS JDBC ドライバーなどのドライバーを使用できます。詳細については、「[Amazon Aurora DB クラスターへの接続](Aurora.Connecting.md)」を参照してください。
**注記**
Aurora グローバルデータベースは、現在、セカンダリ DB クラスターの Aurora Auto Scaling をサポートしていません。
## Aurora Auto Scaling ポリシー
Aurora Auto Scaling はスケーリングポリシーを使用して、Aurora DB クラスターの Aurora レプリカ数を調整します。Aurora Auto Scaling には以下のコンポーネントがあります。
+ サービスにリンクされたロール
+ ターゲットメトリクス
+ 最小容量と最大容量
+ クールダウン期間
**Topics**
+ [サービスにリンクされたロール](#Aurora.Integrating.AutoScaling.Concepts.SLR)
+ [ターゲットメトリクス](#Aurora.Integrating.AutoScaling.Concepts.TargetMetric)
+ [最小容量と最大容量](#Aurora.Integrating.AutoScaling.Concepts.Capacity)
+ [クールダウン期間](#Aurora.Integrating.AutoScaling.Concepts.Cooldown)
+ [スケールインアクティビティの有効化または無効化](#Aurora.Integrating.AutoScaling.Concepts.ScaleIn)
+ [自動スケーリングポリシーの追加、編集、または削除](#Aurora.Integrating.AutoScaling.Concepts.AddEditDelete)
### サービスにリンクされたロール
Aurora Auto Scaling は、サービスにリンクされたロール `AWSServiceRoleForApplicationAutoScaling_RDSCluster` を使用します。詳細については、*Application Auto Scaling ユーザーガイド*の「[Application Auto Scaling のサービスにリンクされたロール](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-service-linked-roles.html)」を参照してください。
### ターゲットメトリクス
このタイプのポリシーでは、ターゲット追跡スケーリングポリシー設定で、事前定義されたメトリクスまたはカスタムメトリクスとそのメトリクスのターゲット値を指定します。Aurora Auto Scaling は、スケーリングポリシーをトリガーする CloudWatch アラームを作成および管理し、メトリクスとターゲット値に基づいてスケーリング調整値を計算します。スケーリングポリシーは、指定されたターゲット値、またはそれに近い値にメトリクスを維持するため、必要に応じて Aurora レプリカを追加または削除します。メトリクスをターゲット値に近い値に維持することに加えて、ターゲット追跡スケーリングポリシーは、変化するワークロードによるメトリクスの変動に適応します。そのようなポリシーは、DB クラスターに使用可能な Aurora レプリカ数の急速な変動の最小化もします。
例として、事前定義された平均 CPU 使用率メトリクスを使用するスケーリングポリシーを挙げましょう。そのようなポリシーは、40 パーセントなどの指定された使用率に、またはそれに近い割合に CPU 使用率を維持できます。
**注記**
各 Aurora DB クラスターについては、各ターゲットメトリクスに対して 1 つの Auto Scaling ポリシーのみを作成できます。
Aurora Auto Scaling を設定すると、ターゲットメトリクス値はクラスター内のすべてのリーダーインスタンスの平均として計算されます。この計算は次のように行います。
+ Auto Scaling で管理するか、手動で追加するかにかかわらず、Aurora クラスター内のすべてのリーダーインスタンスを含めます。
+ カスタムエンドポイントに関連付けられたインスタンスを含めます。カスタムエンドポイントは、ターゲットメトリクスの計算に影響しません。
+ クラスターのライターインスタンスは含めません。
メトリクスは、次のディメンションを使用して CloudWatch から取得します。
+ `DBClusterIdentifier`
+ `Role=READER`
例えば、次の設定の Aurora MySQL クラスターを考えてみます。
+ **手動インスタンス (Auto Scaling では制御されない)**:
+ CPU 使用率が 50% のライター
+ CPU 使用率が 90% のリーダー 1 (カスタムエンドポイント: `custom-reader-1`)
+ CPU 使用率が 90% のリーダー 2 (カスタムエンドポイント: `custom-reader-2`)
+ **Auto Scaling インスタンス**:
+ CPU 使用率が 10% のリーダー 3 (Auto Scaling を使用して追加)
このシナリオでは、Auto Scaling ポリシーのターゲットメトリクスは次のように計算されます。
```
Target metric = (CPU utilization of reader 1 + reader 2 + reader 3) / total number of readers
Target metric = (90 + 90 + 10) / 3 = 63.33%
```
Auto Scaling ポリシーは、この値を使用して、定義されたしきい値に基づいてスケールインするかスケールアウトするかを評価します。
以下の点を考慮してください。
+ カスタムエンドポイントはトラフィックを特定のリーダーにルーティングする方法を決定しますが、メトリクスの計算からリーダーを除外することはありません。
+ 手動インスタンスは常にターゲットメトリクスの計算に含まれます。
+ 予期しないスケーリング動作を回避するには、Auto Scaling 設定でクラスター内のすべてのリーダーインスタンスが考慮されていることを確認してください。
+ クラスターにリーダーがない場合、メトリクスは計算されず、Auto Scaling ポリシーアラームは非アクティブのままになります。Auto Scaling ポリシーが効果的に機能するには、常に少なくとも 1 つのリーダーが存在している必要があります。
### 最小容量と最大容量
アプリケーションの Auto Scaling が管理する Aurora レプリカの最大数を指定できます。この値は 0–15 に設定される必要があります。また、Aurora レプリカの最小数に指定された値以上である必要があります。
アプリケーションの Auto Scaling が管理する Aurora レプリカの最小数も指定できます。この値は 0–15 に設定される必要があります。また、Aurora レプリカの最大数に指定された値以下である必要があります。
Aurora Auto Scaling が機能するには、少なくとも 1 つのリーダー DB インスタンスが必要です。DB クラスターにリーダーインスタンスがなく、最小容量を 0 に設定すると、Aurora Auto Scaling は動作しません。
**注記**
最小容量と最大容量は、Aurora DB クラスターに対して設定されます。指定された値は、その Aurora DB クラスターに関連付けられたポリシーすべてに適用されます。
### クールダウン期間
Aurora DB クラスターのスケールインやスケールアウトに影響するクールダウン期間を追加することで、ターゲット追跡スケーリングポリシーの応答性を調整できます。クールダウン期間を設定すると、その期間が過ぎるまでその後のスケールインやスケールアウトのリクエストがブロックされます。これらのブロックにより、スケールインリクエストのための Aurora DB クラスターの Aurora レプリカの削除、およびスケールアウトリクエストのための Aurora レプリカの作成を遅らせます。
以下のクールダウン期間を指定できます。
+ スケールインアクティビティは、Aurora DB クラスターの Aurora レプリカ数を減らします。スケールインのクールダウン期間は、スケールインアクティビティが完了してから別のスケールインアクティビティが開始されるまでの時間 (秒) を指定します。
+ スケールアウトアクティビティは、Aurora DB クラスターの Aurora レプリカ数を増やします。スケールアウトのクールダウン期間は、スケールアウトアクティビティが完了してから別のスケールアウトアクティビティが開始されるまでの時間 (秒) を指定します。
**注記**
後続のスケールアウトのリクエストが最初のリクエストよりも多くの Aurora レプリカを対象とする場合、スケールアウトのクールダウン期間は無視されます。
スケールインやスケールアウトのクールダウン期間を設定しない場合、それぞれのデフォルト値は 300 秒です。
### スケールインアクティビティの有効化または無効化
ポリシーに対してスケールインアクティビティを有効化または無効化できます。スケールインアクティビティを有効にすると、スケーリングポリシーは Aurora レプリカを削除できます。スケールインアクティビティが有効な場合、スケーリングポリシーのスケールインのクールダウン期間がスケールインアクティビティに適用されます。スケールインアクティビティを無効にすると、スケーリングポリシーは Aurora レプリカを削除できなくなります。
**注記**
スケールアウトアクティビティは、スケーリングポリシーが必要に応じて Aurora レプリカを作成できるように、常に有効にしておきます。
### 自動スケーリングポリシーの追加、編集、または削除
AWS マネジメントコンソール、AWS CLI、または アプリケーションの Auto Scaling API を使用して自動スケーリングポリシーを追加、編集、または削除できます。自動スケーリングポリシーの追加、編集、削除の詳細については、以下のセクションを参照してください。
+ [Amazon Aurora DB クラスターへの自動スケーリングポリシーの追加](Aurora.Integrating.AutoScaling.Add.md)
+ [Amazon Aurora DB クラスターの自動スケーリングポリシーの編集](Aurora.Integrating.AutoScaling.Edit.md)
+ [Amazon Aurora DB クラスターからの自動スケーリングポリシーの削除](Aurora.Integrating.AutoScaling.Delete.md)
## DB インスタンス ID とタグ付け
Aurora Auto Scaling によってレプリカが追加されると、`application-autoscaling-` によってその DB インスタンス ID に `application-autoscaling-61aabbcc-4e2f-4c65-b620-ab7421abc123` などのプレフィックスが付けられます。
次のタグは DB インスタンスに自動的に追加されます。DB インスタンスの詳細ページの [**タグ**] タブで確認できます。
| Tag | 値 |
| --- | --- |
| application-autoscaling:resourceId | cluster:mynewcluster-cluster |
Amazon RDS リソースタグの詳細については、「[Amazon Aurora および Amazon RDS リソースのタグ付け](USER_Tagging.md)」を参照してください。
## Aurora Auto Scaling と Performance Insights
Performance Insights を使用すると、他の Aurora リーダー DB インスタンスと同様に、Aurora Auto Scaling によって追加されたレプリカをモニタリングできます。
Performance Insights を使用して Aurora DB クラスターをモニタリングする方法の詳細については、「[Amazon Aurora での Performance Insights を使用したDB 負荷のモニタリング](USER_PerfInsights.md)」を参照してください。
# Amazon Aurora DB クラスターへの自動スケーリングポリシーの追加
AWS マネジメントコンソール、AWS CLI、または アプリケーションの Auto Scaling API を使用してスケーリングポリシーを追加できます。
**注記**
CloudFormation を使用してスケーリングポリシーを追加する例については、*AWS CloudFormation ユーザーガイド*の「[Aurora DB クラスターのスケーリングポリシーの宣言](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/quickref-autoscaling.html#w2ab1c19c22c15c21c11)」を参照してください。
## コンソール
AWS マネジメントコンソール を使用して、Aurora DB クラスターにスケーリングポリシーを追加できます。
**Aurora DB クラスターに Auto Scaling ポリシーを追加するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。
1. ナビゲーションペインで、[**データベース**] を選択します。
1. ポリシーを追加する Aurora DB クラスターを選択します。
1. [**ログとイベント**] タブを選択します。
1. [**Auto Scaling policies (Auto Scaling ポリシー)**] セクションで、[**Add (追加)**] を選択します。
[**Add Auto Scaling policy**] ダイアログボックスが表示されます。
1. [**ポリシー名**] に、ポリシー名を入力します。
1. ターゲットメトリクスには、以下のいずれかを選択します。
+ 平均 CPU 使用率に基づいてポリシーを作成するための [**Aurora レプリカの平均 CPU 使用率**]。
+ Aurora レプリカへの平均接続数に基づいてポリシーを作成するための [**Aurora レプリカの平均接続数**]。
1. ターゲット値には、以下のいずれかを入力します。
+ 前のステップで [**Aurora レプリカの平均 CPU 使用率**] を選択した場合、Aurora レプリカに維持する CPU 使用率を入力します。
+ 前のステップで [**Aurora レプリカの平均接続数**] を選択した場合は、維持する接続数を入力します。
Aurora レプリカが追加または削除され、メトリクスが指定された値に近い値に維持されます。
1. (省略可能) **[Additional Configuration]** (追加設定) を展開し、スケールインまたはスケールアウトのクールダウン期間を作成します。
1. [**Minimum capacity (最小キャパシティー)**] には、Aurora Auto Scaling ポリシーが維持する必要がある Aurora レプリカの最小数を入力します。
1. [**Maximum capacity (最大キャパシティー)**] には、Aurora Auto Scaling ポリシーが維持する必要がある Aurora レプリカの最大数を入力します。
1. [**Add policy**] を選択します。
次のダイアログボックスでは、Auto Scaling ポリシーを 40 パーセントの平均 CPU 使用率に基づいて作成します。このポリシーでは、最小 5 個の Aurora レプリカと最大 15 個の Aurora レプリカを指定します。
![\[平均 CPU 使用率に基づいた Auto Scaling ポリシーの作成\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/aurora-autoscaling-cpu.png)
次のダイアログボックスでは、平均接続数 100 に基づいて、Auto Scaling ポリシーを作成します。このポリシーでは、最小 2 個の Aurora レプリカと最大 8 個の Aurora レプリカを指定します。
![\[平均接続数に基づく Auto Scaling ポリシーの作成\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/aurora-autoscaling-connections.png)
## AWS CLI または Application Auto Scaling API
事前定義されたメトリクスまたはカスタムメトリクスに基づいて、スケーリングポリシーを適用できます。そのためには、AWS CLI または アプリケーションの Auto Scaling API を使用します。最初のステップでは、アプリケーションの Auto Scaling で Aurora DB クラスターを登録します。
### Aurora DB クラスターの登録
Aurora Auto Scaling を Aurora DB クラスターで使用可能にするには、アプリケーションの Auto Scaling で Aurora DB クラスターを登録します。これは、そのクラスターに適用するスケーリングのディメンションと制限を定義するためです。アプリケーションの Auto Scaling では、Aurora レプリカの数に対応したスケーラブルディメンション `rds:cluster:ReadReplicaCount` で、Aurora DB クラスターを動的にスケーリングします。
Aurora DB クラスターを登録するには、AWS CLI または アプリケーションの Auto Scaling API を使用します。
#### AWS CLI
Aurora DB クラスターを登録するには、以下のパラメータを指定しながら、AWS CLI コマンドの [https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/register-scalable-target.html](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/register-scalable-target.html) を使用します。
+ `--service-namespace` この値は に設定します。`rds`
+ `--resource-id` – Aurora DB クラスターのリソース識別子です。このパラメータでは、リソースタイプは `cluster` で、一意の識別子は Aurora DB クラスターの名前、例えば `cluster:myscalablecluster` です。
+ `--scalable-dimension` この値は に設定します。`rds:cluster:ReadReplicaCount`
+ `--min-capacity` – アプリケーションの Auto Scaling で管理するリーダー DB インスタンスの最小数。`--min-capacity`、`--max-capacity`、およびクラスター内の DB インスタンスの数の関係については、「[最小容量と最大容量](Aurora.Integrating.AutoScaling.md#Aurora.Integrating.AutoScaling.Concepts.Capacity)」を参照してください。
+ `--max-capacity` – アプリケーションの Auto Scaling で管理するリーダー DB インスタンスの最大数。`--min-capacity`、`--max-capacity`、およびクラスター内の DB インスタンスの数の関係については、「[最小容量と最大容量](Aurora.Integrating.AutoScaling.md#Aurora.Integrating.AutoScaling.Concepts.Capacity)」を参照してください。
**Example**
以下の例では、`myscalablecluster` という名前の Aurora DB クラスターを登録します。この登録は、DB クラスターが 1 から 8 個の Aurora レプリカを持つよう動的にスケールされることを示します。
Linux、macOS、Unix の場合:
```
aws application-autoscaling register-scalable-target \
--service-namespace rds \
--resource-id cluster:myscalablecluster \
--scalable-dimension rds:cluster:ReadReplicaCount \
--min-capacity 1 \
--max-capacity 8 \
```
Windows の場合:
```
aws application-autoscaling register-scalable-target ^
--service-namespace rds ^
--resource-id cluster:myscalablecluster ^
--scalable-dimension rds:cluster:ReadReplicaCount ^
--min-capacity 1 ^
--max-capacity 8 ^
```
#### Application Auto Scaling API
Aurora DB クラスターを アプリケーションの Auto Scaling に登録するには、以下のパラメータを指定して [https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_RegisterScalableTarget.html](https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_RegisterScalableTarget.html) アプリケーションの Auto Scaling API オペレーションを使用します。
+ `ServiceNamespace` この値は に設定します。`rds`
+ `ResourceID` – Aurora DB クラスターのリソース識別子です。このパラメータでは、リソースタイプは `cluster` で、一意の識別子は Aurora DB クラスターの名前、例えば `cluster:myscalablecluster` です。
+ `ScalableDimension` この値は に設定します。`rds:cluster:ReadReplicaCount`
+ `MinCapacity` – アプリケーションの Auto Scaling で管理するリーダー DB インスタンスの最小数。`MinCapacity`、`MaxCapacity`、およびクラスター内の DB インスタンスの数の関係については、「[最小容量と最大容量](Aurora.Integrating.AutoScaling.md#Aurora.Integrating.AutoScaling.Concepts.Capacity)」を参照してください。
+ `MaxCapacity` – アプリケーションの Auto Scaling で管理するリーダー DB インスタンスの最大数。`MinCapacity`、`MaxCapacity`、およびクラスター内の DB インスタンスの数の関係については、「[最小容量と最大容量](Aurora.Integrating.AutoScaling.md#Aurora.Integrating.AutoScaling.Concepts.Capacity)」を参照してください。
**Example**
以下の例では、`myscalablecluster` という名前の Aurora DB クラスターを アプリケーションの Auto Scaling API に登録します。この登録は、DB クラスターが 1～8 個の Aurora レプリカを持つよう動的にスケールされることを示します。
```
POST / HTTP/1.1
Host: autoscaling.us-east-2.amazonaws.com
Accept-Encoding: identity
Content-Length: 219
X-Amz-Target: AnyScaleFrontendService.RegisterScalableTarget
X-Amz-Date: 20160506T182145Z
User-Agent: aws-cli/1.10.23 Python/2.7.11 Darwin/15.4.0 botocore/1.4.8
Content-Type: application/x-amz-json-1.1
Authorization: AUTHPARAMS
{
"ServiceNamespace": "rds",
"ResourceId": "cluster:myscalablecluster",
"ScalableDimension": "rds:cluster:ReadReplicaCount",
"MinCapacity": 1,
"MaxCapacity": 8
}
```
### Aurora DB クラスターのスケーリングポリシーの定義
ターゲット追跡スケーリングポリシー設定は、メトリクスとターゲット値が定義されている JSON ブロックで表されます。JSON ブロックとしてスケーリングポリシー設定をテキストファイルに保存できます。このテキストファイルは、AWS CLI または アプリケーションの Auto Scaling API を呼び出す際に使用します。ポリシー設定構文の詳細については、*Application Auto Scaling API リファレンス*の「[https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_TargetTrackingScalingPolicyConfiguration.html](https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_TargetTrackingScalingPolicyConfiguration.html)」を参照してください。
ターゲット追跡スケーリングポリシー設定を定義するには、次のオプションを使用できます。
**Topics**
+ [事前定義メトリクスの使用](#Aurora.Integrating.AutoScaling.AddCode.DefineScalingPolicy.Predefined)
+ [カスタムメトリクスの使用](#Aurora.Integrating.AutoScaling.AddCode.DefineScalingPolicy.Custom)
+ [クールダウン期間の使用](#Aurora.Integrating.AutoScaling.AddCode.DefineScalingPolicy.Cooldown)
+ [スケールインアクティビティの無効化](#Aurora.Integrating.AutoScaling.AddCode.DefineScalingPolicy.ScaleIn)
#### 事前定義メトリクスの使用
定義済みのメトリクスを使用することにより、Aurora Auto Scaling のターゲット追跡と動的スケーリングの両方でうまく動作する Aurora DB クラスターのターゲット追跡スケーリングポリシーを迅速に定義できます。
現在、Aurora は、Aurora Auto Scaling で次の定義済みメトリクスをサポートしています。
+ **RDSReaderAverageCPUUtilization** – Aurora DB クラスター内のすべての Aurora レプリカでの CloudWatch の `CPUUtilization` メトリクスの平均値です。
+ **RDSReaderAverageDatabaseConnections** – Aurora DB クラスター内のすべての Aurora レプリカでの CloudWatch の `DatabaseConnections` メトリクスの平均値です。
`CPUUtilization` と `DatabaseConnections` メトリクスの詳細については、「[Amazon Aurora の Amazon CloudWatch メトリクス](Aurora.AuroraMonitoring.Metrics.md)」を参照してください。
スケーリングポリシーで事前定義メトリクスを使用するには、スケーリングポリシーのターゲット追跡構成を作成します。この設定は、事前定義メトリクスの `PredefinedMetricSpecification` と、そのメトリクスのターゲット値の `TargetValue` が含まれている必要があります。
**Example**
次の例では、Aurora DB クラスターのターゲット追跡スケーリングの一般的なポリシー設定について説明します。この設定では、`RDSReaderAverageCPUUtilization` 事前定義メトリクスを使用して、すべての Aurora レプリカでの平均 CPU 使用率 40% に基づいて Aurora DB クラスターが調整されます。
```
{
"TargetValue": 40.0,
"PredefinedMetricSpecification":
{
"PredefinedMetricType": "RDSReaderAverageCPUUtilization"
}
}
```
#### カスタムメトリクスの使用
カスタムメトリクスを使用することで、カスタム要件を満たすターゲット追跡スケーリングポリシーを定義できます。スケーリングに比例して変化する Aurora メトリクスに基づいて、カスタムメトリクスを定義することができます。
Aurora のすべてのメトリクスがターゲット追跡に使用できるわけではありません。メトリクスは、有効な使用率メトリクスで、インスタンスの使用頻度を示す必要があります。Aurora DB クラスター内の Aurora レプリカの数に比例してメトリクスの値を増減する必要があります。この比例的な増加または減少は、比例的にスケールアウトするため、または Aurora レプリカの数にメトリクスデータを使用するために必要です。
**Example**
次の例では、スケーリングポリシーのターゲット追跡設定について説明します。この設定では、カスタムメトリクスにより、`my-db-cluster` という名前の Aurora DB クラスター内のすべての Aurora レプリカでの平均 CPU 使用率 50% に基づいて、Aurora DB クラスターが調整されます。
```
{
"TargetValue": 50,
"CustomizedMetricSpecification":
{
"MetricName": "CPUUtilization",
"Namespace": "AWS/RDS",
"Dimensions": [
{"Name": "DBClusterIdentifier","Value": "my-db-cluster"},
{"Name": "Role","Value": "READER"}
],
"Statistic": "Average",
"Unit": "Percent"
}
}
```
#### クールダウン期間の使用
`ScaleOutCooldown` 値を秒単位で指定して、Aurora DB クラスターをスケールアウトするためのクールダウン期間を追加することができます。`ScaleInCooldown` 値を秒単位で追加して、Aurora DB クラスターをスケールするためのクールダウン期間を追加することができます。`ScaleInCooldown` と `ScaleOutCooldown` の詳細については、*Application Auto Scaling API リファレンス*の「[https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_TargetTrackingScalingPolicyConfiguration.html](https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_TargetTrackingScalingPolicyConfiguration.html)」を参照してください。
**Example**
次の例では、スケーリングポリシーのターゲット追跡設定について説明します。この設定では、`RDSReaderAverageCPUUtilization` 事前定義メトリクスを使用して、Aurora DB クラスターのすべての Aurora レプリカでの平均 CPU 使用率 40% に基づいて Aurora DB クラスターが調整されます。この設定では、10 分間のスケールインのクールダウン期間と 5 分間のスケールアウトのクールダウン期間が提供されます。
```
{
"TargetValue": 40.0,
"PredefinedMetricSpecification":
{
"PredefinedMetricType": "RDSReaderAverageCPUUtilization"
},
"ScaleInCooldown": 600,
"ScaleOutCooldown": 300
}
```
#### スケールインアクティビティの無効化
スケールインアクティビティを無効にすることにより、Aurora DB クラスターでターゲット追跡スケーリングポリシー設定がスケーリングされないようにできます。スケールインアクティビティを無効にすると、スケーリングポリシーによって Aurora レプリカが削除されることなく、スケーリングポリシーによって必要に応じて作成されます。
`DisableScaleIn` ブール値を指定して、Aurora DB クラスターのアクティビティのスケールを有効または無効にすることができます。`DisableScaleIn` の詳細については、*Application Auto Scaling API リファレンス*の 「[https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_TargetTrackingScalingPolicyConfiguration.html](https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_TargetTrackingScalingPolicyConfiguration.html)」を参照してください。
**Example**
次の例では、スケーリングポリシーのターゲット追跡設定について説明します。この設定では、`RDSReaderAverageCPUUtilization` 事前定義メトリクスは、Aurora DB クラスターのすべての Aurora レプリカでの平均 CPU 使用率 40% に基づいて Aurora DB クラスターを調整します。この設定では、スケーリングポリシーのスケールインアクティビティが無効になります。
```
{
"TargetValue": 40.0,
"PredefinedMetricSpecification":
{
"PredefinedMetricType": "RDSReaderAverageCPUUtilization"
},
"DisableScaleIn": true
}
```
### Aurora DB クラスターへのスケーリングポリシーの適用
Aurora DB クラスターを アプリケーションの Auto Scaling に登録し、スケーリングポリシーを定義した後、登録された Aurora DB クラスターにスケーリングポリシーを適用します。Aurora DB クラスターにスケーリングポリシーを適用する際には、AWS CLI または アプリケーションの Auto Scaling API を使用できます。
#### AWS CLI
スケーリングポリシーを Aurora DB クラスターに適用するには、以下のパラメータが指定された [コマンドを`put-scaling-policy`](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/put-scaling-policy.html)AWS CLI使用します。
+ `--policy-name` – スケーリングポリシーの名前。
+ `--policy-type` この値は に設定します。`TargetTrackingScaling`
+ `--resource-id` – Aurora DB クラスターのリソース識別子です。このパラメータでは、リソースタイプは `cluster` で、一意の識別子は Aurora DB クラスターの名前、例えば `cluster:myscalablecluster` です。
+ `--service-namespace` この値は に設定します。`rds`
+ `--scalable-dimension` この値は に設定します。`rds:cluster:ReadReplicaCount`
+ `--target-tracking-scaling-policy-configuration` – Aurora DB クラスターに使用するターゲット追跡スケーリングポリシー設定。
**Example**
次の例では、`myscalablepolicy` というターゲット追跡スケーリングポリシーを `myscalablecluster` という名前の Aurora DB クラスターに アプリケーションの Auto Scaling; を使用して適用します。そのためには、`config.json` という名前のファイルに保存されているポリシー設定を使用します。
Linux、macOS、Unix の場合:
```
aws application-autoscaling put-scaling-policy \
--policy-name myscalablepolicy \
--policy-type TargetTrackingScaling \
--resource-id cluster:myscalablecluster \
--service-namespace rds \
--scalable-dimension rds:cluster:ReadReplicaCount \
--target-tracking-scaling-policy-configuration file://config.json
```
Windows の場合:
```
aws application-autoscaling put-scaling-policy ^
--policy-name myscalablepolicy ^
--policy-type TargetTrackingScaling ^
--resource-id cluster:myscalablecluster ^
--service-namespace rds ^
--scalable-dimension rds:cluster:ReadReplicaCount ^
--target-tracking-scaling-policy-configuration file://config.json
```
#### Application Auto Scaling API
アプリケーションの Auto Scaling API を使用してスケーリングポリシーを Aurora DB クラスターに適用するには、以下のパラメータを指定して [https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_PutScalingPolicy.html](https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_PutScalingPolicy.html) アプリケーションの Auto Scaling API オペレーションを使用します。
+ `PolicyName` – スケーリングポリシーの名前。
+ `ServiceNamespace` この値は に設定します。`rds`
+ `ResourceID` – Aurora DB クラスターのリソース識別子です。このパラメータでは、リソースタイプは `cluster` で、一意の識別子は Aurora DB クラスターの名前、例えば `cluster:myscalablecluster` です。
+ `ScalableDimension` この値は に設定します。`rds:cluster:ReadReplicaCount`
+ `PolicyType` この値は に設定します。`TargetTrackingScaling`
+ `TargetTrackingScalingPolicyConfiguration` – Aurora DB クラスターに使用するターゲット追跡スケーリングポリシー設定。
**Example**
次の例では、`myscalablepolicy` というターゲット追跡スケーリングポリシーを `myscalablecluster` という名前の Aurora DB クラスターに アプリケーションの Auto Scaling; を使用して適用します。`RDSReaderAverageCPUUtilization` 事前定義メトリクスに基づいてポリシー設定を使用します。
```
POST / HTTP/1.1
Host: autoscaling.us-east-2.amazonaws.com
Accept-Encoding: identity
Content-Length: 219
X-Amz-Target: AnyScaleFrontendService.PutScalingPolicy
X-Amz-Date: 20160506T182145Z
User-Agent: aws-cli/1.10.23 Python/2.7.11 Darwin/15.4.0 botocore/1.4.8
Content-Type: application/x-amz-json-1.1
Authorization: AUTHPARAMS
{
"PolicyName": "myscalablepolicy",
"ServiceNamespace": "rds",
"ResourceId": "cluster:myscalablecluster",
"ScalableDimension": "rds:cluster:ReadReplicaCount",
"PolicyType": "TargetTrackingScaling",
"TargetTrackingScalingPolicyConfiguration": {
"TargetValue": 40.0,
"PredefinedMetricSpecification":
{
"PredefinedMetricType": "RDSReaderAverageCPUUtilization"
}
}
}
```
# Amazon Aurora DB クラスターの自動スケーリングポリシーの編集
AWS マネジメントコンソール、AWS CLI、または アプリケーションの Auto Scaling API を使用してスケーリングポリシーを編集できます。
## コンソール
AWS マネジメントコンソール を使用してスケーリングポリシーを編集できます。
**Aurora DB クラスターの Auto Scaling ポリシーを編集するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。
1. ナビゲーションペインで、[**データベース**] を選択します。
1. Auto Scaling ポリシーを編集する Aurora DB クラスターを選択します。
1. [**ログとイベント**] タブを選択します。
1. [**Auto Scaling Policies (Auto Scaling ポリシー)**] セクションで Auto Scaling ポリシーを選択してから [**Edit (編集)**] を選択します。
1. ポリシーを変更します。
1. [**Save**] を選択します。
以下は、[**Edit Auto Scaling policy**] ダイアログボックスのサンプルです。
![\[平均 CPU 使用率に基づいた Auto Scaling ポリシーの編集\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/aurora-autoscaling-edit-cpu.png)
## AWS CLI または Application Auto Scaling API
AWS CLI または アプリケーションの Auto Scaling API を使用して、スケーリングポリシーを適用するのと同じ方法でスケーリングポリシーを編集できます。
+ AWS CLI を使用する場合は、編集するポリシーの名前を `--policy-name` パラメータで指定します。変更するパラメータの新しい値を指定します。
+ アプリケーションの Auto Scaling API を使用する場合は、編集するポリシーの名前を `PolicyName` パラメータで指定します。変更するパラメータの新しい値を指定します。
詳細については、「[Aurora DB クラスターへのスケーリングポリシーの適用](Aurora.Integrating.AutoScaling.Add.md#Aurora.Integrating.AutoScaling.AddCode.ApplyScalingPolicy)」を参照してください。
# Amazon Aurora DB クラスターからの自動スケーリングポリシーの削除
AWS マネジメントコンソール、AWS CLI、または アプリケーションの Auto Scaling API を使用してスケーリングポリシーを削除できます。
## コンソール
AWS マネジメントコンソール を使用してスケーリングポリシーを削除できます。
**Aurora DB クラスターの Auto Scaling ポリシーを削除するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。
1. ナビゲーションペインで、[**データベース**] を選択します。
1. Auto Scaling ポリシーを削除する Aurora DB クラスターを選択します。
1. [**ログとイベント**] タブを選択します。
1. [**Auto Scaling Policies (Auto Scaling ポリシー)**] セクションで Auto Scaling ポリシーを選択してから [**Delete (削除)**] を選択します。
## AWS CLI
スケーリングポリシーを Aurora DB クラスターから削除するには、以下のパラメータを指定しながら、AWS CLI コマンドの [https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/delete-scaling-policy.html](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/delete-scaling-policy.html) を使用します。
+ `--policy-name` – スケーリングポリシーの名前。
+ `--resource-id` – Aurora DB クラスターのリソース識別子です。このパラメータでは、リソースタイプは `cluster` で、一意の識別子は Aurora DB クラスターの名前、例えば `cluster:myscalablecluster` です。
+ `--service-namespace` この値は に設定します。`rds`
+ `--scalable-dimension` この値は に設定します。`rds:cluster:ReadReplicaCount`
**Example**
次の例では、`myscalablepolicy` というターゲット追跡スケーリングポリシーを `myscalablecluster` という名前の Aurora DB クラスターから削除します。
Linux、macOS、Unix の場合:
```
aws application-autoscaling delete-scaling-policy \
--policy-name myscalablepolicy \
--resource-id cluster:myscalablecluster \
--service-namespace rds \
--scalable-dimension rds:cluster:ReadReplicaCount \
```
Windows の場合:
```
aws application-autoscaling delete-scaling-policy ^
--policy-name myscalablepolicy ^
--resource-id cluster:myscalablecluster ^
--service-namespace rds ^
--scalable-dimension rds:cluster:ReadReplicaCount ^
```
## Application Auto Scaling API
スケーリングポリシーを Aurora DB クラスターから削除するには、以下のパラメータを指定して [https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_DeleteScalingPolicy.html](https://docs.aws.amazon.com/ApplicationAutoScaling/latest/APIReference/API_DeleteScalingPolicy.html) アプリケーションの Auto Scaling API オペレーションを使用します。
+ `PolicyName` – スケーリングポリシーの名前。
+ `ServiceNamespace` この値は に設定します。`rds`
+ `ResourceID` – Aurora DB クラスターのリソース識別子です。このパラメータでは、リソースタイプは `cluster` で、一意の識別子は Aurora DB クラスターの名前、例えば `cluster:myscalablecluster` です。
+ `ScalableDimension` この値は に設定します。`rds:cluster:ReadReplicaCount`
**Example**
次の例では、アプリケーションの Auto Scaling API を使用して、`myscalablepolicy` というターゲット追跡スケーリングポリシーを `myscalablecluster` という名前の Aurora DB クラスターから削除します。
```
POST / HTTP/1.1
Host: autoscaling.us-east-2.amazonaws.com
Accept-Encoding: identity
Content-Length: 219
X-Amz-Target: AnyScaleFrontendService.DeleteScalingPolicy
X-Amz-Date: 20160506T182145Z
User-Agent: aws-cli/1.10.23 Python/2.7.11 Darwin/15.4.0 botocore/1.4.8
Content-Type: application/x-amz-json-1.1
Authorization: AUTHPARAMS
{
"PolicyName": "myscalablepolicy",
"ServiceNamespace": "rds",
"ResourceId": "cluster:myscalablecluster",
"ScalableDimension": "rds:cluster:ReadReplicaCount"
}
```