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

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

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/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`，並且每分鐘收集一次。 會在此命名空間中 CloudWatch 發佈具有維度 `Service`、`Class`、 `Type`和 的指標`Resource`。


**用量指標的常見維度**  

| 維度 | Description | 
| --- | --- | 
|  `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 用量指標**  

| 指標 | 資源 | Description | 
| --- | --- | --- | 
| `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`。


**資源計數指標**  

| 指標 | 資源 | Description | 
| --- | --- | --- | 
|  `ResourceCount`  |  `ApproximateSchedule`  |  您帳戶中的排程大約數量。使用此指標來監控您何時接近排程配額限制，以協助您避免在呼叫 `ServiceQuotaExceededException`時發生錯誤`CreateSchedule`。 當排程數量少於 100 萬個時，此指標可能會顯示零。若要在接近排程配額時通知警示，建議您使用閾值為 500 萬或更高的`Maximum`統計資料，因為預設排程配額為 1，000 萬。  | 
|  `ResourceCount`  |  `ApproximateScheduleGroup`  |  您帳戶中的排程群組大約數量。使用此指標來監控您何時接近排程群組配額限制，以協助您避免在呼叫 `ServiceQuotaExceededException`時發生錯誤`CreateScheduleGroup`。  | 

例如，具有下列維度的 `ResourceCount` 指標和 `Maximum` 統計資料會指出您帳戶中大約的排程數量：
+ "Service"： "Scheduler"
+ "類別"： "無"
+ "Type"： "Resource"
+ "Resource"： "ApproximateSchedule"