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

# Amazon CloudWatch による Amazon EventBridge スケジューラのモニタリング
<a name="monitoring-cloudwatch"></a>

 Amazon CloudWatch を使用して Amazon EventBridge スケジューラをモニタリングすることで、raw データを収集し、ほぼリアルタイムに処理して読み取り可能なメトリクスにできます。EventBridge スケジューラは、すべてのスケジュールのメトリクスセットと、デッドレターキュー (DLQ) が関連付けられているスケジュールの追加のメトリクスセットを出力します。スケジュールに [DLQ を設定する](configuring-schedule-dlq.md)と、スケジュールが再試行ポリシーを使い果たしたときに、EventBridge スケジューラは追加のメトリクスを公開します。

 これらの統計は 15 か月間保持されるため、履歴情報にアクセスして、スケジュールが失敗する理由をより的確に把握し、根本的な問題のトラブルシューティングを行うことができます。また、特定のしきい値を監視するアラームを設定し、これらのしきい値に達したときに通知を送信したりアクションを実行したりできます。詳細については、「[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)」を参照してください。

**Topics**
+ [用語](#monitoring-cloudwatch-terms)
+ [ディメンション](#monitoring-cloudwatch-dimensions)
+ [メトリクスへのアクセス](#monitoring-cloudwatch-view-metrics)
+ [メトリクスの一覧](#monitoring-cloudwatch-metrics-list)
+ [EventBridge スケジューラの使用状況メトリクス](monitoring-cloudwatch-usage-metrics.md)

## 用語
<a name="monitoring-cloudwatch-terms"></a>

**名前空間**  
名前空間は、 AWS サービスの CloudWatch メトリクスのコンテナです。EventBridge スケジューラの場合、名前空間は `AWS/Scheduler` です。

**CloudWatch メトリクス**  
CloudWatch メトリクスは、CloudWatch に特異的な時系列のデータポイントのセットを表します。

**ディメンション**  
ディメンションは、メトリクスのアイデンティティの一部である名前と値のペアです。

**Unit**  
 統計には、測定単位があります。EventBridge スケジューラの場合、単位には *Count* (カウント) が含まれます。

## ディメンション
<a name="monitoring-cloudwatch-dimensions"></a>

このセクションでは、CloudWatch のEventBridge スケジューラメトリクスの CloudWatch ディメンショングループについて説明します。


| ディメンション | 説明 | 
| --- | --- | 
|  ScheduleGroup  |  CloudWatch を使用してメトリクスを表示するスケジュールのグループ。まだグループを作成していない場合、EventBridge スケジューラはスケジュールを `default` グループに関連付けます。  | 

## メトリクスへのアクセス
<a name="monitoring-cloudwatch-view-metrics"></a>

このセクションでは、特定の EventBridge スケジューラのスケジュールについて CloudWatch のパフォーマンスメトリクスにアクセスする方法について説明します。

**ディメンションのパフォーマンスメトリクスを表示する方法**

1. CloudWatch コンソールで [[メトリクス]](https://console.aws.amazon.com/cloudwatch/home#metricsV2:graph=~()) ページを開きます。

1.  AWS リージョンセレクタを使用してスケジュールのリージョンを選択する 

1. **[スケジューラ]** 名前空間を選択します。

1. **[すべてのメトリクス]**タブで、**[スケジュールグループメトリクス]** などのディメンションを選択します。選択したリージョンで作成したすべてのスケジュールのメトリクスを表示するには、**[アカウントメトリクス]** を選択します。

1. ディメンションの CloudWatch メトリクスを選択します。例えば、**[InvocationAttemptCount]** や **[InvocationDroppedCount]** を選択し、**[グラフ検索]** を選択します。

1. EventBridge スケジューラメトリクスのパフォーマンス統計を表示するには、**[グラフ化したメトリクス]** タブを選択します。

## メトリクスの一覧
<a name="monitoring-cloudwatch-metrics-list"></a>

次の表は、すべての EventBridge スケジューラのスケジュールのメトリクスと、DLQ を設定したスケジュールの追加のメトリクスを示しています。

### すべてのスケジュールのメトリクス
<a name="monitoring-cloudwatch-metrics-list-schedules"></a>


| 名前空間 | メトリクス | 単位 | 説明 | 
| --- | --- | --- | --- | 
|  `AWS/Scheduler`  |  `InvocationAttemptCount`  |  カウント  |  呼び出しを試みるたびに発生します。このメトリクスを使用して、EventBridge スケジューラがスケジュールを呼び出そうとしていることを確認し、呼び出しがアカウントのクォータに近づく時期を確認します。  | 
|  `AWS/Scheduler`  |  `TargetErrorCount`  |  カウント  |  EventBridge スケジューラがターゲット API を呼び出した後にターゲットが例外を返したときに発生します。これを使用して、ターゲットへの配信がいつ失敗したかを確認します。  | 
|  `AWS/Scheduler`  |  `TargetErrorThrottledCount`  |  カウント  |  ターゲットによる API スロットリングによりターゲットの呼び出しが失敗した場合に発生します。EventBridge スケジューラによるターゲット API スロットリング呼び出しが根本的な原因である場合に、これを使用して配信障害を診断します。  | 
|  `AWS/Scheduler`  |  `InvocationThrottleCount`  |  カウント  |  EventBridge スケジューラによって設定されたサービスクォータを超過したために、EventBridge スケジューラがターゲットの呼び出しを抑制したときに発生します。これを使用して、呼び出しスロットリング制限クォータをいつ超過したかを判断します。サービスクォータの詳細については、「[Amazon EventBridge スケジューラのクォータ](scheduler-quotas.md)」を参照してください。  | 
|  `AWS/Scheduler`  |  `InvocationDroppedCount`  |  カウント  |  スケジュールの再試行ポリシーが使い果たされた後に、EventBridge スケジューラがターゲットを呼び出す試みを停止したときに発生します。再試行ポリシーの詳細については、「*EventBridge スケジューラ API リファレンス*」の「[RetryPolicy](https://docs.aws.amazon.com/scheduler/latest/APIReference/API_RetryPolicy.html)」を参照してください。  | 

### DLQ を含むスケジュールのメトリクス
<a name="monitoring-cloudwatch-metrics-list-dlq"></a>

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/scheduler/latest/UserGuide/monitoring-cloudwatch.html)

# EventBridge スケジューラの使用状況メトリクス
<a name="monitoring-cloudwatch-usage-metrics"></a>

CloudWatch は、一部の AWS リソースの使用状況を追跡するメトリクスを収集します。これらのメトリクスは、 AWS サービスクォータに対応しています。これらのメトリクスを追跡することで、クォータを積極的に管理できます。サービスクォータの詳細については、「[Amazon EventBridge スケジューラのクォータ](scheduler-quotas.md)」を参照してください。

これらのメトリクスは ではなく `AWS/Usage`名前空間に含まれ`AWS/Scheduler`、1 分ごとに収集されます。 は、ディメンション `Service`、、`Class`、および を使用して`Type`この名前空間にメトリクス CloudWatch を発行します`Resource`。


**使用状況メトリクスの一般的なディメンション**  

| ディメンション | 説明 | 
| --- | --- | 
|  `Service`  |  リソースを含む AWS サービスの名前。 EventBridge スケジューラ 使用状況メトリクスの場合、値は です`Scheduler`。  | 
|  `Class`  |  追跡されているリソースのクラス。 EventBridge スケジューラ 使用状況メトリクスの場合、値は です`None`。  | 
|  `Type`  |  追跡されるリソースのタイプ。API 使用状況メトリクスの場合、値は です`API`。リソース数メトリクスの場合、値は です`Resource`。  | 
|  `Resource`  |  追跡される特定のリソース。API 使用状況メトリクスの場合、これは API オペレーション名です。リソース数メトリクスの場合、これはカウントされるリソースタイプです。  | 

## API 使用状況メトリクス
<a name="monitoring-cloudwatch-api-usage-metrics"></a>

API 使用状況メトリクスは、アカウントで実行された API オペレーションの数を追跡します。これらのメトリクスを使用して、API コールボリュームをモニタリングし、API レートクォータを管理します。

メトリクス名は です`CallCount`。このメトリクスで最も有用な統計は です。これは`SUM`、1 分間の合計オペレーション数を表します。


**API 使用状況メトリクス**  

| メトリクス | [リソース]  | 説明 | 
| --- | --- | --- | 
| `CallCount` | `CreateSchedule` | アカウントで実行された `CreateSchedule` API オペレーションの数。 | 
| `CallCount` | `CreateScheduleGroup` | アカウントで実行された `CreateScheduleGroup` API オペレーションの数。 | 
| `CallCount` | `DeleteSchedule` | アカウントで実行された `DeleteSchedule` API オペレーションの数。 | 
| `CallCount` | `DeleteScheduleGroup` | アカウントで実行された `DeleteScheduleGroup` API オペレーションの数。 | 
| `CallCount` | `GetSchedule` | アカウントで実行された `GetSchedule` API オペレーションの数。 | 
| `CallCount` | `GetScheduleGroup` | アカウントで実行された `GetScheduleGroup` API オペレーションの数。 | 
| `CallCount` | `ListScheduleGroups` | アカウントで実行された `ListScheduleGroups` API オペレーションの数。 | 
| `CallCount` | `ListSchedules` | アカウントで実行された `ListSchedules` API オペレーションの数。 | 
| `CallCount` | `ListTagsForResource` | アカウントで実行された `ListTagsForResource` API オペレーションの数。 | 
| `CallCount` | `TagResource` | アカウントで実行された `TagResource` API オペレーションの数。 | 
| `CallCount` | `UntagResource` | アカウントで実行された `UntagResource` API オペレーションの数。 | 
| `CallCount` | `UpdateSchedule` | アカウントで実行された `UpdateSchedule` API オペレーションの数。 | 

たとえば、次のディメンションを持つ `CallCount`メトリクスは、アカウントで `CreateSchedule` API オペレーションが呼び出された回数を示します。
+ "Service": "Scheduler"
+ 「クラス」：「なし」
+ "Type": "API"
+ "Resource": "CreateSchedule"

## リソース数メトリクス
<a name="monitoring-cloudwatch-resource-count-metrics"></a>

リソース数メトリクスは、アカウントのリソースのおおよその数を追跡します。これらのメトリクスを使用して、サービスクォータの制限に近づいているタイミングをモニタリングし、容量が不足する前にクォータの引き上げをリクエストできます。

メトリクス名は です`ResourceCount`。このメトリクスの最も有用な統計は `Maximum` です。


**リソース数メトリクス**  

| メトリクス | [リソース]  | 説明 | 
| --- | --- | --- | 
|  `ResourceCount`  |  `ApproximateSchedule`  |  アカウント内のスケジュールの概算数。このメトリクスを使用して、スケジュールのクォータ制限に近づいているタイミングをモニタリングし、 を呼び出す際の`ServiceQuotaExceededException`エラーを回避します`CreateSchedule`。 スケジュールの数が 100 万未満の場合、このメトリクスは 0 と表示される場合があります。スケジュールクォータに近づいたときに通知するアラームについては、デフォルトのスケジュールクォータが 1,000 万であるため、しきい値が 500 万以上の `Maximum` 統計を使用することをお勧めします。  | 
|  `ResourceCount`  |  `ApproximateScheduleGroup`  |  アカウント内のスケジュールグループのおおよその数。このメトリクスを使用して、スケジュールグループのクォータ制限に近づいているタイミングをモニタリングし、 を呼び出す際の`ServiceQuotaExceededException`エラーを回避するのに役立ちます`CreateScheduleGroup`。  | 

たとえば、次のディメンションを持つ `ResourceCount`メトリクスと `Maximum` 統計は、アカウントのスケジュールのおおよその数を示します。
+ "Service": "Scheduler"
+ 「クラス」：「なし」
+ 「タイプ」：「リソース」
+ 「リソース」：「ApproximateSchedule」