[AWS] CloudWatchダッシュボードの数値ウィジェットで表示する値の設定について（指定期間中の合計件数を表示したい）

CloudWatchダッシュボードはCloudWatchサービスの一部で、監視データを視覚的に表示し、カスタマイズ可能なダッシュボードを作成できる機能です。

今回は、この中の数値ウィジェットの設定で少し分かりにくい部分がありましたので調査しました。数値ウィジェットは特定のメトリック値を表示するシンプルなウィジェットです（右側はゲージウィジェットですが同様の設定があります）。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/399a52ec-4359-2aea-dff8-e061b0de123f.png)

# 表示したいメトリクスの例

例えばこのようなメトリクス（これはあるLambda Functionの実行件数Invocationsです）があった場合、

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/0013a139-0571-eabf-0402-19795fc256e2.png)

表示対象となる数値としては下記図に示したようなものがあります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/2b08005e-d883-80be-81fd-c91a20913b01.png)

以下は、どういう設定をするとこれらの数値が表示できるかの説明となります。

# 設定のポイント

今回の設定では、ウィジェットのオプション設定の中の「値」の設定を変更します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/7b530ef3-dc6e-d329-c080-3309e77e8a99.png)

この設定の上の方、「<b><font color="blue">最新の値は選択した時間範囲の最新の期間の値を示しています。</font></b>」を選択すると、<b><font color="red">選択された時間範囲の中で最新の値</font></b>が表示されるようになります。

「<b><font color="blue">時間範囲の値は、全時間範囲からの値を示しています。</font></b>」を選択すると、<b><font color="red">選択された時間範囲全体での合計値</font></b>が表示されるようになります。

この文言が分かりにくいという話で、元の英語を見てもちょっと分かりにくい表現のように思いました。シンプルに「最新の値」か「合計値」でもいいように思うのですが。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/eb1e541c-8a75-2f01-01f6-31ed747005fa.png)

また、表示対象期間は、同じオプション設定にダッシュボード設定から独立するかの選択があります。この設定は最近（2023/11の機能追加と思います）追加されました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/c9b81178-808c-ecbf-5b2d-a05e7ba7400d.png)

# 各設定を変えた場合の表示の違い

上記、Lambdaの実行件数の例でオプションを変えた場合の表示の違いを示します。

## ダッシュボード設定の期間で、最新の値を表示

時間範囲の設定はチェックを外し、

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/e5bc3529-8478-ee0e-3742-eacffa5a938c.png)

最新の値を選択すると

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/d9a519e4-2687-8517-3848-d77348a4381b.png)

ダッシュボード設定範囲の最新の値が表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/f1881b5c-55d1-43b0-c7ed-ae176c20d9d3.png)

## ダッシュボード設定の期間で、合計値を表示

時間範囲の設定はチェックを外し、

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/e5bc3529-8478-ee0e-3742-eacffa5a938c.png)

合計値を選択すると

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/3f3944ab-2d3e-49f2-5d00-90ccb2d8f356.png)

ダッシュボード設定範囲の合計値が表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/434e11d1-cb8d-dc2d-daa7-65087bda965c.png)

## ウィジェット個別の期間で、最新の値を表示

時間範囲のチェックを入れて期間を設定し、

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/a522ae51-57e6-4c4d-8c52-b49e38379bfe.png)

最新の値を選択すると

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/d9a519e4-2687-8517-3848-d77348a4381b.png)

ウィジェット個別期間の最新の値が表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/653b6b0b-5417-50a9-b73c-1f56136785d8.png)

## ウィジェット個別の期間で、合計値を表示

時間範囲のチェックを入れて期間を設定し、

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/a522ae51-57e6-4c4d-8c52-b49e38379bfe.png)

合計値を選択すると

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/3f3944ab-2d3e-49f2-5d00-90ccb2d8f356.png)

ウィジェット個別期間の合計値が表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/4ebea217-c67e-5331-ecd3-9abcd00adcb8.png)

# まとめ

メトリクスの例と、その表示例を再掲します。オプション設定によって各メトリクスが数値ウィジェットに表示可能なことが確認できました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/2b08005e-d883-80be-81fd-c91a20913b01.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/172826/e152099e-268e-4ff9-fbcb-011d82fd3c0d.png)


参考資料

- [CloudWatch ダッシュボードでウィジェットを作成して使用する](https://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/monitoring/create-and-work-with-widgets.html)