

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

# 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>


<table>
<thead>
  <tr><th>名前空間</th><th>メトリクス</th><th>単位</th><th>説明</th></tr>
</thead>
<tbody>
  <tr><td>`AWS/Scheduler`</td><td>`InvocationsSentToDeadLetterCount`</td><td>カウント</td><td>スケジュールの DLQ への配信が成功するたびに発生します。これを使用して、イベントが DLQ に送信されるタイミングを判断し、スケジュールの DLQ に配信されたイベントをチェックして、障害の原因を特定するのに役立つ詳細情報を確認します。</td></tr>
  <tr><td>`AWS/Scheduler`</td><td>`InvocationsFailedToBeSentToDeadLetterCount`</td><td>カウント</td><td rowspan="2">EventBridge スケジューラが DLQ にイベントを配信できない場合に発生します。この 2 つのメトリクスを使用して、EventBridge スケジューラが DLQ にイベントを送信できない理由を特定し、DLQ 設定を変更して問題を解決します。<br />以下は、DLQ として指定した Amazon SQS キューが存在しない場合の `InvocationsFailedToBeSentToDeadLetterCount_<error_code>` メトリクスの例です: `InvocationsFailedToBeSentToDeadLetterCount_AWS.SimpleQueueService.NonExistentQueue` </td></tr>
  <tr><td>`AWS/Scheduler`</td><td>`InvocationsFailedToBeSentToDeadLetterCount_<error_code>`</td><td>カウント</td></tr>
  <tr><td>`AWS/Scheduler`</td><td>`InvocationsSentToDeadLetterCount_Truncated_MessageSizeExceeded`</td><td>カウント</td><td>DLQ に送信されたイベントのペイロードが Amazon SQS で許可されている最大サイズを超え、EventBridge スケジューラがスケジュールの `Input` 属性で指定されたペイロードを切り捨てたときに発生します。</td></tr>
</tbody>
</table>
名前空間	メトリクス	単位	説明
`AWS/Scheduler`	`InvocationsSentToDeadLetterCount`	カウント	スケジュールの DLQ への配信が成功するたびに発生します。これを使用して、イベントが DLQ に送信されるタイミングを判断し、スケジュールの DLQ に配信されたイベントをチェックして、障害の原因を特定するのに役立つ詳細情報を確認します。
`AWS/Scheduler`	`InvocationsFailedToBeSentToDeadLetterCount`	カウント	EventBridge スケジューラが DLQ にイベントを配信できない場合に発生します。この 2 つのメトリクスを使用して、EventBridge スケジューラが DLQ にイベントを送信できない理由を特定し、DLQ 設定を変更して問題を解決します。以下は、DLQ として指定した Amazon SQS キューが存在しない場合の `InvocationsFailedToBeSentToDeadLetterCount_` メトリクスの例です: `InvocationsFailedToBeSentToDeadLetterCount_AWS.SimpleQueueService.NonExistentQueue`
`AWS/Scheduler`	`InvocationsFailedToBeSentToDeadLetterCount_`	カウント
`AWS/Scheduler`	`InvocationsSentToDeadLetterCount_Truncated_MessageSizeExceeded`	カウント	DLQ に送信されたイベントのペイロードが Amazon SQS で許可されている最大サイズを超え、EventBridge スケジューラがスケジュールの `Input` 属性で指定されたペイロードを切り捨てたときに発生します。