本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用亚马逊监控亚马逊 EventBridge 计划程序 CloudWatch
<a name="monitoring-cloudwatch"></a>

 您可以使用监控 Amazon S EventBridge cheduler CloudWatch，它会收集原始数据并将其处理为可读的近乎实时的指标。 EventBridge Scheduler 会为所有计划发出一组指标，并为具有关联死信队列 (DLQ) 的计划发出一组额外的指标。如果您为计划[配置 DLQ](configuring-schedule-dlq.md)，则当您的 EventBridge 计划用尽其重试策略时，计划程序会发布其他指标。

 这些统计数据会保存 15 个月，从而使您能够访问历史信息，并能够更好地了解计划失败的原因，并对潜在问题进行故障排除。还可以设置特定阈值监视警报，在达到对应阈值时发送通知或采取行动。有关更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。

**Topics**
+ [术语](#monitoring-cloudwatch-terms)
+ [Dimensions](#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

**维度**  
维度是作为指标标识一部分的 name/value 配对。

**单位**  
 所有统计数据都有度量单位。对于 EventBridge 调度器，单位包括*计数*。

## Dimensions
<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` | 计数 | 每次尝试调用时都会发出。使用此指标来检查 S EventBridge cheduler 是否正在尝试调用您的计划，并查看调用何时接近您的账户配额。 | 
| `AWS/Scheduler` | `TargetErrorCount` | 计数 | 在 EventBridge 调度器调用目标 API 后目标返回异常时发出。使用此指标可检查向目标传输失败的时间。 | 
| `AWS/Scheduler` | `TargetErrorThrottledCount` | 计数 | 在由于目标的 API 节流而导致目标调用失败时发出。当根本原因是调度器发出的目标 API 限制调用时，使用它来诊断交付失败 EventBridge  | 
| `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 传送事件时发出。使用这两个指标来确定 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>