本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon CloudWatch 監控 Amazon EventBridge 排程器
<a name="monitoring-cloudwatch"></a>

 您可以使用 CloudWatch 監控 Amazon EventBridge 排程器，這會收集原始資料並將其處理為可讀且幾近即時的指標。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 特有的一組按時間順序排列的資料點。

**維度**  
維度是一組名稱值對，是指標身分的一部分。

**單位**  
 統計資料具有度量單位。對於 EventBridge 排程器，單位包含*計數*。

## 維度
<a name="monitoring-cloudwatch-dimensions"></a>

本節說明 CloudWatch 中 EventBridge 排程器指標的 CloudWatch 維度分組。


| 維度 | Description | 
| --- | --- | 
| ScheduleGroup | 您要使用 CloudWatch 檢視指標的排程群組。如果您尚未建立任何群組，EventBridge 排程器會將您的排程與該`default`群組建立關聯。 | 

## 存取 指標
<a name="monitoring-cloudwatch-view-metrics"></a>

本節說明如何存取 CloudWatch 中特定 EventBridge 排程器排程的效能指標。

**檢視維度的效能指標**

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>


| 命名空間 | 指標 | 單位 | Description | 
| --- | --- | --- | --- | 
| `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>Description</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 時發出。使用這兩個指標來判斷 EventBridge 排程器無法將事件傳送至 DLQ 的原因，並修改您的 DLQ 組態以解決問題。<br />以下是您指定為 `InvocationsFailedToBeSentToDeadLetterCount_<error_code>` DLQ 的 Amazon SQS 佇列不存在時的 指標範例： `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>