翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon EC2 Auto Scaling の Amazon CloudWatch メトリクス
<a name="ec2-auto-scaling-metrics"></a>

Amazon EC2 Auto Scaling は `AWS/AutoScaling` 名前空間に以下のメトリクスを公開します。実際に使用できる Auto Scaling グループメトリクスは、グループメトリクスを有効にしているかどうか、およびどのグループメトリクスを有効にしたかによって異なります。グループメトリクスは、追加料金なしで 1 分単位で利用できますが、有効にする必要があります。

Auto Scalingグループメトリクスを有効にすると、Amazon EC2 Auto Scaling は、ベストエフォートベースで毎分、CloudWatch にサンプルデータを送信します。CloudWatch でサービスの中断が発生するまれなケースでは、グループメトリクス履歴のギャップを埋めるためのデータのバックフィルは行われません。

**Topics**
+ [Auto Scaling グループメトリクス](#as-group-metrics)
+ [Auto Scaling グループメトリクスのディメンション](#as-group-metric-dimensions)
+ [予測スケーリングのメトリクスとディメンション](#predictive-scaling-metrics)
+ [Auto Scaling グループのメトリクスを有効にする (コンソール)](#as-enable-group-metrics)
+ [Auto Scaling グループのメトリクスを有効にする (AWS CLI)](#as-enable-group-metrics-cli)

## Auto Scaling グループメトリクス
<a name="as-group-metrics"></a>

これらのメトリクスを使用して、グループサイズの経時変化など、Auto Scaling グループの履歴をほぼ継続的に把握することができます。


| メトリクス | 説明 | 
| --- | --- | 
|  GroupMinSize  |  Auto Scaling グループの最小サイズ。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupMaxSize  |  Auto Scaling グループの最大サイズ。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupDesiredCapacity  |  Auto Scaling グループが保持しようとするインスタンスの数。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupInServiceInstances  |  Auto Scaling グループの一部として実行するインスタンスの数。このメトリクスには保留中もしくは終了処理中のインスタンスは含まれません。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupPendingInstances  |  保留中のインスタンスの数。保留中のインスタンスは、稼働状態ではありません。このメトリクスには稼働中もしくは終了処理中のインスタンスは含まれません。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupStandbyInstances  |  `Standby` 状態にあるインスタンスの数。この状態のインスタンスはまだ実行中ですが、実際には使用されていません。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupTerminatingInstances  |  終了処理中のインスタンスの数。このメトリクスには、Auto Scaling グループのスケールイン後に稼働中、保留中、またはウォームプールへの復帰中になっているインスタンスは含まれません。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupTerminatingRetainedInstances  |  `Terminating:Retained` 状態のインスタンスの数。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupTotalInstances  |  Auto Scaling グループに含まれるインスタンスの合計数。このメトリクスは稼働中、保留中、および終了処理中のインスタンスの数を特定します。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 

各インスタンスタイプの vCPU 数に基づいて重みを割り当てるなど、さまざまなユニットで希望するキャパシティを測定するように混合インスタンスグループを設定すると、次のメトリクスは Auto Scaling グループによって使用されるユニット数をカウントします。希望するキャパシティをさまざまなユニットで測定するように混合インスタンスグループを設定しなかった場合、次のメトリクスが事前入力されますが、これらは前の表で定義されているメトリクスと同じです。詳細については、「[混合インスタンスグループを作成するための設定の概要](mixed-instances-groups-set-up-overview.md)」を参照してください。


| メトリクス | 説明 | 
| --- | --- | 
|  GroupInServiceCapacity  |  Auto Scaling グループの一部として実行されているキャパシティユニットの数。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupPendingCapacity  |  保留中のキャパシティユニットの数。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupStandbyCapacity  |  `Standby` 状態にあるキャパシティユニットの数。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupTerminatingCapacity  |  終了処理中のキャパシティユニットの数。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupTerminatingRetainedCapacity  |  `Terminating:Retained` 状態のインスタンスによって表されるキャパシティーユニット。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupTotalCapacity  |  Auto Scaling グループ内のキャパシティユニットの合計数。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 

Amazon EC2 Auto Scaling は、ウォームプールを持つ Auto Scaling グループの以下のメトリクスもレポートします。詳細については、「[ウォームプールを使用してブート時間が長いアプリケーションのレイテンシーを低減する](ec2-auto-scaling-warm-pools.md)」を参照してください。


| メトリクス | 説明 | 
| --- | --- | 
|  WarmPoolMinSize  |  ウォームプールの最小サイズ。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  WarmPoolDesiredCapacity  |  Amazon EC2 Auto Scaling がウォームプールで維持しようとするキャパシティの量。 これは、Auto Scaling グループの最大サイズから希望するキャパシティを引いた値に相当します。また、設定されている場合は、Auto Scaling グループの準備されている最大キャパシティから希望するキャパシティを引いた値に相当します。 ただし、ウォームプールの最小サイズが、最大サイズ (または設定されている場合は、準備された最大キャパシティ) と Auto Scaling グループの希望するキャパシティの差以上である場合、希望するウォームプールのキャパシティは `WarmPoolMinSize` に等しくなります。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  WarmPoolPendingCapacity  |  保留中のウォームプール内のキャパシティ量。これには、Auto Scaling グループのスケールイン後にウォームプールに復帰しているインスタンスが含まれます。このメトリクスには実行中、停止中、または終了処理中のインスタンスは含まれません。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  WarmPoolPendingRetainedCapacity  |  ウォームプールに戻る保持されたインスタンスを追跡します。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  WarmPoolTerminatingCapacity  |  終了処理中のウォームプールのキャパシティの量。このメトリクスには実行中、停止中、または保留中のインスタンスは含まれません。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  WarmPoolTerminatingRetainedCapacity  |  ウォームプールから終了する保持されたインスタンスを追跡します。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  WarmPoolWarmedCapacity  |  スケールアウト中に Auto Scaling グループに入れることができるキャパシティの量。このメトリクスには保留中もしくは終了処理中のインスタンスは含まれません。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  WarmPoolTotalCapacity  |  実行中、停止中、保留中、または終了処理中のインスタンスを含む、ウォームプールの合計キャパシティ。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupAndWarmPoolDesiredCapacity  |  Auto Scaling グループとウォームプールを合わせた希望するキャパシティ。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 
|  GroupAndWarmPoolTotalCapacity  |  Auto Scaling グループとウォームプールを合わせた合計キャパシティ。これには、実行中、停止中、保留中、終了処理中、または稼働中のインスタンスが含まれます。 **レポート基準**: メトリクス収集が有効になっている場合に報告されます。  | 

## Auto Scaling グループメトリクスのディメンション
<a name="as-group-metric-dimensions"></a>

以下のディメンションを使用して、前の表に示したメトリクスを絞り込むことができます。


| ディメンション | 説明 | 
| --- | --- | 
|  AutoScalingGroupName  |  Auto Scaling グループの名前をフィルターします。  | 

## 予測スケーリングのメトリクスとディメンション
<a name="predictive-scaling-metrics"></a>

`AWS/AutoScaling` 名前空間には、予測スケーリングに関する以下のメトリクスが含まれます。

メトリクスは、1 時間の解像度で使用できます。

予測値を実際の値と比較することで、予測精度を評価できます。これらのメトリクスを使用した予測精度の評価についての詳細は、「[CloudWatch による予測スケーリングメトリクスのモニタリング](monitor-predictive-scaling-cloudwatch.md)」(CloudWatch で予測スケーリングメトリクスをモニタリングする) を参照してください。


| メトリクス | 説明 | ディメンション | 
| --- | --- | --- | 
|  PredictiveScalingLoadForecast  |  アプリケーションによって生成されることが予想される負荷の量。 `Average`、`Minimum`、`Maximum` の統計は有用ですが、`Sum` の統計は有用ではありません。 **レポート基準**: 初期予測の作成後にレポートされます。  | AutoScalingGroupName, PolicyName, PairIndex  | 
| PredictiveScalingCapacityForecast |  アプリケーションの需要を満たすために必要であると予想されるキャパシティ。これは、Auto Scaling インスタンスを維持するための負荷予測と目標使用率レベルに基づいています。 `Average`、`Minimum`、`Maximum` の統計は有用ですが、`Sum` の統計は有用ではありません。 **レポート基準**: 初期予測の作成後にレポートされます。  | AutoScalingGroupName, PolicyName | 
| PredictiveScalingMetricPairCorrelation |  スケーリング指標と負荷指標のインスタンスごとの平均の間における相関関係。予測スケーリングは高い相関関係を前提とします。したがって、この指標の値が小さい場合、指標ペアを使用しない方がよいでしょう。 `Average`、`Minimum`、`Maximum` の統計は有用ですが、`Sum` の統計は有用ではありません。 **レポート基準**: 初期予測の作成後にレポートされます。  | AutoScalingGroupName, PolicyName, PairIndex | 

**注記**  
`PairIndex` ディメンションは、Amazon EC2 Auto Scaling によって割り当てられた際に、負荷スケーリングメトリクスペアのインデックスに関連付けられた情報を返します。現在、有効な値は `0` のみです。

## Auto Scaling グループのメトリクスを有効にする (コンソール)
<a name="as-enable-group-metrics"></a>

**グループメトリクスを有効にするには**

1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) でAmazon EC2 コンソールを開き、ナビゲーションペインで [**Auto Scaling グループ**] を選択します。

1. Auto Scaling グループの横にあるチェックボックスを選択します。

   ページの下部にスプリットペインが開きます。

1. **[Monitoring]** (モニタリング) タブで、ページ上部の **[Auto Scaling]** の下にある **[Auto Scaling group metrics collection]** (Auto Scaling グループのメトリクスのコレクション) を選択し、**[Enable]** (有効化) チェックボックスをオンにします。

**グループメトリクスを無効にするには**

1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) でAmazon EC2 コンソールを開き、ナビゲーションペインで [**Auto Scaling グループ**] を選択します。

1. Auto Scaling スケーリンググループを選択します。

1. [**モニタリング**] タブで、[**Auto Scaling group metrics collection (Auto Scaling グループメトリクスの収集)**] の [**Enable (有効)**] チェックボックスをオフにします。

## Auto Scaling グループのメトリクスを有効にする (AWS CLI)
<a name="as-enable-group-metrics-cli"></a>

**Auto Scaling グループメトリクスを有効にするには**  
[enable-metrics-collection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/enable-metrics-collection.html) コマンドを使用して、1 つ以上のグループメトリクスを有効にします。例えば、次のコマンドは、指定した Auto Scaling グループの単一のメトリクスを有効にします。

```
aws autoscaling enable-metrics-collection --auto-scaling-group-name my-asg \
  --metrics GroupDesiredCapacity --granularity "1Minute"
```

`--metrics` メトリクスを省略した場合、すべてのメトリクスが有効になります。

```
aws autoscaling enable-metrics-collection --auto-scaling-group-name my-asg \
  --granularity "1Minute"
```

**Auto Scaling グループメトリクスを無効にするには**  
[disable-metrics-collection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/disable-metrics-collection.html) コマンドを使用して、すべてのグループメトリクスを無効にします。

```
aws autoscaling disable-metrics-collection --auto-scaling-group-name my-asg
```