

• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# AWS Systems Manager OpsCenter
<a name="OpsCenter"></a>

OpsCenter（AWS Systems Manager 中的一项工具）提供了一个中心位置，运营工程师和 IT 专业人员可以在此处查看、调查和解决与 AWS 资源相关的操作工作项（OpsItems）。OpsCenter 旨在缩短影响 AWS 资源的问题的平均解决时间。OpsCenter 聚合并标准化各种服务的 OpsItems，同时提供有关每个 OpsItem、相关 OpsItems 以及相关资源的上下文调查数据。OpsCenter 还提供 Systems Manager Automation 运行手册，可用于快速解决问题。您可以为每个 OpsItem 指定可搜索的自定义数据。您还可以按状态和源查看自动生成的 OpsItems 相关摘要报告。要开始使用 OpsCenter，请打开 [Systems Manager 控制台](https://console.aws.amazon.com//systems-manager/opsitems)。在导航窗格中，请选择 **OpsCenter**。

OpsCenter 已与 Amazon EventBridge 和 Amazon CloudWatch 集成。所以，您可以配置这些服务，以便当 CloudWatch 告警进入 `ALARM` 状态时或者当 EventBridge 处理发布事件中的 AWS 服务的事件时，自动在 OpsCenter 中创建 OpsItem。通过配置 CloudWatch 告警和 EventBridge 事件以自动创建 OpsItems，使您可以在单个控制台中快速诊断和修正 AWS 资源的问题。

为了帮助您诊断问题，每个 OpsItem 均包含上下文相关信息，例如生成 OpsItem 的 AWS 资源名称和 ID、告警或事件详细信息、告警历史记录和告警时间线图。

对于 AWS 资源，OpsCenter 可汇集来自 AWS Config、AWS CloudTrail 日志和 Amazon CloudWatch Events 的信息，因此您在调查期间不必浏览多个控制台页面。

以下列表包含 AWS 资源和指标的类型，客户可为其配置创建 OpsItems 的 CloudWatch 告警。
+ Amazon DynamoDB：数据库读取和写入操作达到阈值
+ Amazon EC2：CPU 使用率达到阈值
+ AWS 账单：预估费用达到阈值
+ Amazon EC2：实例未能通过状态检查
+ Amazon Elastic Block Store (EBS)：磁盘空间使用率达到阈值

以下列表包含客户配置用于创建 OpsItems 的 EventBridge 规则类型。
+ AWS Security Hub CSPM：发出安全提示
+ DynamoDB：节流事件
+ Amazon EC2 Auto Scaling：启动实例失败
+ Systems Manager：运行自动化失败
+ AWS Health：计划维护提示
+ EC2：实例状态从 `Running` 更改为 `Stopped`

OpsCenter 还与适用于 .NET 和 SQL Server 的 Amazon CloudWatch Application Insights 进行集成。因此，您可以为应用程序中检测到的问题自动创建 OpsItems。您也可以集成 OpsCenter 与 AWS Security Hub CSPM，以便在 Systems Manager 中汇集安全性、性能和操作问题并采取措施。

运营工程师和 IT 专业人员可以使用 AWS Systems Manager 控制台中的 OpsCenter 页面、公有 API 操作、AWS Command Line Interface(AWS CLI)、AWS Tools for Windows PowerShell或 AWS SDK，以创建、查看和编辑 OpsItems。OpsCenter 公有 API 操作还支持将 OpsCenter 与您的用例管理系统和运行状况控制面板集成。

## 我的组织如何从 OpsCenter 获益？
<a name="OpsCenter-learn-more-benefits"></a>

对于查看、处理和修正与 AWS 资源相关的问题,OpsCenter 提供了标准和统一的体验。标准和统一的体验可以缩短解决问题、调查相关问题以及培训新的运营工程师和 IT 专业人员所需的时间。标准和统一的体验还减少了输入管理和修复问题的系统中的手动错误的数量。

更具体地说，OpsCenter 为运营工程师和组织提供以下好处：
+ 您不再需要浏览多个控制台页面来查看、调查和解决与 AWS 资源相关的 OpsItems。OpsItems 跨服务聚合在一个中心位置。
+ 您可以查看与 OpsItems 相关的特定服务数据和上下文相关数据，这些数据由 CloudWatch 告警、EventBridge 事件以及适用于 .NET 和 SQL Server 的 CloudWatch Application Insights 自动生成。
+ 您可以指定与 OpsItem 相关的资源的 Amazon Resource Name (ARN)。通过指定相关资源，OpsCenter 可使用内置逻辑来帮助您避免创建重复的 OpsItems。
+ 您可以查看有关类似 OpsItems 的详细信息和分辨率信息。
+ 您可以快速查看并运行有关 Systems Manager 自动化运行手册的信息，以解决问题。

## OpsCenter 具有哪些功能？
<a name="OpsCenter-learn-more-features"></a>
+ **自动化和手动 OpsItem 创建**

  OpsCenter 已与 Amazon CloudWatch 集成。因此，您可以配置 CloudWatch，以便当告警进入 `ALARM` 状态时或者当 Amazon EventBridge 处理发布事件的 AWS 服务的事件时，可自动在 OpsCenter 中创建 OpsItem。您还可以手动创建 OpsItems。

  OpsCenter 还与适用于 .NET 和 SQL Server 的 Amazon CloudWatch Application Insights 进行集成。因此，您可以为应用程序中检测到的问题自动创建 OpsItems。
+ **详细的且可搜索的 OpsItems**

  每个 OpsItem 包含多个信息字段，包括标题、ID、优先级、描述、OpsItem 的源以及该源的上次更新日期/时间。每个 OpsItem 还包括以下可配置的功能：
  + **状态**：“打开”、“正在进行中”、“已解决”或“打开且正在进行中”。
  + **相关资源**：相关资源是指受影响的资源或已启动创建 OpsItem 的 EventBridge 事件的资源。每个 OpsItem 均包含一个**相关资源**部分，其中 OpsCenter 自动列出了相关资源的 Amazon Resource Name (ARN)。您也可以手动指定相关资源的 ARN。对于一些 ARN 类型，OpsCenter 会自动创建一个深层链接，您可通过该链接查看有关此资源的详细信息，而无需访问其他控制台页面来查看此类信息。例如，如果您指定 EC2 实例的 ARN，则可以在 OpsCenter 中查看 EC2 提供的有关该实例的所有详细信息。您可以手动添加额外的相关资源的 ARN。每个 OpsItem 可以列出最多 100 个相关资源 ARN。有关更多信息，请参阅 [将相关资源添加到 OpsItem](OpsCenter-working-with-OpsItems-adding-related-resources.md)。
  + **相关和相似 OpsItems**：借助**相关 OpsItems** 功能，您可以指定在某些方面与当前 OpsItem 相关的 OpsItems 的 ID。**相似 OpsItem** 功能将自动审查 OpsItem 标题和描述，然后列出可能与您相关或您感兴趣的其他 OpsItems。
  + **可搜索的私有操作数据**：操作数据是一种自定义数据，该数据提供了有关 OpsItem 的有用参考详细信息。例如，您可以指定日志文件、错误字符串、许可密钥、故障排除提示或其他相关数据。请以键/值对的形式输入操作数据。密钥的最大长度为 128 个字符。值最大为 20 KB 大小。

    此自定义数据是可搜索的，但有限制。对于 **Searchable operational data (可搜索的操作数据)** 功能，所有有权访问 OpsItem概览页面（由 [DescribeOpsItems](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeOpsItems.html) API 操作提供）的用户都可以查看和搜索指定的数据。对于 **Private operational data (私有操作数据)** 功能，数据仅可供有权访问 OpsItem（由 [GetOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsItem.html) API 操作提供）的用户查看。
  + **重复数据删除**：通过指定相关资源，OpsCenter 可使用内置逻辑来帮助您避免创建重复的 OpsItems。OpsCenter 还包括一项名为 **操作洞察** 的功能，可显示有关 OpsItems 的重复信息。要进一步限制账户中重复的 OpsItems 的数量，您可以为 EventBridge 事件规则手动指定重复数据删除字符串。有关更多信息，请参阅 [管理重复的 OpsItems](OpsCenter-working-deduplication.md)。
+ **批量编辑 OpsItems**：您可以在 OpsCenter 中选择多个 OpsItems，然后编辑以下字段之一：**Status**（状态）、**Priority**（优先级）、**Severity**（严重性）、**Category**（类别）。
+ **使用运行手册轻松修正**

  每个 OpsItem 均包含一个 **Runbooks (运行手册)** 部分以及一个 Systems Manager 自动化运行手册列表，您可使用这些运行手册自动修正与 AWS 资源相关的常见问题。如果您打开 OpsItem，请为该 OpsItem 选择 AWS 资源，然后在控制台中选择 **Run automation**（运行自动化）按钮，则 OpsCenter 会提供一个自动化运行手册列表，以供您在生成 OpsItem 的 AWS 资源中运行这些运行手册。从 OpsItem 运行自动化运行手册后，运行手册将自动与该 OpsItem 的相关资源关联以供将来参考。此外，如果您通过使用 OpsCenter 在 EventBridge 中自动设置 OpsItem 规则，则 EventBridge 将自动关联常见事件的运行手册。OpsCenter 为特定的 OpsItem 保存 30 天的 自动化运行手册记录。有关更多信息，请参阅 [修复 OpsItem 问题](OpsCenter-remediating.md)。
+ **更改通知**：您可以指定 Amazon Simple Notification Service (SNS) 主题的 ARN 并在更改或编辑 OpsItem 时随时发布通知。SNS 主题必须位于与 OpsItem 相同的 AWS 区域中。
+ **全面的 OpsItem 搜索功能**：OpsCenter 提供多个搜索选项来帮助您快速找到 OpsItems。以下是几个搜索方式的示例：OpsItem ID、标题、上次修改时间、操作数据值、源和运行手册执行的自动化 ID（仅举几例）。您可以使用状态筛选器进一步限制搜索结果。
+ **OpsItem 摘要报告**

  OpsCenter 包含一个摘要报告页面，此页面显示以下部分：
  + **状态摘要**：按状态（“打开”、“正在进行中”、“已解决”和“打开且正在进行中”）显示的 OpsItems 摘要。
  + **具有最常打开的 OpsItems源**：最高 AWS 服务的细分，其具有打开的 OpsItems 。
  + **OpsItems by source and age (按源和使用期限显示的 &OIS;)**：按源和创建天数分组的 OpsItems 的计数。

  有关查看 OpsCenter 摘要报告的更多信息，请参阅 [查看 OpsCenter 摘要报告](OpsCenter-reports.md)。
+ **支持日志记录和审计功能**

  您可以通过与其他 AWS 服务集成来审计和记录 AWS 账户 中的 OpsCenter 用户操作。有关更多信息，请参阅 [查看 OpsCenter 日志和报告](OpsCenter-logging-auditing.md)。
+ **支持通过控制台、CLI、PowerShell 和开发工具包等方式访问 OpsCenter 工具**

  您可以通过 AWS Systems Manager 控制台、AWS Command Line Interface (AWS CLI)、AWS Tools for PowerShell 或您选择的 AWS SDK 来使用 OpsCenter。

## OpsCenter 是否与我的现有用例管理系统集成？
<a name="OpsCenter-learn-more-case-management"></a>

OpsCenter 旨在补充您的现有用例管理系统。您可以使用公有 API 操作将 OpsItems 集成到您的现有用例管理系统中。您还可以维护当前系统中的手动生命周期工作流程，并使用 OpsCenter 作为调查和修正中心。

有关 OpsCenter 公有 API 操作的信息，请参阅*《AWS Systems Manager API 参考》*中的以下 API 操作。
+ [CreateOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CreateOpsItem.html)
+ [DescribeOpsItems](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeOpsItems.html)
+ [GetOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsItem.html)
+ [GetOpsSummary](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsSummary.html)
+ [UpdateOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_UpdateOpsItem.html)

## 使用 OpsCenter 是否需要收取费用？
<a name="OpsCenter-learn-more-cost"></a>

可以。有关更多信息，请参阅[AWS Systems Manager定价](https://aws.amazon.com/systems-manager/pricing/)。

## OpsCenter 是否使用我的本地和混合托管式节点？
<a name="OpsCenter-learn-more-hybrid"></a>

可以。若问题与为 Systems Manager 配置的本地托管式节点相关，您可以使用 OpsCenter 来调查和修正这些问题。有关为 Systems Manager 设置和配置本地服务器和虚拟机的更多信息，请参阅 [使用 Systems Manager 管理混合和多云环境中的节点](systems-manager-hybrid-multicloud.md)。

## OpsCenter 的配额是多少？
<a name="OpsCenter-learn-more-limits"></a>

在《Amazon Web Services 一般参考》**的 [Systems Manager service quotas](https://docs.aws.amazon.com/general/latest/gr/ssm.html#limits_ssm) 中，您可以查看所有 Systems Manager 工具的限额。除非另有说明，否则每个配额都是特定于区域的。

# 设置 OpsCenter
<a name="OpsCenter-setup"></a>

AWS Systems Manager 可以使用集成设置体验来帮助您开始使用 OpsCenter 和 Explorer（都是 Systems Manager 中的工具）。Explorer 是一个可自定义的操作控制面板，用于报告有关您 AWS 资源的信息。在本文档中，Explorer 和 OpsCenter 设置称为*集成设置*。

必须使用“集成设置”借助 Explorer 设置 OpsCenter。集成设置仅在 AWS Systems Manager 控制台中可用。您无法以编程方式设置 Explorer 和 OpsCenter。有关更多信息，请参阅 [Systems Manager Explorer 和 OpsCenter 入门](Explorer-setup.md)。

**开始前的准备工作**  
设置 OpsCenter 后，您将在 Amazon EventBridge 中启用会自动创建 OpsItems 的默认规则。下表描述了自动创建 OpsItems 的默认 EventBridge 规则。您可以在 OpsCenter **设置**页面的 **OpsItem 规则**下禁用 EventBridge 规则。

**重要**  
您的账户需要为默认规则创建的 OpsItems 付费。有关更多信息，请参阅 [AWS Systems Manager 定价](https://aws.amazon.com/systems-manager/pricing/)。


****  

| Rule name（规则名称） | 描述 | 
| --- | --- | 
|  SSMOpsItems-Autoscaling-instance-launch-failure  |  此规则将在启动 EC2 Auto Scaling 实例失败时创建 OpsItems。  | 
|  SSMOpsItems-Autoscaling-instance-termination-failure  |  此规则将在终止 EC2 Auto Scaling 实例失败时创建 OpsItems。  | 
|  SSMOpsItems-EBS-snapshot-copy-failed  |  此规则将在系统无法复制 Amazon Elastic Block Store（Amazon EBS）快照时创建 OpsItems。  | 
|  SSMOpsItems-EBS-snapshot-creation-failed  |  此规则将在系统无法创建 Amazon EBS 快照时创建 OpsItems。  | 
|  SSMOpsItems-EBS-volume-performance-issue  |  此规则对应于 AWS Health 跟踪规则。每当 Amazon EBS 卷出现性能问题（运行状况事件 = `AWS_EBS_DEGRADED_EBS_VOLUME_PERFORMANCE`）时，此规则都会创建 OpsItems。  | 
|  SSMOpsItems-EC2-issue  |  此规则对应于跟踪影响 AWS 服务或资源的意外事件的 AWS Health 跟踪规则。例如，当服务发出有关导致服务降级的运营问题，或者旨在提醒注意本地资源级别的问题的通信时，该规则就会创建 OpsItems。例如，此规则将为下列事件创建 OpsItem：`AWS_EC2_OPERATIONAL_ISSUE`。  | 
|  SSMOpsItems-EC2-scheduled-change  |  此规则对应于 AWS Health 跟踪规则。AWS 可为实例计划相关事件，例如重启、停止或启动实例。该规则将为 EC2 计划事件创建 OpsItems。有关计划事件的更多信息，请参阅《Amazon EC2 用户指南》**中的 [实例的计划事件](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check_sched.html)。  | 
|  SSMOpsItems-RDS-issue  |  此规则对应于跟踪影响 AWS 服务或资源的意外事件的 AWS Health 跟踪规则。例如，当服务发出有关导致服务降级的运营问题，或者旨在提醒注意本地资源级别的问题的通信时，该规则就会创建 OpsItems。例如，此规则将为下列事件创建 OpsItem：`AWS_RDS_MYSQL_DATABASE_CRASHING_REPEATEDLY`、`AWS_RDS_EXPORT_TASK_FAILED` 和 `AWS_RDS_CONNECTIVITY_ISSUE`。  | 
|  SSMOpsItems-RDS-scheduled-change  |  此规则对应于 AWS Health 跟踪规则。该规则将为 Amazon RDS 计划事件创建 OpsItems。计划事件提供了有关 Amazon RDS 资源即将发生的更改的信息。某些事件可能会建议您执行操作以避免服务中断。其他事件则可能会自动发生，无需您执行任何操作。在执行计划的更改活动期间，您的资源可能暂时不可用。例如，此规则将为下列事件创建 OpsItem：`AWS_RDS_SYSTEM_UPGRADE_SCHEDULED` 和 `AWS_RDS_MAINTENANCE_SCHEDULED`。有关计划事件的更多信息，请参阅《AWS Health 用户指南》中的 [事件类型类别](https://docs.aws.amazon.com/health/latest/ug/aws-health-concepts-and-terms.html#event-type-categories)**。  | 
|  SSMOpsItems-SSM-maintenance-window-execution-failed  |  此规则将在 Systems Manager 维护时段处理失败时创建 OpsItems。  | 
|  SSMOpsItems-SSM-maintenance-window-execution-timedout  |  此规则在 Systems Manager 维护时段启动超时时创建 OpsItems。  | 

请使用以下过程设置 OpsCenter。

**要设置 OpsCenter，请按以下步骤操作：**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，选择 **OpsCenter**。

1. 在 OpsCenter 主页上，选择**开始使用**。

1. 在 OpsCenter 设置页面上，选择**启用此选项，以便让 Explorer 根据常用规则和事件配置 AWS Config 和 Amazon CloudWatch Events，以自动创建 OpsItems**。如果您不选择此选项，OpsCenter 将保持禁用状态。
**注意**  
Amazon EventBridge（前身为 Amazon CloudWatch Events）提供了 CloudWatch Events 的所有功能和一些新功能，如自定义事件总线、第三方事件源和架构注册表。

1. 请选择**启用OpsCenter**。

当您启用 OpsCenter 后，可以从**设置**中执行以下操作：
+ 使用**打开 CloudWatch 控制台**按钮创建 CloudWatch 警报。有关更多信息，请参阅 [将 CloudWatch 警报配置为创建 OpsItems](OpsCenter-create-OpsItems-from-CloudWatch-Alarms.md)。
+ 启用运营洞察。有关更多信息，请参阅 [分析运营洞察以减少 OpsItems](OpsCenter-working-operational-insights.md)。
+ 启用 AWS Security Hub CSPM 结果警报。有关更多信息，请参阅 [了解 OpsCenter 与 AWS Security Hub CSPM 的集成](OpsCenter-applications-that-integrate.md#OpsCenter-integrate-with-security-hub)。

**Topics**
+ [（可选）将 OpsCenter 设置为跨账户集中管理 OpsItems](OpsCenter-setting-up-cross-account.md)
+ [（可选）设置 Amazon SNS 以接收关于 OpsItems 的通知](OpsCenter-getting-started-sns.md)

# （可选）将 OpsCenter 设置为跨账户集中管理 OpsItems
<a name="OpsCenter-setting-up-cross-account"></a>

您可以使用 Systems Manager OpsCenter 在选定 AWS 区域 中的多个 AWS 账户 中集中管理 OpsItems。当您在 AWS Organizations 中设置组织后此功能可用。AWS Organizations 是一项账户管理服务，使您能够将多个 AWS 账户整合到您创建并集中管理的组织中。AWS Organizations 包含账户管理和整合账单功能，可利用这些功能更好地满足企业的预算、安全性和合规性需求。有关更多信息，请参阅《AWS Organizations 用户指南》**中的[什么是 AWS Organizations？](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)

属于 AWS Organizations 管理账户的用户，可以设置 Systems Manager 的委派管理员账户。在 OpsCenter 的上下文中，委派管理员可以在成员账户中创建、编辑和查看 OpsItems。委派管理员还可以使用 Systems Manager 自动化运行手册批量解决 OpsItems 或修复与生成 OpsItems 的 AWS 资源相关的问题。

**注意**  
您只能指定一个账户作为 Systems Manager 的委派管理员。有关更多信息，请参阅 [为 Systems Manager 创建 AWS Organizations 委派管理员](setting_up_delegated_admin.md)。

Systems Manager 提供了以下 OpsCenter 设置方法，用于在多个 AWS 账户 之间集中管理 OpsItems。
+ **快速设置功能**：快速设置功能是 Systems Manager 中的一项工具，其简化了 Systems Manager 工具的设置和配置任务。有关更多信息，请参阅 [AWS Systems Manager Quick Setup](systems-manager-quick-setup.md)。

  OpsCenter 的快速设置功能可帮助您完成以下跨账户管理 OpsItems 的任务：
  + 将账户注册为委派管理员（如果尚未指定委派管理员）
  + 创建必需的 AWS Identity and Access Management（IAM）策略和角色
  + 指定一个 AWS Organizations 组织或组织单位（OU），委派管理员可以在其中跨账户管理 OpsItems

  有关更多信息，请参阅 [（可选）使用 Quick Setup 配置 OpsCenter 以跨账户管理 OpsItems](OpsCenter-quick-setup-cross-account.md)。
**注意**  
并非所有当前 Systems Manager 可用的 AWS 区域 都提供快速设置功能。如果快速设置功能在某区域不可用，而您希望使用它在该区域配置 OpsCenter 从而跨多个账户集中管理 OpsItems，则必须使用手动方法。要查看快速设置功能可用的 AWS 区域 列表，请参阅 [Quick Setup 在 AWS 区域 中的可用性](systems-manager-quick-setup.md#quick-setup-getting-started-regions)。
+ **手动设置**：如果快速设置功能在某区域不可用，而您希望使用它在该区域配置 OpsCenter 从而跨账户集中管理 OpsItems，则您可以使用手动步骤来实现。有关更多信息，请参阅 [（可选）将 OpsCenter 手动设置为跨账户集中管理 OpsItems](OpsCenter-getting-started-multiple-accounts.md)。

# （可选）使用 Quick Setup 配置 OpsCenter 以跨账户管理 OpsItems
<a name="OpsCenter-quick-setup-cross-account"></a>

Quick Setup是 AWS Systems Manager 中的一项工具，其简化了 Systems Manager 工具的设置和配置任务。OpsCenter 的Quick Setup可帮助您完成以下跨账户管理 OpsItems 的任务：
+ 指定委派管理员账户
+ 创建必需的 AWS Identity and Access Management（IAM）policy 和角色
+ 指定一个 AWS Organizations 组织或成员账户的子集，委派管理员可以在其中跨账户管理 OpsItems

当您使用快速设置功能配置 OpsCenter 以跨账户管理 OpsItems 时，Quick Setup 将在指定账户中创建以下资源。这些资源授予指定账户权限以使用 OpsItems，并使用自动化运行手册来修复生成 OpsItems 的 AWS 资源的相关问题。


****  

| 资源 | 账户 | 
| --- | --- | 
|  `AWSServiceRoleForAmazonSSM_AccountDiscovery` AWS Identity and Access Management（IAM）服务相关角色 有关该角色的更多信息，请参阅[使用角色为 OpsCenter 和 Explorer 收集 AWS 账户 信息](using-service-linked-roles-service-action-2.md)。  |  AWS Organizations 管理账户和委派管理员账户  | 
|  `OpsItem-CrossAccountManagementRole` IAM 角色  `AWS-SystemsManager-AutomationAdministrationRole` IAM 角色  |  委派管理员帐户  | 
|  `OpsItem-CrossAccountExecutionRole` IAM 角色  `AWS-SystemsManager-AutomationExecutionRole` IAM 角色  默认 OpsItem 组的 `AWS::SSM::ResourcePolicy` Systems Manager 资源策略（`OpsItemGroup`）  |  所有 AWS Organizations 成员账户  | 

**注意**  
如果您之前配置了 OpsCenter 以便使用[手动方法](https://docs.aws.amazon.com/systems-manager/latest/userguide/OpsCenter-getting-started-multiple-accounts.html)跨账户管理 OpsItems，则必须删除在该过程的步骤 4 和步骤 5 中创建的 AWS CloudFormation 堆栈或堆栈集。如果您完成以下步骤时您的账户中存在这些资源，则 Quick Setup 无法正确配置跨账户 OpsItem 管理。

**使用快速设置功能配置 OpsCenter，以跨账户管理 OpsItems**

1. 使用 AWS Organizations 管理账户登录 AWS 管理控制台。

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **Quick Setup**。

1. 选择**库**选项卡。

1. 滚动到底部并找到 **OpsCenter** 配置图块。选择**创建**。

1. 在 Quick SetupOpsCenter 页面上的**委派管理员**部分，输入账户 ID。如果您无法编辑此字段，则表示已经为 Systems Manager 指定了委派管理员账户。

1. 在 **Targets** 部分中，选择选项。如果选择**自定义**，则选择要在其中跨账户管理 OpsItems 的组织单位（OU）。

1. 选择**创建**。

Quick Setup 创建 OpsCenter 配置并将所需 AWS 资源部署到指定的 OU。

**注意**  
如果您不想跨多个账户管理 OpsItems，可以从 Quick Setup 中删除配置。删除配置时，Quick Setup 会删除最初部署配置时创建的以下 IAM policy 和角色：  
来自委派管理员账户的 `OpsItem-CrossAccountManagementRole`
来自所有 Organizations 成员账户的 `OpsItem-CrossAccountExecutionRole` 和 `SSM::ResourcePolicy`
Quick Setup 从所有组织单位和最初部署配置所在的 AWS 区域 移除配置。

## 排查 OpsCenter 的 Quick Setup 配置问题
<a name="OpsCenter-quick-setup-cross-account-troubleshooting"></a>

本部分包含的信息可帮助您解决在使用 Quick Setup 配置跨账户 OpsItem 管理时遇到的问题。

**Topics**
+ [部署到这些堆栈集失败：delegatedAdmin](#OpsCenter-quick-setup-cross-account-troubleshooting-stack-set-failed)
+ [Quick Setup 配置状态显示失败](#OpsCenter-quick-setup-cross-account-troubleshooting-configuration-failed)

### 部署到这些堆栈集失败：delegatedAdmin
<a name="OpsCenter-quick-setup-cross-account-troubleshooting-stack-set-failed"></a>

创建 OpsCenter 配置时，Quick Setup 会在 Organizations 管理账户中部署两个 AWS CloudFormation 堆栈集。堆栈集使用以下前缀：`AWS-QuickSetup-SSMOpsCenter`。如果 Quick Setup 显示以下错误：`Deployment to these StackSets failed: delegatedAdmin`，请使用以下步骤修复此问题。

**排查堆栈集失败的问题：delegatedAdmin 错误**

1. 如果您在 Quick Setup 控制台的红色横幅中收到 `Deployment to these StackSets failed: delegatedAdmin` 错误，请登录到委派管理员账户和指定为 Quick Setup 主区域的 AWS 区域。

1. 通过以下网址打开 CloudFormation 控制台：[https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)。

1. 请选择您的 Quick Setup 配置创建的堆栈。堆栈名称包括以下内容：**AWS-QuickSetup-SSMOpsCenter**。
**注意**  
CloudFormation 有时会删除失败的堆栈部署。如果堆栈未提供在 **Stacks**（堆栈）表中，请从筛选条件列表中选择 **Deleted**（已删除）。

1. 请查看 **Status**（状态）和 **Status reason**（状态原因）。有关堆栈状态的更多信息，请参阅 *AWS CloudFormation 用户指南*中的[堆栈状态代码](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html#cfn-console-view-stack-data-resources-status-codes)。

1. 要了解失败的确切步骤，请查看 **Events**（事件）选项卡并查看每个事件的**状态**。有关更多信息，请参阅《AWS CloudFormation User Guide》**中的 [Troubleshooting](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html)。

**注意**  
如果您无法使用 CloudFormation 问题排查步骤解决部署失败问题，请删除配置并再次尝试。

### Quick Setup 配置状态显示失败
<a name="OpsCenter-quick-setup-cross-account-troubleshooting-configuration-failed"></a>

如果**配置详细信息**页面上的**配置详细信息**表显示配置状态为 `Failed`，请登录到失败的 AWS 账户 和区域。

**排查创建 OpsCenter 配置时的 Quick Setup 失败问题**

1. 登录到失败发生的 AWS 账户和 AWS 区域。

1. 通过以下网址打开 CloudFormation 控制台：[https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)。

1. 请选择您的 Quick Setup 配置创建的堆栈。堆栈名称包括以下内容：**AWS-QuickSetup-SSMOpsCenter**。
**注意**  
CloudFormation 有时会删除失败的堆栈部署。如果堆栈未提供在 **Stacks**（堆栈）表中，请从筛选条件列表中选择 **Deleted**（已删除）。

1. 请查看 **Status**（状态）和 **Status reason**（状态原因）。有关堆栈状态的更多信息，请参阅 *AWS CloudFormation 用户指南*中的[堆栈状态代码](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html#cfn-console-view-stack-data-resources-status-codes)。

1. 要了解失败的确切步骤，请查看 **Events**（事件）选项卡并查看每个事件的**状态**。有关更多信息，请参阅《AWS CloudFormation User Guide》**中的 [Troubleshooting](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html)。

#### 成员账户配置显示 ResourcePolicyLimitExceededException
<a name="OpsCenter-quick-setup-cross-account-troubleshooting-policy-limit-exception"></a>

如果堆栈状态显示 `ResourcePolicyLimitExceededException`，则表示该账户之前已使用[手动方法](https://docs.aws.amazon.com/systems-manager/latest/userguide/OpsCenter-getting-started-multiple-accounts.html)载入了 OpsCenter 跨账户管理。要解决此问题，您必须删除在手动载入流程的步骤 4 和步骤 5 中创建的 AWS CloudFormation 堆栈或堆栈集。有关详细信息，请参阅《AWS CloudFormation User Guide》**中的 [Delete a stack set](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-delete.html) 和 [Deleting a stack on the CloudFormation console](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html)。

# （可选）将 OpsCenter 手动设置为跨账户集中管理 OpsItems
<a name="OpsCenter-getting-started-multiple-accounts"></a>

本节介绍如何为跨账户 OpsItem 管理手动配置 OpsCenter。虽然仍支持此进程，但它已被使用 Systems Manager Quick Setup 的新进程所取代。有关更多信息，请参阅 [（可选）使用 Quick Setup 配置 OpsCenter 以跨账户管理 OpsItems](OpsCenter-quick-setup-cross-account.md)。

您可以设置一个中央账户为成员账户手动创建 OpsItems，并管理和修复这些 OpsItems。中央账户可以是 AWS Organizations 管理账户，也可以是 AWS Organizations 管理账户兼 Systems Manager 委派管理员账户。我们建议您使用 Systems Manager 委派管理员账户作为中央账户。您只能在配置 AWS Organizations 后使用此功能。

借助 AWS Organizations，您可以将多个 AWS 账户 整合到您创建并集中管理的组织中。中央账户用户可以同时为所有选定的成员账户创建 OpsItems 并管理这些 OpsItems。

使用本节中的过程在“组织”中启用 Systems Manager 服务主体，并配置 AWS Identity and Access Management（IAM）权限，以便跨账户使用 OpsItems。

**Topics**
+ [开始前的准备工作](#OpsCenter-before-you-begin)
+ [步骤 1：创建资源数据同步](#OpsCenter-getting-started-multiple-accounts-onboarding-rds)
+ [步骤 2：在 AWS Organizations 中启用 Systems Manager 服务主体](#OpsCenter-getting-started-multiple-accounts-onboarding-service-principal)
+ [步骤 3：创建 `AWSServiceRoleForAmazonSSM_AccountDiscovery` 服务相关角色](#OpsCenter-getting-started-multiple-accounts-onboarding-SLR)
+ [步骤 4：配置用于跨账户使用 OpsItems 的权限](#OpsCenter-getting-started-multiple-accounts-onboarding-resource-policy)
+ [步骤 5：配置用于跨账户使用相关资源的权限](#OpsCenter-getting-started-multiple-accounts-onboarding-related-resources-permissions)

**注意**  
当在 OpsCenter 中跨账户工作时，仅支持 `/aws/issue` 类型的 OpsItems。

## 开始前的准备工作
<a name="OpsCenter-before-you-begin"></a>

在将 OpsCenter 设置为跨账户使用 OpsItems 之前，请确保已设置以下内容：
+ Systems Manager 委托管理员账户。有关更多信息，请参阅 [为 Explorer 配置委派管理员](Explorer-setup-delegated-administrator.md)。
+ 已在组织中设置和配置了一个组织。有关更多信息，请参阅 *AWS Organizations 用户指南*中的[创建并管理组织](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org.html)。
+ 您将 Systems Manager Automation 配置为跨多个 AWS 区域 和 AWS 账户运行自动化运行手册。有关更多信息，请参阅 [在多个 AWS 区域 和账户中运行自动化](running-automations-multiple-accounts-regions.md)。

## 步骤 1：创建资源数据同步
<a name="OpsCenter-getting-started-multiple-accounts-onboarding-rds"></a>

设置和配置 AWS Organizations 后，您可以通过创建资源数据同步在 OpsCenter 中为整个组织聚合 OpsItems。有关更多信息，请参阅 [创建资源数据同步](Explorer-resource-data-sync-configuring-multi.md)。创建同步时，请务必在**添加账户**部分中选择**包括我的 AWS Organizations 配置中的所有账户**选项。

## 步骤 2：在 AWS Organizations 中启用 Systems Manager 服务主体
<a name="OpsCenter-getting-started-multiple-accounts-onboarding-service-principal"></a>

要让用户能够跨账户使用 OpsItems，必须在 AWS Organizations 中启用 Systems Manager 服务主体。如果您以前使用其他工具为多账户方案配置了 Systems Manager，则 Organizations 中可能已经配置 Systems Manager 服务主体。从（AWS Command Line InterfaceAWS CLI）运行以下命令以进行验证。如果您*尚未*为其他多账户方案配置 Systems Manager，请跳到下一个步骤，即*在 AWS Organizations 中启用 Systems Manager 服务主体*。

**验证 AWS Organizations 中是否启用了 Systems Manager 服务主体**

1. 在本地计算机上，[下载](https://aws.amazon.com/cli/)最新版本的 AWS CLI。

1. 打开 AWS CLI，然后运行以下命令，以指定您的凭证和 AWS 区域。

   ```
   aws configure
   ```

   系统将提示您指定以下内容。在以下示例中，将每个*用户输入占位符*替换为您自己的信息。

   ```
   AWS Access Key ID [None]: key_name
   AWS Secret Access Key [None]: key_name
   Default region name [None]: region
   Default output format [None]: ENTER
   ```

1. 运行以下命令以验证是否为 AWS Organizations 启用了 Systems Manager 服务主体。

   ```
   aws organizations list-aws-service-access-for-organization
   ```

   该命令会返回类似以下示例中显示的信息。

   ```
   {
       "EnabledServicePrincipals": [
           {
               "ServicePrincipal": "member.org.stacksets.cloudformation.amazonaws.com",
               "DateEnabled": "2020-12-11T16:32:27.732000-08:00"
           },
           {
               "ServicePrincipal": "opsdatasync.ssm.amazonaws.com",
               "DateEnabled": "2022-01-19T12:30:48.352000-08:00"
           },
           {
               "ServicePrincipal": "ssm.amazonaws.com",
               "DateEnabled": "2020-12-11T16:32:26.599000-08:00"
           }
       ]
   }
   ```

**在 AWS Organizations 中启用 Systems Manager 服务主体**

如果您以前未为“组织”配置 Systems Manager 服务主体，请按照以下步骤执行此操作。有关此命令的更多信息，请参阅*AWS CLI 命令参考* 中的 [enable-aws-service-access](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/enable-aws-service-access.html) 。

1. 安装并配置 AWS Command Line Interface（AWS CLI）（如果尚未执行该操作）。有关信息，请参阅[安装 CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 和[配置 CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)。

1. 在本地计算机上，[下载](https://aws.amazon.com/cli/)最新版本的 AWS CLI。

1. 打开 AWS CLI，然后运行以下命令，以指定您的凭证和 AWS 区域。

   ```
   aws configure
   ```

   系统将提示您指定以下内容。在以下示例中，将每个*用户输入占位符*替换为您自己的信息。

   ```
   AWS Access Key ID [None]: key_name
   AWS Secret Access Key [None]: key_name
   Default region name [None]: region
   Default output format [None]: ENTER
   ```

1. 运行以下命令为 AWS Organizations 启用 Systems Manager 服务主体。

   ```
   aws organizations enable-aws-service-access --service-principal "ssm.amazonaws.com"
   ```

## 步骤 3：创建 `AWSServiceRoleForAmazonSSM_AccountDiscovery` 服务相关角色
<a name="OpsCenter-getting-started-multiple-accounts-onboarding-SLR"></a>

服务相关角色（如 `AWSServiceRoleForAmazonSSM_AccountDiscovery` 角色）是一种与（AWS 服务如 Systems Manager）直接关联的独特类型的 IAM 角色。服务相关角色由服务预定义，具有服务代表您调用其他 AWS 服务 所需的所有权限。有关 `AWSServiceRoleForAmazonSSM_AccountDiscovery` 服务相关角色的更多信息，请参阅[Systems Manager 账户发现的服务相关角色权限](using-service-linked-roles-service-action-2.md#service-linked-role-permissions-service-action-2)。

使用以下过程，通过利用 AWS CLI 创建 `AWSServiceRoleForAmazonSSM_AccountDiscovery` 服务相关角色。有关在此步骤中使用的命令的更多信息，请参阅*AWS CLI 命令参考*中的 [create-service-linked-role](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-service-linked-role.html)。

**创建 `AWSServiceRoleForAmazonSSM_AccountDiscovery` 服务相关角色**

1. 登录 AWS Organizations 管理账户。

1. 登录“组织”管理账户时，运行以下命令。

   ```
   aws iam create-service-linked-role \
       --aws-service-name accountdiscovery.ssm.amazonaws.com \
       --description "Systems Manager account discovery for AWS Organizations service-linked role"
   ```

## 步骤 4：配置用于跨账户使用 OpsItems 的权限
<a name="OpsCenter-getting-started-multiple-accounts-onboarding-resource-policy"></a>

使用 AWS CloudFormation 堆栈集创建 `OpsItemGroup` 资源策略和 IAM 执行角色，以授予用户跨账户使用 OpsItems 的权限。首先，请下载并解压 [https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/OpsCenterCrossAccountMembers.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/OpsCenterCrossAccountMembers.zip) 文件。此文件包含 `OpsCenterCrossAccountMembers.yaml` CloudFormation 模板文件。使用此模板创建堆栈集时，CloudFormation 会自动在账户中创建 `OpsItemCrossAccountResourcePolicy` 资源策略和 `OpsItemCrossAccountExecutionRole` 执行角色。有关创建堆栈集的更多信息，请参阅 *AWS CloudFormation 用户指南*中的 [Create a stack set](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-getting-started-create.html)（创建堆栈集）。

**重要**  
请注意有关此任务的以下重要信息：  
您必须在登录到 AWS Organizations 管理账户时部署该堆栈集。
您必须在登录到您要*设置为目标*的*每个*账户时重复此过程，以便跨账户（包括委托管理员账户）使用 OpsItems。
如果您想在不同的 AWS 区域 中启用跨账户 OpsItems 管理，请在模板的 **Specify regions**（指定区域）部分中选择 **Add all regions**（添加所有区域）。选择加入区域不支持跨账户 OpsItem 管理。

## 步骤 5：配置用于跨账户使用相关资源的权限
<a name="OpsCenter-getting-started-multiple-accounts-onboarding-related-resources-permissions"></a>

OpsItem 可以包括有关受影响资源的详细信息，如 Amazon Elastic Compute Cloud（Amazon EC2）实例或 Amazon Simple Storage Service（Amazon S3）存储桶。您在“步骤 4”中创建的 `OpsItemCrossAccountExecutionRole` 执行角色将为 OpsCenter 提供只读权限，以便成员账户查看相关资源。您还必须创建 IAM 角色 以向管理账户提供查看相关资源和与之交互的权限，您将在本任务中完成此操作。

首先，请下载并解压 [https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/OpsCenterCrossAccountManagementRole.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/OpsCenterCrossAccountManagementRole.zip) 文件。此文件包含 `OpsCenterCrossAccountManagementRole.yaml` CloudFormation 模板文件。当您使用此模板创建堆栈时，CloudFormation 会自动在账户中创建 `OpsCenterCrossAccountManagementRole` IAM 角色。有关创建堆栈集的更多信息，请参阅**《AWS CloudFormation 用户指南》中的[在 AWS CloudFormation 控制台上创建堆栈](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)。

**重要**  
请注意有关此任务的以下重要信息：  
如果您计划指定一个账户作为 OpsCenter 的委派管理员，请务必在创建堆栈时指定 AWS 账户。
您必须在登录到 AWS Organizations 管理账户时执行此过程，并在登录到委托管理员账户时再次执行此过程。

# （可选）设置 Amazon SNS 以接收关于 OpsItems 的通知
<a name="OpsCenter-getting-started-sns"></a>

您可以将 OpsCenter 配置为在系统创建 OpsItem 或更新现有 OpsItem 时，向 Amazon Simple Notification Service（Amazon SNS）主题发送通知。

完成以下步骤以接收 OpsItems 的通知。
+ [步骤 1：创建并订阅 Amazon SNS 主题](#OpsCenter-getting-started-sns-create-topic)
+ [步骤 2：更新 Amazon SNS 访问策略](#OpsCenter-getting-started-sns-encryption-policy)
+ [步骤 3：更新 AWS KMS 访问策略](#OpsCenter-getting-started-sns-KMS-policy)
**注意**  
如果您在“步骤 2”中打开了 AWS Key Management Service（AWS KMS）服务器端加密，则必须完成“步骤 3”。否则，可以跳过“步骤 3”。
+ [步骤 4：打开默认 OpsItems 规则以针对新的 OpsItems 发送通知](#OpsCenter-getting-started-sns-default-rules)

## 步骤 1：创建并订阅 Amazon SNS 主题
<a name="OpsCenter-getting-started-sns-create-topic"></a>

要接收通知，您必须创建并订阅 Amazon SNS 主题。有关更多信息，请参阅 *Amazon Simple Notification Service Developer Guide* 中的[创建 Amazon SNS 主题](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html)和[订阅 Amazon SNS 主题](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-subscribe-endpoint-to-topic.html)。

**注意**  
如果您在多个 AWS 区域 或账户中使用 OpsCenter，则必须在*每个*要接收 OpsItem 通知的区域或账户中创建并订阅 Amazon SNS 主题。

## 步骤 2：更新 Amazon SNS 访问策略
<a name="OpsCenter-getting-started-sns-encryption-policy"></a>

您必须将 Amazon SNS 主题与 OpsItems 关联。使用以下过程设置 Amazon SNS 访问策略，以便 Systems Manager 能将 OpsItems 通知发布到您在步骤 1 中创建的 Amazon SNS 主题。

1. 访问 [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home)，登录 AWS 管理控制台 并打开 Amazon SNS 控制台。

1. 在导航窗格中，选择 **Topics（主题）**。

1. 选择您在“步骤 1”中创建的主题，然后选择**编辑**。

1. 展开**访问策略**。

1. 将以下 `Sid` 数据块添加到现有策略。将每个*示例资源占位符*替换为您自己的信息。

   ```
   {
         "Sid": "Allow OpsCenter to publish to this topic",
         "Effect": "Allow",
         "Principal": {
           "Service": "ssm.amazonaws.com"
         },
         "Action": "SNS:Publish",
         "Resource": "arn:aws:sns:region:account ID:topic name", // Account ID of the SNS topic owner
         "Condition": {
         "StringEquals": {
           "AWS:SourceAccount": "account ID" //  Account ID of the OpsItem owner
         }
      }
   }
   ```
**注意**  
使用 `aws:SourceAccount` 全局条件键来防止混淆代理场景。要使用此条件键，请将值设置为 OpsItem 所有者的账户 ID。有关更多信息，请参阅《IAM 用户指南》**中的[混淆代理](https://docs.aws.amazon.com//IAM/latest/UserGuide/confused-deputy.html)。

1. 选择**保存更改**。

现在，当创建或更新 OpsItems 时，系统会向 Amazon SNS 主题发送通知。

**重要**  
如果使用 AWS Key Management Service（AWS KMS）服务器端加密密钥配置 Amazon SNS 主题，则必须完成步骤 3。否则，可以跳过“步骤 3”。

## 步骤 3：更新 AWS KMS 访问策略
<a name="OpsCenter-getting-started-sns-KMS-policy"></a>

如果您为 Amazon SNS 主题启用了 AWS KMS 服务器端加密，则还必须更新您在配置主题时选择的 AWS KMS key 的访问策略。使用以下过程更新访问策略，以便 Systems Manager 能将 OpsItem 通知发布到您在“步骤 1”中创建的 Amazon SNS 主题。

**注意**  
OpsCenter 不支持将 OpsItems 发布到使用 AWS 托管式密钥 配置的 Amazon SNS 主题。

1. 从 [https://console.aws.amazon.com/kms](https://console.aws.amazon.com/kms) 打开 AWS KMS 控制台。

1. 要更改 AWS 区域，请使用页面右上角的区域选择器。

1. 在导航窗格中，选择**客户托管密钥**。

1. 选择您在创建主题时选择的 KMS 密钥的 ID。

1. 在 **Key Policy (密钥策略)** 部分中，选择 **Switch to policy view (切换到策略视图)**。

1. 选择**编辑**。

1. 将以下 `Sid` 数据块添加到现有策略。将每个*示例资源占位符*替换为您自己的信息。

   ```
   {
         "Sid": "Allow OpsItems to decrypt the key",
         "Effect": "Allow",
         "Principal": {
           "Service": "ssm.amazonaws.com"
         },
         "Action": ["kms:Decrypt", "kms:GenerateDataKey*"],
          "Resource": "arn:aws:kms:region:account ID:key/key ID"
       }
   ```

    在下面的示例中，在第 14 行输入新块。  
![\[编辑 Amazon SNS 主题的 AWS KMS 访问策略。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_SNS_KMS_access_policy.png)

1. 选择**保存更改**。

## 步骤 4：打开默认 OpsItems 规则以针对新的 OpsItems 发送通知
<a name="OpsCenter-getting-started-sns-default-rules"></a>

未使用 Amazon 资源名称（ARN）针对 Amazon SNS 通知配置 Amazon EventBridge 中的默认 OpsItems 规则。使用以下过程编辑 EventBridge 中的规则并输入 `notifications` 数据块。

**将通知块添加到默认 OpsItem 规则**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择 **OpsItems** 选项卡，然后选择 **Configure sources (配置源)**。

1. 选择您要使用 `notifications` 块配置的源规则的名称，如以下示例所示：  
![\[选择 Amazon EventBridge 规则以添加 Amazon SNS 通知块。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_SNS_Setup_2.png)

   该规则将在 Amazon EventBridge 中打开。

1. 在规则详细信息页面的 **Targets**（目标）选项卡上，选择 **Edit**（编辑）。

1. 在 **Additional settings**（其他设置）部分，选择 **Configure input transformer**（配置输入转换器）。

1. 在**模板**框中，添加一个具有以下格式的 `notifications` 块：

   ```
   "notifications":[{"arn":"arn:aws:sns:region:account ID:topic name"}],
   ```

   以下为示例。

   ```
   "notifications":[{"arn":"arn:aws:sns:us-west-2:1234567890:MySNSTopic"}],
   ```

   在 `resources` 块之前输入通知块，如以下美国西部（俄勒冈州）（us-west-2）区域示例所示。

   ```
   {
       "title": "EBS snapshot copy failed",
       "description": "CloudWatch Event Rule SSMOpsItems-EBS-snapshot-copy-failed was triggered. Your EBS snapshot copy has failed. See below for more details.",
       "category": "Availability",
       "severity": "2",
       "source": "EC2",
       "notifications": [{
           "arn": "arn:aws:sns:us-west-2:1234567890:MySNSTopic"
       }],
       "resources": <resources>,
       "operationalData": {
           "/aws/dedup": {
               "type": "SearchableString",
               "value": "{\"dedupString\":\"SSMOpsItems-EBS-snapshot-copy-failed\"}"
           },
           "/aws/automations": {
               "value": "[ { \"automationType\": \"AWS:SSM:Automation\", \"automationId\": \"AWS-CopySnapshot\" } ]"
           },
           "failure-cause": {
               "value": <failure - cause>
           },
           "source": {
               "value": <source>
           },
           "start-time": {
               "value": <start - time>
           },
           "end-time": {
               "value": <end - time>
           }
       }
   }
   ```

1. 选择**确认**。

1. 选择**下一步**。

1. 选择**下一步**。

1. 选择**更新规则**。

当系统下次为默认规则创建 OpsItem 时，系统会向 Amazon SNS 主题发布通知。

# 将 OpsCenter 与其他 AWS 服务 集成
<a name="OpsCenter-applications-that-integrate"></a>

OpsCenter 是 AWS Systems Manager 中的一项工具，可以与多个 AWS 服务集成，用于诊断和修复 AWS 资源的问题。您必须先设置 AWS 服务，然后才能将其与 OpsCenter 集成。

默认情况下，以下 AWS 服务 将与 OpsCenter 集成，并可自动创建 OpsItems：
+ [Amazon CloudWatch](#OpsCenter-about-cloudwatch)
+ [Amazon CloudWatch Application Insights](#OpsCenter-about-cloudwatch-insights)
+ [Amazon EventBridge](#OpsCenter-about-eventbridge)
+ [AWS Config](#OpsCenter-about-AWS-config)
+ [AWS Systems Manager Incident Manager](#OpsCenter-about-incident-manager)

您必须将以下服务与 OpsCenter 集成，才能自动创建 OpsItems：
+ [Amazon DevOps Guru](#OpsCenter-integrate-with-devops-guru)
+ [AWS Security Hub CSPM](#OpsCenter-integrate-with-security-hub)

当这些服务中的任何服务创建 OpsItem 时，您都可以从 OpsCenter 管理和修复 OpsItem。有关更多信息，请参阅[管理 OpsItems](OpsCenter-working-with-OpsItems.md)和[修复 OpsItem 问题](OpsCenter-remediating.md)。

有关每项 AWS 服务 及其如何与 OpsCenter 集成的更多信息，请参阅以下主题。

**Topics**
+ [了解 OpsCenter 与 Amazon CloudWatch 的集成](#OpsCenter-about-cloudwatch)
+ [了解 OpsCenter 与 Amazon CloudWatch Application Insights 的集成](#OpsCenter-about-cloudwatch-insights)
+ [了解 OpsCenter 与 Amazon DevOps Guru 的集成](#OpsCenter-integrate-with-devops-guru)
+ [了解 OpsCenter 与 Amazon EventBridge 的集成](#OpsCenter-about-eventbridge)
+ [了解 OpsCenter 与 AWS Config 的集成](#OpsCenter-about-AWS-config)
+ [了解 OpsCenter 与 AWS Security Hub CSPM 的集成](#OpsCenter-integrate-with-security-hub)
+ [了解 OpsCenter 与 Incident Manager 的集成](#OpsCenter-about-incident-manager)

## 了解 OpsCenter 与 Amazon CloudWatch 的集成
<a name="OpsCenter-about-cloudwatch"></a>

Amazon CloudWatch 将监控您的 AWS 资源和服务，并显示有关您使用的每项 AWS 服务 的指标。当警报进入警报状态时，CloudWatch 将创建 OpsItem。例如，您可以配置告警，在应用程序负载均衡器生成的 HTTP 错误出现峰值时自动创建 OpsItem。

下面的列表中显示了一些警报，您可以在 CloudWatch 中配置它们以创建 OpsItems：
+ Amazon DynamoDB：数据库读取和写入操作达到阈值
+ Amazon EC2：CPU 使用率达到阈值
+ AWS 账单：预估费用达到阈值
+ Amazon EC2：实例未能通过状态检查
+ Amazon Elastic Block Store (EBS)：磁盘空间使用率达到阈值

您可以创建警报或编辑现有警报，以创建 OpsItem。有关更多信息，请参阅 [将 CloudWatch 警报配置为创建 OpsItems](OpsCenter-create-OpsItems-from-CloudWatch-Alarms.md)。

当您使用“集成设置”启用 OpsCenter 时，它会将 CloudWatch 与 OpsCenter 集成。

## 了解 OpsCenter 与 Amazon CloudWatch Application Insights 的集成
<a name="OpsCenter-about-cloudwatch-insights"></a>

使用 Amazon CloudWatch Application Insights，您可以为应用程序资源设置最合适的监视器以持续分析数据，以便找出应用程序出现问题的迹象。在 CloudWatch Application Insights 中配置应用程序资源时，可以选择让系统在 OpsCenter 中创建 OpsItems。对于在应用程序中检测到的每个问题，都会在 OpsCenter 控制台上创建一个 OpsItem。有关信息，请参阅**《Amazon CloudWatch 用户指南》中的[设置、配置和管理用于监控的应用程序](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-setting-up.html)。

**注意**  
从 2023 年 10 月 16 日起，由 CloudWatch Application Insights 创建的 OpsItems 标题和描述现在使用以下经过改进的格式：

```
OpsItem title: [<APPLICATION NAME>: <RESOURCE ID>] <PROBLEM SUMMARY>

OpsItem description:       

CloudWatch Application Insights has detected a problem in application <APPLICATION NAME>.
Problem summary: <PROBLEM SUMMARY>
Problem ID: <PROBLEM ID> (hyperlinks to the Application Insights problem summary page)
Problem Status: <PROBLEM STATUS>
Insight: <INSIGHT>
```

示例如下：

![\[屏幕截图显示了从 CloudWatch Insight 创建的 OpsItem 内容的新格式。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItem-CWinsight.png)


## 了解 OpsCenter 与 Amazon DevOps Guru 的集成
<a name="OpsCenter-integrate-with-devops-guru"></a>

Amazon DevOps Guru 应用机器学习来分析运营数据、应用程序指标以及应用程序事件，以识别偏离正常运营模式的行为。如果您让 DevOps Guru 在 OpsCenter 中生成 OpsItem，则每个洞察都会生成一个新的 OpsItem。您可以使用 OpsCenter 来管理您的 OpsItems。

DevOps Guru 自动创建 OpsItems。借助 Systems Manager 中的Quick Setup工具，您可以启用 Amazon DevOps Guru 来创建 OpsItems。系统将通过使用 [AWSServiceRoleForDevOpsGuru](https://docs.aws.amazon.com/devops-guru/latest/userguide/using-service-linked-roles.html) AWS Identity and Access Management（IAM）服务相关角色创建 OpsItems。

**将 OpsCenter 与 DevOps Guru 集成**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **Quick Setup**。

1. 在**自定义 DevOps Guru 配置选项**页面上，选择**库**选项卡。

1. 在 **DevOps Guru** 窗格中，选择**创建**。

1. 对于**配置选项**，选择**启用 AWS Systems Manager OpsItems。**

1. 完成设置后，选择**创建**。

## 了解 OpsCenter 与 Amazon EventBridge 的集成
<a name="OpsCenter-about-eventbridge"></a>

Amazon EventBridge 将提供事件流，这些事件描述了 AWS 资源中的更改。当您使用“集成设置”启用 OpsCenter 时，它会将 EventBridge 与 OpsCenter 集成，并启用默认 EventBridge 规则。根据这些规则，EventBridge 将创建 OpsItems。使用规则，您可以筛选事件并将其路由到 OpsCenter，以进行调查和修复。

**注意**  
Amazon EventBridge（前身为 Amazon CloudWatch Events）提供了 CloudWatch Events 的所有功能和一些新功能，如自定义事件总线、第三方事件源和架构注册表。

以下是您可以在 EventBridge 中配置以创建 OpsItem 的一些规则：
+ Security Hub CSPM：已发出安全警报
+ Amazon DynamoDB 节流事件
+ Amazon Elastic Compute Cloud Auto Scaling：启动实例失败 
+ Systems Manager：运行自动化失败 
+ AWS Health：计划维护提示
+ Amazon EC2：实例状态已从运行更改为停止 

根据您的要求，您可以创建规则或编辑现有规则来创建 OpsItems。有关如何编辑规则以创建 OpsItem 的说明，请参阅 [配置 EventBridge 规则以创建 OpsItems](OpsCenter-automatically-create-OpsItems-2.md)。

## 了解 OpsCenter 与 AWS Config 的集成
<a name="OpsCenter-about-AWS-config"></a>

AWS Config 可以提供关于您的 AWS 账户 中 AWS 资源的配置的详细信息。

AWS Config 不*直接*与 OpsCenter 集成。相反，您可以创建一条向 Amazon EventBridge 发送事件的 AWS Config 规则，例如当 AWS Config 检测到不合规的实例时。然后，EventBridge 根据您创建的 EventBridge 规则评估该事件。如果规则匹配，EventBridge 会将事件转换为 OpsItem，并将其作为目标传输到 OpsCenter。

使用此 OpsItem，您可以追踪不合规资源的详细信息、记录调查操作，并提供对一致修复操作的访问权限。

**相关信息**

[配置 EventBridge 规则以创建 OpsItems](OpsCenter-automatically-create-OpsItems-2.md)

[使用 AWS Systems Manager OpsCenter 和 AWS Config 进行合规性监控](https://aws.amazon.com/blogs/mt/using-aws-systems-manager-opscenter-and-aws-config-for-compliance-monitoring/)

## 了解 OpsCenter 与 AWS Security Hub CSPM 的集成
<a name="OpsCenter-integrate-with-security-hub"></a>

AWS Security Hub CSPM 从跨 AWS 账户 和服务中收集为*调查发现*的安全数据。Security Hub CSPM 使用一组规则来检测和生成调查发现，可帮助您识别所管理资源的安全问题、确定其优先级并对其进行修复。按照本主题所述，配置集成后，Systems Manager 会为 OpsCenter 中的 Security Hub CSPM 调查发现创建 OpsItems。

**注意**  
OpsCenter 与 Security Hub CSPM 进行双向集成。这意味着，如果您更新了与安全调查发现相关的 OpsItem 的**状态**或**严重性**字段，则系统会将更改与 Security Hub CSPM 同步。同样，对调查发现的任何更改都会自动在 OpsCenter 中的相应 OpsItems 中更新。  
根据 Security Hub CSPM 调查发现创建 OpsItem 时，Security Hub CSPM 元数据会自动添加到 OpsItem 的操作数据字段中。如果删除此元数据，则双向更新将不再起作用。

默认情况下，Systems Manager 会针对重大和高严重性的调查发现创建 OpsItems。您可以手动配置 OpsCenter，以便针对中等和低严重性调查发现创建 OpsItems。OpsCenter 不会为信息性调查发现创建 OpsItems，因为这种结果无需修复。有关 Security Hub CSPM 严重性级别的更多信息，请参阅《AWS Security Hub API Reference》**中的 [Severity](https://docs.aws.amazon.com//securityhub/1.0/APIReference/API_Severity.html)。

**开始前的准备工作**  
在配置 OpsCenter 以便基于 Security Hub CSPM 调查发现创建 OpsItems 之前，请确认您已完成 Security Hub CSPM 的设置任务。有关更多信息，请参阅《AWS Security Hub 用户指南》**中的[设置 Security Hub CSPM](https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-settingup.html)。

当您将 Security Hub CSPM 与 OpsCenter 集成时，系统将使用 `AWSServiceRoleForSystemsManagerOpsDataSync` IAM 服务相关角色创建 OpsItems。有关该角色的更多信息，请参阅[使用角色为 Explorer 创建 OpsData 和 OpsItems](using-service-linked-roles-service-action-3.md)。

**警告**  
请注意以下有关与 Security Hub CSPM 进行 OpsCenter 集成的定价的重要信息：  
如果您在配置 OpsCenter 和 Security Hub CSPM 集成时登录到 Security Hub CSPM 管理员账户，则系统会针对在管理员*和*所有成员账户中的调查发现创建 OpsItems。OpsItems 均*在管理员账户中*创建。根据各种因素，这可能会导致来自 AWS 的意外巨额账单。  
如果您在配置集成时登录到成员账户，则系统仅针对该个人账户中的调查发现创建 OpsItems。有关 Security Hub CSPM 管理员账户、成员账户及其与 EventBridge 调查发现事件源关系的更多信息，请参阅《AWS Security Hub User Guide》**中的 [Types of Security Hub CSPM integration with EventBridge](https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-cwe-integration-types.html)。
对于创建 OpsItem 的每个调查发现，都将按常规价格向您收取创建 OpsItem 的费用。如果您编辑了 OpsItem 或在 Security Hub CSPM 中更新了相应的调查发现（这会触发 OpsItem 更新），则也会产生费用。
 通过与 AWS Security Hub CSPM 集成创建的 OpsItems 暂*不受*每个区域每个账户 50 万个 OpsItems 的最大配额限制。因此，Security Hub CSPM 警报可以在账户的每个区域中创建超过 50 万个可收费 OpsItems。  
因此，对于高负载生产环境，建议将 Security Hub CSPM 调查发现范围限定为仅高严重性问题。

**配置 OpsCenter 以便为 Security Hub CSPM 调查发现创建 OpsItems**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择**设置**。

1. 在 **Security Hub CSPM 调查发现**部分，选择**编辑**。

1. 选择滑块将**已禁用**更改为**已启用**。

1. 如果您希望系统针对中等或低严重性调查发现创建 OpsItems，请切换这些选项。

1. 选择 **Save (保存)** 以保存您的配置。

如果您不再希望系统为 Security Hub CSPM 调查发现创建 OpsItems，请使用以下步骤。

**停止接收 Security Hub CSPM 调查发现的 OpsItems**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择**设置**。

1. 在 **Security Hub CSPM 调查发现**部分，选择**编辑**。

1. 选择滑块将**已启用**更改为**已禁用**。如果无法切换滑块，则说明您的 AWS 账户 尚未启用 Security Hub CSPM。

1. 选择**保存**保存您的配置。OpsCenter 不再根据 Security Hub CSPM 调查发现创建 OpsItems。

**重要**  
Systems Manager 委派的管理员或 AWS Organizations 管理账户可以通过在 Explorer 中创建资源数据同步，从而在 OpsCenter 中为多个账户和 AWS 区域 启用 Security Hub CSPM 调查发现。如果在 Explorer 中启用了 **Security Hub CSPM** 源，并且存在以成员账户（禁用了 Security Hub CSPM 集成）为目标的资源数据同步，则以管理员选择的设置优先。OpsCenter 继续为 Security Hub CSPM 调查发现创建 OpsItems。要停止在被资源数据同步视作目标的成员账户中为 Security Hub CSPM 调查发现创建 OpsItems，请联系管理员移除您在资源数据同步中的账户，或者在 Explorer 中关闭 **Security Hub CSPM** 源。有关在 Explorer 中更改设置的信息，请参阅 [编辑 Systems Manager Explorer 数据源](Explorer-using-editing-data-sources.md)。

## 了解 OpsCenter 与 Incident Manager 的集成
<a name="OpsCenter-about-incident-manager"></a>

Incident Manager（AWS Systems Manager 中的一项工具）提供了一个事件管理控制台，可帮助缓解影响您 AWS 托管应用程序的事件并从中恢复。*事件*是指任何计划外的服务中断或质量下降。在设置并配置 [Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/what-is-incident-manager.html) 后，系统将在 OpsCenter 中自动创建 OpsItems。

当系统在 Incident Manager 中创建事件时，它还会在 OpsCenter 中创建一个 OpsItem，并将该事件显示为相关项目。如果 OpsItem 已经存在，则 Incident Manager 不会创建 OpsItem。第一个 OpsItem 称为父 OpsItem。如果某一事件的规模和范围扩大，则您可以向现有 OpsItem 中添加多个事件。如果需要，您可以为 OpsItem 手动创建事件。在事件关闭后，您可以在 Incident Manager 中创建分析，以便查看和改进相似问题的修复过程。

默认情况下，OpsCenter 将与 Incident Manager 集成。如果未设置 Incident Manager，则 OpsCenter 页面将显示一条消息，以设置 Incident Manager。当 Incident Manager 创建 OpsItem 时，您可以从 OpsCenter 管理和修复 OpsItem。有关为 OpsItem 创建事件的说明，请参阅 [为 OpsItem 创建事件](OpsCenter-working-with-OpsItems-create-an-incident.md)。

# 创建 OpsItems
<a name="OpsCenter-create-OpsItems"></a>

在设置好 OpsCenter（AWS Systems Manager 中的一项工具）并将其与 AWS 服务集成后，AWS 服务会根据默认规则、事件或警报自动创建 OpsItems。

您可以查看默认 Amazon EventBridge 规则的状态和严重性级别。如果需要，您可以从 Amazon EventBridge 创建或编辑这些规则。您还可以从 Amazon CloudWatch 查看警报，以及创建或编辑警报。使用规则和警报，您可以配置要为其自动生成 OpsItems 的事件。

当系统创建 OpsItem 时，它将处于**打开**状态。当您开始 OpsItem 的调查时，可将状态更改为**正在进行**；在修复 OpsItem 后，可将状态更改为**已解决**。关于如何在 AWS 服务 中配置警报和规则以创建 OpsItems，以及如何手动创建 OpsItem 的更多信息，请参阅以下主题。

**Topics**
+ [配置 EventBridge 规则以创建 OpsItems](OpsCenter-automatically-create-OpsItems-2.md)
+ [将 CloudWatch 警报配置为创建 OpsItems](OpsCenter-create-OpsItems-from-CloudWatch-Alarms.md)
+ [手动创建 OpsItems](OpsCenter-manually-create-OpsItems.md)

# 配置 EventBridge 规则以创建 OpsItems
<a name="OpsCenter-automatically-create-OpsItems-2"></a>

当 Amazon EventBridge 收到事件时，它将根据默认规则创建新的 OpsItem。您可以创建规则或编辑现有规则，以将 OpsCenter 设置为 EventBridge 事件的目标。有关如何创建事件规则的信息，请参阅**《Amazon EventBridge 用户指南》中的[为 AWS 服务 创建规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html)。

**配置 EventBridge 规则以在 OpsCenter 中创建 OpsItems**

1. 打开位于 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 的 Amazon EventBridge 控制台。

1. 在导航窗格中，选择**规则**。

1. 在 **Rule**（规则）页面上，对于 **Event bus**（事件总线），选择 **default**（默认）。

1. 对于**规则**，通过选中规则名称旁边的复选框来选择规则。

1. 选择规则的名称以打开其详细信息页面。在**规则详细信息**中，验证是否已将**状态**设置为**已启用**。
**注意**  
如果需要，您可以使用该页面右上角的**编辑**来更新状态。

1. 选择**目标**选项卡。

1. 在 **Targets (目标)** 选项卡上，选择 **Edit (编辑)**。

1. 对于**目标类型**，选择 **AWS 服务**。

1. 对于 **Select a target**（选择一个目标），选择 **Systems Manager OpsItem**。

1. 对于许多目标类型，EventBridge 需要权限以便将事件发送到目标。在这些情况下，EventBridge 可以创建运行规则所需的 AWS Identity and Access Management (IAM) 角色：
   + 若要自动创建 IAM 角色，请选择 **Create a new role for this specific resource (为此特定资源创建新角色)**。
   + 要使用您创建的 IAM 角色向 Eventbridge 授予在 OpsCenter 中创建 OpsItems 的权限，请选择**Use existing role**（使用现有角色）。

1. 在**其他设置**中，对于**配置目标输入**，请选择**输入转换器**。

   您可以使用**输入转换器**选项为 OpsItems 指定重复数据删除字符串和其他重要信息，如标题和严重性。

1. 选择 **Configure input transformer**（配置输入转换器）。

1. 在**目标输入转换器**中，对于**输入路径**，请指定要从触发事件中解析的值。例如，要从触发该规则的事件中解析开始时间、结束时间和其他详细信息，请使用下面的 JSON。

   ```
   {
       "end-time": "$.detail.EndTime",
       "failure-cause": "$.detail.cause",
       "resources": "$.resources[0]",
       "source": "$.detail.source",
       "start-time": "$.detail.StartTime"
   }
   ```

1. 对于 **Template**（模板），请指定要发送到目标的信息。例如，使用下面的 JSON 将信息传递到 OpsCenter。此信息将用于创建 OpsItem。
**注意**  
如果输入模板采用 JSON 格式，则模板中的对象值不能包含引号。例如，资源、故障原因、来源、开始时间和结束时间的值不能以引号表示。

   ```
   {
       "title": "EBS snapshot copy failed",
       "description": "CloudWatch Event Rule SSMOpsItems-EBS-snapshot-copy-failed was triggered. Your EBS snapshot copy has failed. See below for more details.",
       "category": "Availability",
       "severity": "2",
       "source": "EC2",
       "operationalData": {
           "/aws/dedup": {
               "type": "SearchableString",
               "value": "{\"dedupString\":\"SSMOpsItems-EBS-snapshot-copy-failed\"}"
           },
           "/aws/automations": {
               "value": "[ { \"automationType\": \"AWS:SSM:Automation\", \"automationId\": \"AWS-CopySnapshot\" } ]"
           },
           "failure-cause": {
               "value": <failure-cause>
           },
           "source": {
               "value": <source>
           },
           "start-time": {
               "value": <start-time>
           },
           "end-time": {
               "value": <end-time>
           },
            },
           "resources": {
               "value": <resources>
           }
       }
   }
   ```

   有关这些字段的更多信息，请参阅*《Amazon EventBridge 用户指南》*中的[转换目标输入](https://docs.aws.amazon.com/eventbridge/latest/userguide/transform-input.html)。

1. 选择**确认**。

1. 选择**下一步**。

1. 选择**下一步**。

1. 选择**更新规则**。

在从事件创建 OpsItem 后，您可以通过打开 OpsItem 并向下滚动到**私有操作数据**部分来查看事件详细信息。有关如何配置 OpsItem 中的选项的信息，请参阅 [管理 OpsItems](OpsCenter-working-with-OpsItems.md)。

# 将 CloudWatch 警报配置为创建 OpsItems
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms"></a>

在 OpsCenter（AWS Systems Manager 中的一项工具）的集成设置中，您可以启用 Amazon CloudWatch，根据常见警报自动创建 OpsItems。您可以创建警报或编辑现有警报，以在 OpsCenter 中创建 OpsItems。

当您将警报配置为创建 OpsItems 时，CloudWatch 将在 AWS Identity and Access Management（IAM）中创建新的服务相关角色。该新角色名为 `AWSServiceRoleForCloudWatchAlarms_ActionSSM`。有关 CloudWatch 服务相关角色的更多信息，请参阅**《Amazon CloudWatch 用户指南》中的[为 CloudWatch 使用服务相关角色](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-service-linked-roles.html)。

当 CloudWatch 警报生成 OpsItem 时，OpsItem 将显示 **CloudWatch 警报 -“*alarm\$1name*”处于警报状态**。

要查看有关特定 OpsItem 的详细信息，请选择 OpsItem，然后选择**相关资源详细信息** 选项卡。您可以手动编辑 OpsItems，以更改诸如严重性或类别等详细信息。但是，当您编辑警报的严重性或类别时，Systems Manager 将无法更新已通过警报创建的 OpsItems 的严重性或类别。如果某个告警创建了 OpsItem，并且您指定了重复数据删除字符串，则即使您在 CloudWatch 中编辑此告警，它也不会创建额外的 OpsItems。如果已在 OpsCenter 中解决了 OpsItem 的问题，CloudWatch 将创建一个新的 OpsItem。

有关配置 CloudWatch 警报的更多信息，请参阅以下主题。

**Topics**
+ [配置 CloudWatch 警报以创建 OpsItems（控制台）](OpsCenter-creating-or-editing-existing-alarm-console.md)
+ [将现有 CloudWatch 警报配置为创建 OpsItems（以编程方式）](OpsCenter-configuring-an-existing-alarm-programmatically.md)

# 配置 CloudWatch 警报以创建 OpsItems（控制台）
<a name="OpsCenter-creating-or-editing-existing-alarm-console"></a>

您可以手动创建警报或更新现有警报，以从 Amazon CloudWatch 创建 OpsItems。

**创建 CloudWatch 警报并将 Systems Manager 配置为该警报的目标**

1. 完成**《Amazon CloudWatch 用户指南》中[根据静态阈值创建 CloudWatch 警报](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html)中指定的步骤 1-9。

1. 在 **Systems Manager 操作**部分中，选择**添加 Systems Manager OpsCenter 操作**。

1. 选择 **OpsItems**。

1. 对于**严重性**，请在 1 到 4 之间进行选择。

1. （可选）对于**类别**，为 OpsItem 选择一个类别。

1. 完成**《Amazon CloudWatch 用户指南》中[根据静态阈值创建 CloudWatch 警报](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html)中指定的步骤 11-13。

1. 选择 **Next (下一步)** 并完成向导。

**要编辑现有告警，并将 Systems Manager 配置为此告警的目标，请执行以下步骤：**

1. 通过 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 打开 CloudWatch 控制台。

1. 在导航窗格中，选择**警报**。

1. 选择告警，然后依次选择 **Actions (操作)** 和 **Edit (编辑)**。

1. （可选）更改 **Metrics (指标)** 和 **Conditions (条件)** 部分中的设置，然后选择 **Next (下一步)**。

1. 在 **Systems Manager** 部分，选择 **Add Systems Manager OpsCenter 操作**。

1. 对于 **Severity (严重性)**，选择一个数字。
**注意**  
严重性是用户定义的值。您或您的组织可以确定每个严重性级别的值的含义以及与每个严重性级别相关联的任何服务等级协议。

1. （可选）对于 **Category (类别)**，选择一个选项。

1. 选择 **Next (下一步)** 并完成向导。

# 将现有 CloudWatch 警报配置为创建 OpsItems（以编程方式）
<a name="OpsCenter-configuring-an-existing-alarm-programmatically"></a>

您可以将 Amazon CloudWatch 警报配置为使用 AWS Command Line Interface（AWS CLI）、AWS CloudFormation 模板或 Java 代码段以编程方式创建 OpsItems。

**Topics**
+ [开始前的准备工作](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)
+ [将 CloudWatch 警报配置为创建 OpsItems（AWS CLI）](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli)
+ [将 CloudWatch 警报配置为创建或更新 OpsItems（CloudFormation）](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation)
+ [将 CloudWatch 警报配置为创建或更新 OpsItems（Java）](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java)

## 开始前的准备工作
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin"></a>

如果您以编程方式编辑现有警报或创建用于创建 OpsItems 的警报，则必须指定 Amazon 资源名称（ARN）。此 ARN 将 Systems Manager OpsCenter 标识为通过告警创建的 OpsItems 目标。您可以自定义 ARN，使通过告警创建的 OpsItems 包含特定信息，如严重性或类别。每个 ARN 包含下表中描述的信息。


****  

| 参数 | Details | 
| --- | --- | 
|  `Region`（必填）  |  告警所在的 AWS 区域。例如：`us-west-2`。有关如何在 AWS 区域 中使用OpsCenter 的更多信息，请参阅 [AWS Systems Manager 端点和配额](https://docs.aws.amazon.com/general/latest/gr/ssm.html)。  | 
|  `account_ID`（必填）  |  创建告警时使用的同一 AWS 账户 ID。例如：`123456789012`。账户 ID 必须后跟冒号（`:`）和参数 `opsitem`，如以下示例所示。  | 
|  `severity`（必填）  |  由用户定义的通过告警创建的 OpsItems 的严重性级别。有效值：`1`、`2`、`3`、`4`  | 
|  `Category`（可选）  |  通过告警创建的 OpsItems 的类别。有效值：`Availability`、`Cost`、`Performance`、`Recovery` 和 `Security`。  | 

使用以下句法创建 ARN。此 ARN 不包括可选的 `Category` 参数。

```
arn:aws:ssm:Region:account_ID:opsitem:severity
```

以下为示例。

```
arn:aws:ssm:us-west-2:123456789012:opsitem:3
```

要创建使用可选的 `Category` 参数的 ARN，请使用以下句法：

```
arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name
```

以下为示例。

```
arn:aws:ssm:us-west-2:123456789012:opsitem:3#CATEGORY=Security
```

## 将 CloudWatch 警报配置为创建 OpsItems（AWS CLI）
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli"></a>

此命令要求您为 `alarm-actions` 参数指定 ARN。有关如何创建 ARN 的信息，请参阅 [开始前的准备工作](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)。

**将 CloudWatch 警报配置为创建 OpsItems（AWS CLI）**

1. 安装并配置 AWS Command Line Interface（AWS CLI）（如果尚未执行该操作）。

   有关信息，请参阅[安装或更新 AWS CLI 的最新版本](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。

1. 运行以下命令以收集要配置的告警的信息。

   ```
   aws cloudwatch describe-alarms --alarm-names "alarm name"
   ```

1. 运行以下命令以更新告警。将每个*示例资源占位符*替换为您自己的信息。

   ```
   aws cloudwatch put-metric-alarm --alarm-name name \
   --alarm-description "description" \
   --metric-name name --namespace namespace \
   --statistic statistic --period value --threshold value \
   --comparison-operator value \
   --dimensions "dimensions" --evaluation-periods value \
       --alarm-actions arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name \
   --unit unit
   ```

   以下为示例。

------
#### [ Linux & macOS ]

   ```
   aws cloudwatch put-metric-alarm --alarm-name cpu-mon \
   --alarm-description "Alarm when CPU exceeds 70 percent" \
   --metric-name CPUUtilization --namespace AWS/EC2 \
   --statistic Average --period 300 --threshold 70 \
   --comparison-operator GreaterThanThreshold \
   --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 \
   --alarm-actions arn:aws:ssm:us-east-1:123456789012:opsitem:3#CATEGORY=Security \
   --unit Percent
   ```

------
#### [ Windows ]

   ```
   aws cloudwatch put-metric-alarm --alarm-name cpu-mon ^
   --alarm-description "Alarm when CPU exceeds 70 percent" ^
   --metric-name CPUUtilization --namespace AWS/EC2 ^
   --statistic Average --period 300 --threshold 70 ^
   --comparison-operator GreaterThanThreshold ^
   --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 ^
   --alarm-actions arn:aws:ssm:us-east-1:123456789012:opsitem:3#CATEGORY=Security ^
   --unit Percent
   ```

------

## 将 CloudWatch 警报配置为创建或更新 OpsItems（CloudFormation）
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation"></a>

本部分包括多个 AWS CloudFormation 模板，您可以使用这些模板将 CloudWatch 警报配置为自动创建或更新 OpsItems。每个模板均要求您为 `AlarmActions` 参数指定 ARN。有关如何创建 ARN 的信息，请参阅 [开始前的准备工作](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)。

**指标警报** - 使用以下 CloudFormation 模板创建或更新 CloudWatch 指标警报。此模板中指定的警报用于监控 Amazon Elastic Compute Cloud（Amazon EC2）实例状态检查。如果告警进入 `ALARM` 状态，则在 OpsCenter 中创建 OpsItem。

```
    {
      "AWSTemplateFormatVersion": "2010-09-09",
      "Parameters" : {
        "RecoveryInstance" : {
          "Description" : "The EC2 instance ID to associate this alarm with.",
          "Type" : "AWS::EC2::Instance::Id"
        }
      },
      "Resources": {
        "RecoveryTestAlarm": {
          "Type": "AWS::CloudWatch::Alarm",
          "Properties": {
            "AlarmDescription": "Run a recovery action when instance status check fails for 15 consecutive minutes.",
            "Namespace": "AWS/EC2" ,
            "MetricName": "StatusCheckFailed_System",
            "Statistic": "Minimum",
            "Period": "60",
            "EvaluationPeriods": "15",
            "ComparisonOperator": "GreaterThanThreshold",
            "Threshold": "0",
            "AlarmActions": [ {"Fn::Join" : ["", ["arn:arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name", { "Ref" : "AWS::Partition" }, ":ssm:", { "Ref" : "AWS::Region" }, { "Ref" : "AWS:: AccountId" }, ":opsitem:3" ]]} ],
            "Dimensions": [{"Name": "InstanceId","Value": {"Ref": "RecoveryInstance"}}]
          }
        }
      }
    }
```

**复合警报** - 使用以下 CloudFormation 模板创建或更新复合警报。复合告警由多个指标告警组成。如果告警进入 `ALARM` 状态，则在 OpsCenter 中创建 OpsItem。

```
"Resources":{
       "HighResourceUsage":{
          "Type":"AWS::CloudWatch::CompositeAlarm",
          "Properties":{
             "AlarmName":"HighResourceUsage",
             "AlarmRule":"(ALARM(HighCPUUsage) OR ALARM(HighMemoryUsage)) AND NOT ALARM(DeploymentInProgress)",
             "AlarmActions":"arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name",
             "AlarmDescription":"Indicates that the system resource usage is high while no known deployment is in progress"
          },
          "DependsOn":[
             "DeploymentInProgress",
             "HighCPUUsage",
             "HighMemoryUsage"
          ]
       },
       "DeploymentInProgress":{
          "Type":"AWS::CloudWatch::CompositeAlarm",
          "Properties":{
             "AlarmName":"DeploymentInProgress",
             "AlarmRule":"FALSE",
             "AlarmDescription":"Manually updated to TRUE/FALSE to disable other alarms"
          }
       },
       "HighCPUUsage":{
          "Type":"AWS::CloudWatch::Alarm",
          "Properties":{
             "AlarmDescription":"CPUusageishigh",
             "AlarmName":"HighCPUUsage",
             "ComparisonOperator":"GreaterThanThreshold",
             "EvaluationPeriods":1,
             "MetricName":"CPUUsage",
             "Namespace":"CustomNamespace",
             "Period":60,
             "Statistic":"Average",
             "Threshold":70,
             "TreatMissingData":"notBreaching"
          }
       },
       "HighMemoryUsage":{
          "Type":"AWS::CloudWatch::Alarm",
          "Properties":{
             "AlarmDescription":"Memoryusageishigh",
             "AlarmName":"HighMemoryUsage",
             "ComparisonOperator":"GreaterThanThreshold",
             "EvaluationPeriods":1,
             "MetricName":"MemoryUsage",
             "Namespace":"CustomNamespace",
             "Period":60,
             "Statistic":"Average",
             "Threshold":65,
             "TreatMissingData":"breaching"
          }
       }
    }
```

## 将 CloudWatch 警报配置为创建或更新 OpsItems（Java）
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java"></a>

本部分包括多个 Java 代码段，您可以使用这些代码段将 CloudWatch 警报配置为自动创建或更新 OpsItems。每个代码段均要求您为 `validSsmActionStr` 参数指定 ARN。有关如何创建 ARN 的信息，请参阅 [开始前的准备工作](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)。

**特定警报** - 使用以下 Java 代码段创建或更新 CloudWatch 警报。此模板中指定的告警用于监控 Amazon EC2 实例状态检查。如果告警进入 `ALARM` 状态，则在 OpsCenter 中创建 OpsItem。

```
import com.amazonaws.services.cloudwatch.AmazonCloudWatch;
    import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder;
    import com.amazonaws.services.cloudwatch.model.ComparisonOperator;
    import com.amazonaws.services.cloudwatch.model.Dimension;
    import com.amazonaws.services.cloudwatch.model.PutMetricAlarmRequest;
    import com.amazonaws.services.cloudwatch.model.PutMetricAlarmResult;
    import com.amazonaws.services.cloudwatch.model.StandardUnit;
    import com.amazonaws.services.cloudwatch.model.Statistic;
     
    private void putMetricAlarmWithSsmAction() {
        final AmazonCloudWatch cw =
                AmazonCloudWatchClientBuilder.defaultClient();
     
        Dimension dimension = new Dimension()
                .withName("InstanceId")
                .withValue(instanceId);
     
        String validSsmActionStr = "arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name";
     
        PutMetricAlarmRequest request = new PutMetricAlarmRequest()
                .withAlarmName(alarmName)
                .withComparisonOperator(
                        ComparisonOperator.GreaterThanThreshold)
                .withEvaluationPeriods(1)
                .withMetricName("CPUUtilization")
                .withNamespace("AWS/EC2")
                .withPeriod(60)
                .withStatistic(Statistic.Average)
                .withThreshold(70.0)
                .withActionsEnabled(false)
                .withAlarmDescription(
                        "Alarm when server CPU utilization exceeds 70%")
                .withUnit(StandardUnit.Seconds)
                .withDimensions(dimension)
                .withAlarmActions(validSsmActionStr);
     
        PutMetricAlarmResult response = cw.putMetricAlarm(request);
    }
```

**更新所有警报** - 使用以下 Java 代码段更新您的 AWS 账户 中的所有 CloudWatch 警报，以便在警报进入 `ALARM` 状态时创建 OpsItems。

```
import com.amazonaws.services.cloudwatch.AmazonCloudWatch;
    import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder;
    import com.amazonaws.services.cloudwatch.model.DescribeAlarmsRequest;
    import com.amazonaws.services.cloudwatch.model.DescribeAlarmsResult;
    import com.amazonaws.services.cloudwatch.model.MetricAlarm;
     
    private void listMetricAlarmsAndAddSsmAction() {
        final AmazonCloudWatch cw = AmazonCloudWatchClientBuilder.defaultClient();
     
        boolean done = false;
        DescribeAlarmsRequest request = new DescribeAlarmsRequest();
     
        String validSsmActionStr = "arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name";
     
        while(!done) {
     
            DescribeAlarmsResult response = cw.describeAlarms(request);
     
            for(MetricAlarm alarm : response.getMetricAlarms()) {
                // assuming there are no alarm actions added for the metric alarm
                alarm.setAlarmActions(ImmutableList.of(validSsmActionStr));
            }
     
            request.setNextToken(response.getNextToken());
     
            if(response.getNextToken() == null) {
                done = true;
            }
        }
    }
```

# 手动创建 OpsItems
<a name="OpsCenter-manually-create-OpsItems"></a>

当您发现操作问题时，可以通过 OpsCenter（AWS Systems Manager 中的一项工具）手动创建 OpsItem 来管理和解决该问题。

如果您为跨账户管理设置了 OpsCenter，则 Systems Manager 委托管理员或 AWS Organizations 管理账户可以为成员账户创建 OpsItems。有关更多信息，请参阅 [（可选）将 OpsCenter 手动设置为跨账户集中管理 OpsItems](OpsCenter-getting-started-multiple-accounts.md)。

您可以使用 AWS Systems Manager 控制台、AWS Command Line Interface（AWS CLI）或 AWS Tools for Windows PowerShell 创建 OpsItems。

**Topics**
+ [手动创建 OpsItems（控制台）](OpsCenter-creating-OpsItems-console.md)
+ [手动创建 OpsItems（AWS CLI）](OpsCenter-creating-OpsItems-CLI.md)
+ [手动创建 OpsItems（PowerShell）](OpsCenter-creating-OpsItems-Powershell.md)

# 手动创建 OpsItems（控制台）
<a name="OpsCenter-creating-OpsItems-console"></a>

 您可以使用 AWS Systems Manager 控制台手动创建 OpsItems。当您创建 OpsItem 时，它将显示在您的 OpsCenter 账户中。如果您为跨账户管理设置了 OpsCenter，则 OpsCenter 将为委托管理员或管理账户提供为选定成员账户创建 OpsItems 的选项。有关更多信息，请参阅 [（可选）将 OpsCenter 手动设置为跨账户集中管理 OpsItems](OpsCenter-getting-started-multiple-accounts.md)。

**使用 AWS Systems Manager 控制台创建 OpsItem**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择 **Create (创建) OpsItem**。如果您没有看到该按钮，请选择 **OpsItems** 选项卡，然后选择 **Create OpsItem (创建 OpsItem)**。

1.  （可选）选择**其他账户**，然后选择要在其中创建 OpsItem 的账户。
**注意**  
如果您要为成员账户创建 OpsItems，则需要执行此步骤。

1. 对于 **Title (标题)**，输入一个描述性名称以帮助您了解 OpsItem 的用途。

1. 对于 **Source (源)**，请输入受影响的 AWS 资源的类型或其他源信息，以帮助用户了解 OpsItem 的源。
**注意**  
创建 OpsItem 后，您无法编辑 **Source (源)** 字段。

1. （可选）对于 **Priority (优先级)**，选择优先级级别。

1. （可选）对于 **Severity (严重性)**，选择严重性级别。

1. （可选）对于 **Category (类别)**，选择一个类别。

1. 对于 **Description (描述)**，输入有关此 OpsItem 的信息，包括（如果适用）再现此问题的步骤。
**注意**  
控制台支持 OpsiteM 描述字段中的大多数 Markdown 格式。有关更多信息，请参阅《AWS 管理控制台 入门指南》**中的[在控制台中使用 Markdown](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html)。

1. 对于**重复数据删除字符串**，输入系统可以用于检查重复 OpsItems 的单词。有关重复数据删除字符串的更多信息，请参阅 [管理重复的 OpsItems](OpsCenter-working-deduplication.md)。

1. （可选）对于**通知**，指定在更新此 OpsItem 时要将通知发送到的 Amazon SNS 主题的 Amazon 资源名称（ARN）。您必须指定一个与 OpsItem 位于同一 AWS 区域 中的 Amazon SNS ARN。

1. （可选）对于**相关资源**，选择**添加**以指定受影响资源和任何相关资源的 ID 或 ARN。

1. 选择**创建OpsItem**。

如果成功，该页面将显示 OpsItem。当委托管理员或管理账户为选定成员账户创建 OpsItem 时，新的 OpsItems 将显示在管理员和成员账户的 OpsCenter 中。有关如何配置 OpsItem 中的选项的信息，请参阅 [管理 OpsItems](OpsCenter-working-with-OpsItems.md)。

# 手动创建 OpsItems（AWS CLI）
<a name="OpsCenter-creating-OpsItems-CLI"></a>

以下过程介绍了使用 AWS Command Line Interface (AWS CLI) 创建 OpsItem 的方法。

**使用 AWS CLI 创建 OpsItem**

1. 安装并配置 AWS Command Line Interface（AWS CLI）（如果尚未执行该操作）。

   有关信息，请参阅[安装或更新 AWS CLI 的最新版本](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。

1. 打开 AWS CLI 并运行以下命令以创建 OpsItem。将每个*示例资源占位符*替换为您自己的信息。

   ```
   aws ssm create-ops-item \
       --title "Descriptive_title" \
       --description "Information_about_the_issue" \
       --priority Number_between_1_and_5 \
       --source Source_of_the_issue \
       --operational-data Up_to_20_KB_of_data_or_path_to_JSON_file \
       --notifications Arn="SNS_ARN_in_same_Region" \
       --tags "Key=key_name,Value=a_value"
   ```

   **指定文件中的操作数据**

   在创建 OpsItem 时，您可以指定文件中的操作数据。该文件必须是 JSON 文件，并且该文件的内容必须使用以下格式。

   ```
   {
     "key_name": {
       "Type": "SearchableString",
       "Value": "Up to 20 KB of data"
     }
   }
   ```

   见下列。

   ```
   aws ssm create-ops-item ^
       --title "EC2 instance disk full" ^
       --description "Log clean up may have failed which caused the disk to be full" ^
       --priority 2 ^
       --source ec2 ^
       --operational-data file:///Users/TestUser1/Desktop/OpsItems/opsData.json ^
       --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^
       --tags "Key=EC2,Value=Production"
   ```
**注意**  
有关如何在不同本地操作系统的命令行中输入 JSON 格式参数的信息，请参阅 *AWS Command Line Interface 用户指南*中的[在 AWS CLI 中将引号和字符串结合使用](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html)。

   系统将返回类似于以下内容的信息。

   ```
   {
       "OpsItemId": "oi-1a2b3c4d5e6f"
   }
   ```

1. 运行以下命令以查看有关您创建的 OpsItem 的详细信息。

   ```
   aws ssm get-ops-item --ops-item-id ID
   ```

   系统将返回类似于以下内容的信息。

   ```
   {
       "OpsItem": {
           "CreatedBy": "arn:aws:iam::12345678:user/TestUser",
           "CreatedTime": 1558386334.995,
           "Description": "Log clean up may have failed which caused the disk to be full",
           "LastModifiedBy": "arn:aws:iam::12345678:user/TestUser",
           "LastModifiedTime": 1558386334.995,
           "Notifications": [
               {
                   "Arn": "arn:aws:sns:us-west-1:12345678:TestUser"
               }
           ],
           "Priority": 2,
           "RelatedOpsItems": [],
           "Status": "Open",
           "OpsItemId": "oi-1a2b3c4d5e6f",
           "Title": "EC2 instance disk full",
           "Source": "ec2",
           "OperationalData": {
               "EC2": {
                   "Value": "12345",
                   "Type": "SearchableString"
               }
           }
       }
   }
   ```

1. 运行以下命令以更新 OpsItem。此命令将状态从 `Open`（默认值）更改为 `InProgress`。

   ```
   aws ssm update-ops-item --ops-item-id ID --status InProgress
   ```

   该命令没有输出。

1. 再次运行以下命令以验证状态是否已更改为 `InProgress`。

   ```
   aws ssm get-ops-item --ops-item-id ID
   ```

## 创建 OpsItem 的示例
<a name="OpsCenter_creating_OpsItems-CLI_examples"></a>

以下代码示例向您演示如何使用 Linux 管理门户、macOS 或 Windows Server 创建 OpsItem。

**Linux 管理门户或 macOS**

以下命令将在 Amazon Elastic Compute Cloud（Amazon EC2）实例磁盘已满时创建 OpsItem。

```
aws ssm create-ops-item \
    --title "EC2 instance disk full" \
    --description "Log clean up may have failed which caused the disk to be full" \
    --priority 2 \
    --source ec2 \
    --operational-data '{"EC2":{"Value":"12345","Type":"SearchableString"}}' \
    --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" \
    --tags "Key=EC2,Value=ProductionServers"
```

以下命令将使用 `OperationalData` 中的 `/aws/resources` 键创建包含 Amazon DynamoDB 相关资源的 OpsItem。

```
aws ssm create-ops-item \
    --title "EC2 instance disk full" \
    --description "Log clean up may have failed which caused the disk to be full" \
    --priority 2 \
    --source ec2 \
    --operational-data '{"/aws/resources":{"Value":"[{\"arn\": \"arn:aws:dynamodb:us-west-2:12345678:table/OpsItems\"}]","Type":"SearchableString"}}' \
    --notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"
```

以下命令将使用 `OperationalData` 中的 `/aws/automations` 键创建将 `AWS-ASGEnterStandby` 文档指定为相关联的自动化运行手册的 OpsItem。

```
aws ssm create-ops-item \
    --title "EC2 instance disk full" \
    --description "Log clean up may have failed which caused the disk to be full" \
    --priority 2 \
    --source ec2 \
    --operational-data '{"/aws/automations":{"Value":"[{\"automationId\": \"AWS-ASGEnterStandby\", \"automationType\": \"AWS::SSM::Automation\"}]","Type":"SearchableString"}}' \
    --notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"
```

**Windows**

以下命令将在 Amazon Relational Database Service（Amazon RDS）实例不响应时创建 OpsItem。

```
aws ssm create-ops-item ^
    --title "RDS instance not responding" ^
    --description "RDS instance not responding to ping" ^
    --priority 1 ^
    --source RDS ^
    --operational-data={\"RDS\":{\"Value\":\"abcd\",\"Type\":\"SearchableString\"}} ^
    --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^
    --tags "Key=RDS,Value=ProductionServers"
```

以下命令将使用 `OperationalData` 中的 `/aws/resources` 键创建包含 Amazon EC2 实例相关资源的 OpsItem。

```
aws ssm create-ops-item ^
    --title "EC2 instance disk full" ^
    --description "Log clean up may have failed which caused the disk to be full" ^
    --priority 2 ^
    --source ec2 ^
    --operational-data={\"/aws/resources\":{\"Value\":\"[{\\"""arn\\""":\\"""arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\\"""}]\",\"Type\":\"SearchableString\"}}
```

以下命令将使用 `OperationalData` 中的 `/aws/automations` 键创建将 `AWS-RestartEC2Instance` 运行手册指定为相关联的自动化运行手册的 OpsItem。

```
aws ssm create-ops-item ^
    --title "EC2 instance disk full" ^
    --description "Log clean up may have failed which caused the disk to be full" ^
    --priority 2 ^
    --source ec2 ^
    --operational-data={\"/aws/automations\":{\"Value\":\"[{\\"""automationId\\""":\\"""AWS-RestartEC2Instance\\”"",\\"""automationType\\""":\\"""AWS::SSM::Automation\\"""}]\",\"Type\":\"SearchableString\"}}
```

# 手动创建 OpsItems（PowerShell）
<a name="OpsCenter-creating-OpsItems-Powershell"></a>

以下过程介绍了如何使用 AWS Tools for Windows PowerShell 创建 OpsItem。

**使用 AWS Tools for Windows PowerShell 创建 OpsItem**

1. 打开 AWS Tools for Windows PowerShell，然后运行以下命令，以指定您的凭证。

   ```
   Set-AWSCredentials –AccessKey key-name –SecretKey key-name
   ```

1. 运行以下命令，以便为 PowerShell 会话设置 AWS 区域。

   ```
   Set-DefaultAWSRegion -Region Region
   ```

1. 运行以下命令以创建新的 OpsItem。将每个*示例资源占位符*替换为您自己的信息。此命令指定用于修正此 OpsItem 的 Systems Manager 自动化运行手册。

   ```
   $opsItem = New-Object Amazon.SimpleSystemsManagement.Model.OpsItemDataValue
   $opsItem.Type = [Amazon.SimpleSystemsManagement.OpsItemDataType]::SearchableString 
   $opsItem.Value = '[{\"automationId\":\"runbook_name\",\"automationType\":\"AWS::SSM::Automation\"}]'
   $newHash = @{" /aws/automations"=[Amazon.SimpleSystemsManagement.Model.OpsItemDataValue]$opsItem}
   
   New-SSMOpsItem `
       -Title "title" `
       -Description "description" `
       -Priority priority_number `
       -Source AWS_service `
       -OperationalData $newHash
   ```

   如果成功，此命令将输出新 OpsItem 的 ID。

下面的示例指定了受损的 Amazon Elastic Compute Cloud（Amazon EC2）实例的 Amazon 资源名称（ARN）。

```
$opsItem = New-Object Amazon.SimpleSystemsManagement.Model.OpsItemDataValue
$opsItem.Type = [Amazon.SimpleSystemsManagement.OpsItemDataType]::SearchableString 
$opsItem.Value = '[{\"arn\":\"arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\"}]'
$newHash = @{" /aws/resources"=[Amazon.SimpleSystemsManagement.Model.OpsItemDataValue]$opsItem}
New-SSMOpsItem -Title "EC2 instance disk full still" -Description "Log clean up may have failed which caused the disk to be full" -Priority 2 -Source ec2 -OperationalData $newHash
```

# 管理 OpsItems
<a name="OpsCenter-working-with-OpsItems"></a>

OpsCenter 是 AWS Systems Manager 中的一项工具，可追踪 OpsItems 从创建到解决的过程。如果您为跨账户管理设置了 OpsCenter，则委托管理员或管理账户可以从 OpsItems 的账户中管理它们。有关更多信息，请参阅 [（可选）将 OpsCenter 手动设置为跨账户集中管理 OpsItems](OpsCenter-getting-started-multiple-accounts.md)。

您可以使用 Systems Manager 控制台中的以下页面查看和管理 OpsItems：
+ **摘要** - 显示打开和正在进行的 OpsItems 的计数、按源和龄期划分的 OpsItems 的计数，以及运营洞察。您可以按源和 OpsItems 状态筛选 OpsItems。
+ **OpsItems** - 显示 OpsItems 的列表，其中包含多个信息字段，如标题、ID、优先级、描述、OpsItem 的源，以及上次更新的日期和时间。使用此页面，您可以手动创建 OpsItems、配置源、更改 OpsItem 的状态，以及按新事件筛选 OpsItems。您可以选择某一 OpsItem，以显示其 **OpsItems 详细信息**页面。
+ **OpsItem 详细信息** - 提供可以用于管理 OpsItem 的详细洞察和工具。OpsItems 详细信息页面包含以下选项卡：
  + **概览** - 显示相关资源、过去 30 天内运行的运行手册，以及您可以运行的可用运行手册的列表。您还可以查看相似 OpsItems、添加操作数据，以及添加相关 OpsItems。
  + **相关资源详细信息** - 显示有关来自多个 AWS 服务的资源的信息。展开 **Resource details (资源详细信息)** 部分，查看由托管此资源的 AWS 服务提供的有关此资源的信息。您也可以使用 **Related resources (相关资源)** 列表以切换与此 OpsItem 相关的其他相关资源。

有关如何管理 OpsItems 的更多信息，请参阅以下主题。

**Topics**
+ [查看 OpsItem 的详细信息](OpsCenter-working-with-OpsItems-viewing-details.md)
+ [编辑 OpsItem](OpsCenter-working-with-OpsItems-editing-details.md)
+ [将相关资源添加到 OpsItem](OpsCenter-working-with-OpsItems-adding-related-resources.md)
+ [将相关 OpsItems 添加到 OpsItem](OpsCenter-working-with-OpsItems-adding-related-OpsItems.md)
+ [将操作数据添加到 OpsItem](OpsCenter-working-with-OpsItems-adding-operational-data.md)
+ [为 OpsItem 创建事件](OpsCenter-working-with-OpsItems-create-an-incident.md)
+ [管理重复的 OpsItems](OpsCenter-working-deduplication.md)
+ [分析运营洞察以减少 OpsItems](OpsCenter-working-operational-insights.md)
+ [查看 OpsCenter 日志和报告](OpsCenter-logging-auditing.md)

# 查看 OpsItem 的详细信息
<a name="OpsCenter-working-with-OpsItems-viewing-details"></a>

要获得 OpsItem 的全面视图，请使用 OpsCenter 控制台中的 **OpsItem 详细信息**页面。**概览**页面将显示以下信息：
+ **OpsItems 详细信息** - 显示所选 OpsItem 的一般信息。
+ **相关资源** - 相关资源是指受影响的资源，或已启动创建 OpsItem 的事件的资源。
+ **过去 30 天内的自动执行** - 过去 30 天内运行的运行手册列表。
+ **运行手册** - 您可以从可用运行手册列表中选择一个运行手册。
+ **相似 OpsItem** - 这是系统生成的可能与您相关或您可能感兴趣的 OpsItems 的列表。为了生成此列表，系统将扫描所有 OpsItems 的标题和描述并返回使用相似单词的 OpsItems。
+ **操作数据** - 操作数据是一种自定义数据，该数据提供有关 OpsItem 的有用参考详细信息。例如，您可以指定日志文件、错误字符串、许可密钥、故障排除提示或其他相关数据。
+ **相关 OpsItem** - 您可以指定以某种方式与当前 OpsItem 相关的 OpsItems 的 ID。
+ **相关资源详细信息** - 显示数据提供程序，包括 Amazon CloudWatch 指标和警报、AWS CloudTrail 日志，以及来自 AWS Config 的详细信息。

**查看OpsItem的详细信息**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择 OpsItem 以查看其详细信息。

# 编辑 OpsItem
<a name="OpsCenter-working-with-OpsItems-editing-details"></a>

**OpsItem 详细信息**部分包括有关 OpsItem 的信息，其中包括描述、标题、源、OpsItem ID 和状态。  您可以编辑单个 OpsItem，也可以选择多个 OpsItems，然后编辑以下字段：**状态**、**优先级**、**严重性**、**类别**。

当 Amazon EventBridge 创建 OpsItem 时，它将填充**标题**、**源**和**描述**字段。您可以编辑**标题**和**描述**字段，但无法编辑**源**字段。

**注意**  
控制台支持 OpsiteM 描述字段中的大多数 Markdown 格式。有关更多信息，请参阅《AWS 管理控制台 入门指南》**中的[在控制台中使用 Markdown](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html)。

通常，您可以为 OpsItem 编辑以下可配置数据：
+ **标题** - OpsItem 的名称。源将创建 OpsItem 的标题。
+ **描述** – 有关此 OpsItem 的信息，包括（如果适用）再现问题的步骤。
+ **状态**：OpsItem 的状态。有关有效状态值的列表，请参阅《AWS Systems ManagerAPI 参考》**中的 [OpsItem 状态](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_OpsItem.html#systemsmanager-Type-OpsItem-Status)。
+ **优先级** - OpsItem 的优先级可以介于 1 到 5 之间。我们建议贵组织确定每个优先级的含义，以及每个优先级的相应服务级别协议。
+ **严重性** - OpsItem 的严重性可以介于 1 到 4 之间，其中 1 表示严重，2 表示高，3 表示中等，4 表示低。
+ **类别** - OpsItem 的类别可以是可用性、成本、性能、恢复能力或安全性。
+ **通知** - 当您编辑 OpsItem 时，可在**通知**字段中指定 Amazon Simple Notification Service 主题的 Amazon 资源名称（ARN）。通过指定 ARN，您可以确保所有利益相关者在编辑 OpsItem 时收到通知，包括状态更改。有关更多信息，请参阅 [https://docs.aws.amazon.com/sns/latest/dg/](https://docs.aws.amazon.com/sns/latest/dg/)。
**重要**  
Amazon SNS 主题必须位于与 OpsItem 相同的 AWS 区域中。如果主题和 OpsItem 位于不同的区域中，系统将返回错误。

OpsCenter 与 AWS Security Hub CSPM 具有双向集成。当您更新与安全调查发现相关的 OpsItem 状态和严重性时，这些更改将自动发送到 Security Hub CSPM，进而确保您始终看到最新且正确的信息。

根据 Security Hub CSPM 调查发现创建 OpsItem 时，Security Hub CSPM 元数据会自动添加到 OpsItem 的操作数据字段中。如果删除此元数据，则双向更新将不再起作用。

**编辑 OpsItem 详细信息**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择 OpsItem ID 以打开详细信息页面，或选择多个 OpsItems。如果您选择多个 OpsItems，则只能编辑状态、优先级、严重性或类别。如果您编辑多个 OpsItems，一旦您选择了新的状态、优先级、严重性或类别，OpsCenter 会立即更新并保存更改。

1. 在 **OpsItem details (OpsItem 详细信息)** 部分中，选择 **Edit (编辑)**。

1. 根据组织指定的要求和指南编辑 OpsItem 的详细信息。

1. 完成后，选择**保存**。

# 将相关资源添加到 OpsItem
<a name="OpsCenter-working-with-OpsItems-adding-related-resources"></a>

每个 OpsItem 均包括一个**相关资源**部分，该部分将列出相关资源的 Amazon 资源名称（ARN）。*相关资源*是指需要调查的受影响的 AWS 资源。

如果 Amazon EventBridge 创建 OpsItem，则系统将自动使用资源的 ARN 填充 OpsItem。您可以手动指定相关资源的 ARN。对于某些 ARN 类型，OpsCenter 将自动创建一个深层链接，它将直接在 OpsCenter 控制台中显示有关该资源的详细信息。例如，如果将 Amazon Elastic Compute Cloud（Amazon EC2）实例的 ARN 指定为相关资源，那么 OpsCenter 会提取与该 EC2 实例相关的详细信息。这使您能够查看有关受影响的 AWS 资源的详细信息，而无需离开 OpsCenter。

**查看相关资源并将相关资源添加到 OpsItem**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择 **OpsItems** 选项卡。

1. 选择一个 OpsItem ID。  
![\[OpsCenter“概览”页面上的新 OpsItem\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_working_scenario_1.png)

1. 要查看有关受影响的资源的信息，请选择 **Related resources details (相关资源详细信息)**选项卡。  
![\[查看 OpsItem 的“相关资源详细信息”选项卡\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_working_scenario_1_5.png)

   此选项卡将显示来自多个 AWS 服务的有关此资源的信息。展开 **Resource details**（资源详细信息）部分，以查看由托管此资源的 AWS 服务提供的有关此资源的信息。您也可以使用 **Related resources (相关资源)** 列表以切换与此 OpsItem 相关的其他相关资源。

1. 要添加其他相关资源，请选择 **Overview (概述)** 选项卡。

1. 在 **Related resources (相关资源)** 部分中，选择 **Add (添加)**。

1. 对于 **Resource type (资源类型)**，从列表中选择一种资源。

1. 对于 **Resource ID (资源 ID)**，输入资源 ID 或 Amazon Resource Name (ARN)。所选信息类型取决于上一步中选择的资源。

**注意**  
您可以手动添加额外的相关资源的 ARN。每个 OpsItem 可以列出最多 100 个相关资源 ARN。

下表列出了自动创建指向相关资源的深层链接的资源类型。


**支持的资源类型**  

| 资源名称 | ARN 格式 | 
| --- | --- | 
|  AWS Certificate Manager 证书  |  <pre>arn:aws:acm:region:account-id:certificate/certificate-id</pre>  | 
|  Amazon EC2 Auto Scaling 组  |  <pre>arn:aws:autoscaling:region:account-id:autoScalingGroup:groupid:autoScalingGroupName/groupfriendlyname</pre>  | 
|  Amazon CloudFront 分配  |  <pre>arn:aws:cloudfront::account-id:*</pre>  | 
|  AWS CloudFormation 堆栈  |  <pre>arn:aws:cloudformation:region:account-id:stack/stackname/additionalidentifier</pre>  | 
|  Amazon CloudWatch 告警  |  <pre>arn:aws:cloudwatch:region:account-id:alarm:alarm-name</pre>  | 
|  AWS CloudTrail 跟踪  |  <pre>arn:aws:cloudtrail:region:account-id:trail/trailname</pre>  | 
|  AWS CodeBuild 项目  |  <pre>arn:aws:codebuild:region:account-id:resourcetype/resource</pre>  | 
|  AWS CodePipeline  |  <pre>arn:aws:codepipeline:region:account-id:resource-specifier</pre>  | 
|  Amazon DevOps Guru 洞察  |  <pre>arn:aws:devops-guru:region:account-id:insight/proactive or reactive/resource-id</pre>  | 
|  Amazon DynamoDB 表  |  <pre>arn:aws:dynamodb:region:account-id:table/tablename</pre>  | 
|  Amazon Elastic Compute Cloud (Amazon EC2) 客户网关  |  <pre>arn:aws:ec2:region:account-id:customer-gateway/cgw-id</pre>  | 
|  Amazon EC2 弹性 IP  |  <pre>arn:aws:ec2:region:account-id:eip/eipalloc-id</pre>  | 
|  Amazon EC2 专用主机  |  <pre>arn:aws:ec2:region:account-id:dedicated-host/host-id</pre>  | 
|  Amazon EC2 实例  |  <pre>arn:aws:ec2:region:account-id:instance/instance-id</pre>  | 
|  Amazon EC2 互联网网关  |  <pre>arn:aws:ec2:region:account-id:internet-gateway/igw-id</pre>  | 
|  Amazon EC2 网络访问控制列表  |  <pre>arn:aws:ec2:region:account-id:network-acl/nacl-id</pre>  | 
|  Amazon EC2 网络接口  |  <pre>arn:aws:ec2:region:account-id:network-interface/eni-id</pre>  | 
|  Amazon EC2 路由表  |  <pre>arn:aws:ec2:region:account-id:route-table/route-table-id</pre>  | 
|  Amazon EC2 安全组  |  <pre>arn:aws:ec2:region:account-id:security-group/security-group-id</pre>  | 
|  Amazon EC2 子网  |  <pre>arn:aws:ec2:region:account-id:subnet/subnet-id</pre>  | 
|  Amazon EC2 卷  |  <pre>arn:aws:ec2:region:account-id:volume/volume-id</pre>  | 
|  Amazon EC2 VPC  |  <pre>arn:aws:ec2:region:account-id:vpc/vpc-id</pre>  | 
|  Amazon EC2 VPN 连接  |  <pre>arn:aws:ec2:region:account-id:vpn-connection/vpn-id</pre>  | 
|  Amazon EC2 VPN 网关  |  <pre>arn:aws:ec2:region:account-id:vpn-gateway/vgw-id</pre>  | 
|  AWS Elastic Beanstalk 应用程序  |  <pre>arn:aws:elasticbeanstalk:region:account-id:application/applicationname</pre>  | 
|  Elastic Load Balancing (经典负载均衡器)  |  <pre>arn:aws:elasticloadbalancing:region:account-id:loadbalancer/name</pre>  | 
|  Elastic Load Balancing（应用程序负载均衡器）  |  <pre>arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id</pre>  | 
|  Elastic Load Balancing (Network Load Balancer)  |  <pre>arn:aws:elasticloadbalancing:region:account-id:loadbalancer/net/load-balancer-name/load-balancer-id</pre>  | 
|  AWS Identity and Access Management (IAM) 组  |  <pre>arn:aws:iam::account-id:group/group-name</pre>  | 
|  IAM policy  |  <pre>arn:aws:iam::account-id:policy/policy-name</pre>  | 
|  IAM 角色  |  <pre>arn:aws:iam::account-id:role/role-name</pre>  | 
|  IAM 用户  |  <pre>arn:aws:iam::account-id:user/user-name</pre>  | 
|  AWS Lambda 函数  |  <pre>arn:aws:lambda:region:account-id:function:function-name</pre>  | 
|  Amazon Relational Database Service (Amazon RDS) 集群  |  <pre>arn:aws:rds:region:account-id:cluster:db-cluster-name</pre>  | 
|  Amazon RDS 数据库实例  |  <pre>arn:aws:rds:region:account-id:db:db-instance-name</pre>  | 
|  Amazon RDS 订阅  |  <pre>arn:aws:rds:region:account-id:es:subscription-name</pre>  | 
|  Amazon RDS 安全组  |  <pre>arn:aws:rds:region:account-id:secgrp:security-group-name</pre>  | 
|  Amazon RDS 集群快照  |  <pre>arn:aws:rds:region:account-id:cluster-snapshot:cluster-snapshot-name</pre>  | 
|  Amazon RDS 子网组  |  <pre>arn:aws:rds:region:account-id:subgrp:subnet-group-name</pre>  | 
|  Amazon Redshift 集群  |  <pre>arn:aws:redshift:region:account-id:cluster:cluster-name</pre>  | 
|  Amazon Redshift 参数组  |  <pre>arn:aws:redshift:region:account-id:parametergroup:parameter-group-name</pre>  | 
|  Amazon Redshift 安全组  |  <pre>arn:aws:redshift:region:account-id:securitygroup:security-group-name</pre>  | 
|  Amazon Redshift 集群快照  |  <pre>arn:aws:redshift:region:account-id:snapshot:cluster-name/snapshot-name</pre>  | 
|  Amazon Redshift 子网组  |  <pre>arn:aws:redshift:region:account-id:subnetgroup:subnet-group-name</pre>  | 
|  Amazon Simple Storage Service（Amazon S3）桶  |  <pre>arn:aws:s3:::bucket_name</pre>  | 
|  AWS Systems Manager 托管式节点清单的 AWS Config 记录  |  <pre>arn:aws:ssm:region:account-id:managed-instance-inventory/node_id</pre>  | 
|  Systems Manager State Manager 关联  |  <pre>arn:aws:ssm:region:account-id:association/association_ID</pre>  | 

# 将相关 OpsItems 添加到 OpsItem
<a name="OpsCenter-working-with-OpsItems-adding-related-OpsItems"></a>

通过使用 **OpsItem 详细信息**页面的**相关 OpsItems**，您可以调查操作问题，并提供问题的上下文。可以通过不同方式与 OpsItems 关联，包括 OpsItems 之间的父子关系、根本原因或重复。您可以将一个 OpsItem 与另一个关联起来，以将其显示在**相关 OpsItem** 部分中。您最多可以为与当前 OpsItem 相关的其他 OpsItems 指定 10 个 ID。

![\[查看相关的 OpsItems。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_working_scenario_4.png)


**要添加相关的 OpsItem，请执行以下步骤：**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择 OpsItem ID 以打开详细信息页面。

1. 在 **Related OpsItem (相关的 &OI;)** 部分中，选择 **Add (添加)**。

1. 对于 **OpsItem ID**，请指定一个 ID。

1. 选择**添加**。

# 将操作数据添加到 OpsItem
<a name="OpsCenter-working-with-OpsItems-adding-operational-data"></a>

操作数据是一种自定义数据，该数据提供了有关 OpsItem 的有用参考详细信息。您可以输入操作数据的多个密钥/值对。例如，您可以指定日志文件、错误字符串、许可密钥、故障排除提示或其他相关数据。密钥的最大长度可以为 128 个字符，值的最大大小可以为 20 KB。

![\[查看 OpsItem 的操作数据。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_working_scenario_7.png)


您可以使数据可供账户中的其他用户搜索，也可以限制搜索访问。可搜索数据是指所有有权访问 OpsItem **概览**页面（由 [DescribeOpsItems](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeOpsItems.html) API 操作提供）的用户都可以查看和搜索指定数据。不可搜索的操作数据仅可供有权访问 OpsItem（由 [GetOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsItem.html) API 操作提供）的用户查看。

**将操作数据添加到 OpsItem**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择 OpsItem ID 以打开其详细信息页面。

1. 展开**操作数据**。

1. 如果 OpsItem 没有操作数据，则选择**添加**。如果 OpsItem 有操作数据，则选择 **Manage (管理)**。

   在创建操作数据后，您可以通过选择 **Manage (管理)** 来编辑密钥和值、删除操作数据或添加其他密钥值对。

1. 对于 **Key (密钥)**，指定一个或多个单词来帮助用户了解数据的用途。
**重要**  
操作数据键*不能*以下列单词开头：`amazon`、`aws`、`amzn`、`ssm`、`/amazon`、`/aws`、`/amzn`、`/ssm`。

1. 对于 **Value (值)**，指定该数据。

1. 选择**保存**。

**注意**  
您可以在 **OpsItems** 页面上使用**操作数据**运算符筛选 OpsItems。在**搜索**框中，选择**操作数据**，然后输入 JSON 格式的键值对。您必须使用以下格式输入键/值对：`{"key":"key_name","value":"a_value"}`

# 为 OpsItem 创建事件
<a name="OpsCenter-working-with-OpsItems-create-an-incident"></a>

按照以下过程为 OpsItem 手动创建事件，以便在 AWS Systems Manager Incident Manager（AWS Systems Manager 中的一项工具）中跟踪和管理该 OpsItem。*事件*是指任何计划外的服务中断或质量下降。有关 Incident Manager 的更多信息，请参阅 [将 OpsCenter 与其他 AWS 服务 集成](OpsCenter-applications-that-integrate.md)。

**要为 OpsItem 手动创建事件，请执行以下步骤：**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，选择 **OpsCenter**。

1. 如果 Incident Manager 为您创建了 OpsItem，请选择它，然后转到步骤 5。如果没有，请选择 **Create OpsItem (创建 OpsItem)** 并填写表单。如果您没有看到该按钮，请选择 **OpsItems** 选项卡，然后选择 **Create OpsItem (创建 OpsItem)**。

1. 如果您创建了 OpsItem，则打开它。

1. 选择 **Start Incident (启动事件)**。

1. 对于**响应计划**，选择要分配给此事件的 Incident Manager 响应计划。

1. （可选）对于 **Title (标题)**，输入一个有助于其他团队成员了解事件性质的描述性名称。如果您没有输入新的标题，OpsCenter 会使用响应计划中的标题在 Incident Manager 中创建 OpsItem 和相应的事件。

1. (可选）对于 **Incident impact (事件影响)**，选择该事件的影响级别。如果您没有选择影响级别，OpsCenter 会使用响应计划中的影响级别在 Incident Manager 中创建 OpsItem 和相应的事件。

1. 选择**启动**。

# 管理重复的 OpsItems
<a name="OpsCenter-working-deduplication"></a>

OpsCenter 可从多个 AWS 服务 获得某个源的多个重复 OpsItems。OpsCenter 使用内置逻辑和可配置的重复数据删除字符串的组合来避免创建重复的 OpsItems。在调用[创建OpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CreateOpsItem.html) API 操作时，AWS Systems Manager 将应用重复数据删除内置逻辑。

AWS Systems Manager 使用以下重复数据删除逻辑：

1. 创建 OpsItem 时，Systems Manager 会创建和存储基于重复数据删除字符串的哈希值，以及启动 OpsItem 的资源。

1. 当发出另一个创建 OpsItem 的请求时，系统将检查新请求的重复数据删除字符串。

1. 如果此重复数据删除字符串存在匹配的哈希值，则 Systems Manager 将检查现有 OpsItem 的状态。如果现有 OpsItem 的状态为打开或正在进行，则不会创建 OpsItem。如果现有 OpsItem 得到解决，Systems Manager 将创建一个新的 OpsItem。

创建 OpsItem 之后，您*无法* 编辑或更改该 OpsItem 中的重复数据删除字符串。

要管理重复的 OpsItems，可以执行以下操作：
+ 编辑以 OpsCenter 为目标的 Amazon EventBridge 规则的重复数据删除字符串。有关更多信息，请参阅 [在默认 EventBridge 规则中编辑重复数据删除字符串](#OpsCenter-working-deduplication-editing-cwe)。
+ 当您手动创建 OpsItem 时，指定重复数据删除字符串。有关更多信息，请参阅 [使用 AWS CLI 指定重复数据删除字符串](#OpsCenter-working-deduplication-configuring-manual-cli)。
+ 使用运营洞察查看和解决重复的 OpsItems。您可以使用运行手册来解决重复的 OpsItems。

  为了帮助您解决重复的 OpsItems，并减少由源创建的 OpsItems 的数量，Systems Manager 提供了自动化运行手册。有关信息，请参阅[基于洞察解决重复的 OpsItems](OpsCenter-working-operational-insights.md#OpsCenter-working-operational-insights-resolve)。

## 在默认 EventBridge 规则中编辑重复数据删除字符串
<a name="OpsCenter-working-deduplication-editing-cwe"></a>

按照以下过程为将 OpsCenter 作为目标的 Eventbridge 规则指定重复数据删除字符串。

**为 EventBridge 规则编辑重复数据删除字符串**

1. 登录 AWS 管理控制台并打开 Amazon EventBridge 控制台 ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/))。

1. 在导航窗格中，选择**规则**。

1. 选择一个规则，然后选择 **Edit (编辑)**。

1. 转至 **Select target(s)**（选择目标）页面。

1. 在 **Additional settings**（其他设置）部分，选择 **Configure input transformer**（配置输入转换器）。

1. 在 **Template**（模块）对话框中，找到该 `"operationalData": { "/aws/dedup"` JSON 条目以及您要编辑的重复数据删除字符串。

   Eventbridge 规则中的重复数据删除字符串条目使用以下 JSON 格式。

   ```
   "operationalData": { "/aws/dedup": {"type": "SearchableString","value": "{\"dedupString\":\"Words the system should use to check for duplicate OpsItems\"}"}}
   ```

   见下列。

   ```
   "operationalData": { "/aws/dedup": {"type": "SearchableString","value": "{\"dedupString\":\"SSMOpsCenter-EBS-volume-performance-issue\"}"}}
   ```

1. 编辑这些重复数据删除字符串，然后选择**确认**。

1. 选择**下一步**。

1. 选择**下一步**。

1. 选择**更新规则**。

## 使用 AWS CLI 指定重复数据删除字符串
<a name="OpsCenter-working-deduplication-configuring-manual-cli"></a>

当您使用 AWS Systems Manager 控制台或 AWS CLI 手动创建新的 OpsItem 时，可以指定重复数据删除字符串。有关在控制台中手动创建 OpsItem 时输入重复数据删除字符串的信息，请参阅 [手动创建 OpsItems](OpsCenter-manually-create-OpsItems.md)。如果您使用 AWS CLI，可为 `OperationalData` 参数输入重复数据删除字符串。参数语法使用 JSON，如下面的示例所示。

```
--operational-data '{"/aws/dedup":{"Value":"{\"dedupString\": \"Words the system should use to check for duplicate OpsItems\"}","Type":"SearchableString"}}'
```

此处的示例命令指定重复数据删除字符串 `disk full`。

------
#### [ Linux & macOS ]

```
aws ssm create-ops-item \
    --title "EC2 instance disk full" \
    --description "Log clean up may have failed which caused the disk to be full" \
    --priority 1 \
    --source ec2 \
    --operational-data '{"/aws/dedup":{"Value":"{\"dedupString\": \"disk full\"}","Type":"SearchableString"}}' \
    --tags "Key=EC2,Value=ProductionServers" \
    --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser"
```

------
#### [ Windows ]

```
aws ssm create-ops-item ^
    --title "EC2 instance disk full" ^
    --description "Log clean up may have failed which caused the disk to be full" ^
    --priority 1 ^
    --source EC2 ^
    --operational-data={\"/aws/dedup\":{\"Value\":\"{\\"""dedupString\\""":\\"""disk full\\"""}\",\"Type\":\"SearchableString\"}} ^
    --tags "Key=EC2,Value=ProductionServers" --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser"
```

------

# 分析运营洞察以减少 OpsItems
<a name="OpsCenter-working-operational-insights"></a>

OpsCenter *运营洞察*显示有关重复 OpsItems 的信息。OpsCenter 在您的账户中自动分析 OpsItems 并生成三种类型的*洞察*。您可以在 OpsCenter **摘要**选项卡的**运营洞察**部分中查看此信息。
+ **重复 OpsItems** – 当八个或更多 OpsItems 对同一资源具有相同的标题时，将生成洞察。
+ **最常见的标题** – 当超过 50 个 OpsItems 具有相同标题时，将生成洞察。
+ **生成最多 OpsItems 的资源** – 当 AWS 资源具有超过 10 个打开的 OpsItems 时，将生成洞察。这些洞察及其对应的资源显示在 OpsCenter **摘要**选项卡上的**生成最多 OpsItem 的资源**表中。资源按 OpsItem 计数的递减顺序列出。

**注意**  
OpsCenter 为以下资源类型创建**生成最多 OpsItems 的资源**洞察：  
Amazon Elastic Compute Cloud（Amazon EC2）实例
Amazon EC2 安全组
Amazon EC2 Auto Scaling 组
Amazon Relational Database Service（Amazon RDS）数据库
Amazon RDS 集群
AWS Lambda 函数
Amazon DynamoDB 表
Elastic Load Balancing 负载均衡器
Amazon Redshift 集群
AWS Certificate Manager 证书
Amazon Elastic Block Store 卷

OpsCenter 强制实施每种类型 15 个洞察的限制。如果某个类型达到此限制，OpsCenter 会停止显示该类型的更多洞察。要查看其他洞察，您必须解决与该类型的 OpsInsight 相关的所有 OpsItems。如果由于 15 个洞察的限制而无法在控制台中显示待处理的洞察，则该洞察将在另一个洞察关闭后变为可见。

当您选择某个洞察后，OpsCenter 会显示受影响的 OpsItems 和资源的相关信息。以下屏幕截图展示了一个示例，其中包含重复 OpsItem 洞察的详细信息。

![\[OpsCenter 洞察的详细视图，其中包含有关 OpsItems 的信息。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsCenter-insights-detailed.png)


默认情况下，“运营洞察”处于关闭状态。有关使用运营洞察的更多信息，请参阅以下主题。

**Topics**
+ [启用运营洞察](#OpsCenter-working-operational-insights-viewing)
+ [基于洞察解决重复的 OpsItems](#OpsCenter-working-operational-insights-resolve)
+ [禁用运营洞察](#OpsCenter-working-operational-insights-disable)

## 启用运营洞察
<a name="OpsCenter-working-operational-insights-viewing"></a>

您可以在 Systems Manager 控制台的 **OpsCenter** 页面上启用运营洞察。当您启用运营洞察后，Systems Manager 将创建名为 `AWSServiceRoleForAmazonSSM_OpsInsights` 的 AWS Identity and Access Management（IAM）服务相关角色。服务相关角色是一种与 Systems Manager 直接关联的独特类型的 IAM 角色。服务相关角色是预定义的角色，包括相应服务代表您调用其他 AWS 服务 所需的所有权限。有关 `AWSServiceRoleForAmazonSSM_OpsInsights` 服务相关角色的更多信息，请参阅[在 Systems Manager OpsCenter 中使用角色创建运营洞察 OpsItem](using-service-linked-roles-service-action-4.md)。

**注意**  
请注意以下重要信息：  
将向您的 AWS 账户 收取运营洞察的费用。有关更多信息，请参阅[AWS Systems Manager定价](https://aws.amazon.com/systems-manager/pricing/)。
OpsCenter 使用批处理定期刷新洞察。这意味着 OpsCenter 中显示的洞察列表可能不同步。

按照以下过程在 OpsCenter 中启用和查看运营洞察。

**启用和查看运营洞察**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 在**运营洞察可用**消息框中，选择**启用**。如果您没有看到此消息，请向下滚动到**运营洞察**部分，然后选择**启用**。

1. 启用此功能后，在**摘要**选项卡上，向下滚动到**运营洞察**部分。

1. 要查看经过筛选的洞察列表，选择**重复OpsItems**、**最常见的标题**或**生成最多 OpsItems 的资源**旁边的链接。要查看所有洞察，选择 **View all operational insights (查看所有运营洞察)**。

1. 选择洞察 ID 以查看更多信息。

## 基于洞察解决重复的 OpsItems
<a name="OpsCenter-working-operational-insights-resolve"></a>

要解决洞察问题，必须先解决与洞察关联的所有 OpsItems 的问题。您可以使用 `AWS-BulkResolveOpsItemsForInsight` 运行手册来解决与洞察关联的 OpsItems 的问题。

为了帮助您解决重复的 OpsItems，并减少由源创建的 OpsItems 的数量，Systems Manager 提供了以下自动化运行手册：
+ `AWS-BulkResolveOpsItems` 运行手册解决与指定筛选条件匹配的 OpsItems。
+ `AWS-AddOpsItemDedupStringToEventBridgeRule` 运行手册将为与特定 Amazon EventBridge 规则关联的所有 OpsItem 目标添加重复数据删除字符串。如果某一规则已经包含重复数据删除字符串，则此运行手册不会再添加该字符串。
+ 如果 EventBridge 中的某一规则生成数十或数百个 OpsItems，则 `AWS-DisableEventBridgeRule` 将关闭该规则。

**解决运营洞察问题**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. **在 Overview (概览)** 选项卡上，向下滚动到 **Operational insights (运营洞察)**。

1. 选择**查看所有运营洞察**。

1. 选择洞察 ID 以查看更多信息。

1. 选择运行手册，然后选择**执行**。

## 禁用运营洞察
<a name="OpsCenter-working-operational-insights-disable"></a>

当您关闭运营洞察后，系统将停止创建新的洞察，并停止在控制台中显示洞察。任何处于活动状态的洞察在系统中都保持不变，但您不会在控制台中看到它们。如果您再次启用此功能，系统将显示之前未解决的洞察，并开始创建新的洞察。按照以下过程关闭运营洞察。

**关闭运营洞察**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择**设置**。

1. 在 **Operational insights (运营洞察)** 部分，选择 **Edit (编辑)**，然后切换 **Disable (禁用)** 选项。

1. 选择**保存**。

# 查看 OpsCenter 日志和报告
<a name="OpsCenter-logging-auditing"></a>

AWS CloudTrail 可以记录对控制台、AWS Command Line Interface（AWS CLI）和 SDK 的 AWS Systems Manager OpsCenter API 调用。您可以在 CloudTrail 控制台或 Amazon Simple Storage Service (Amazon S3) 存储桶中查看信息。Amazon S3 使用一个存储桶来存储您账户的所有 CloudTrail 日志。

OpsCenter 操作日志显示对 OpsItem 活动进行的创建、更新、获取和描述操作。有关查看和使用 Systems Manager 活动的 CloudTrail 日志的更多信息，请参阅 [使用 AWS CloudTrail 记录 AWS Systems Manager API 调用](monitoring-cloudtrail-logs.md)。

AWS Systems Manager OpsCenter 可以为您提供有关 OpsItems 的以下信息：
+ **OpsItem 状态摘要** - 按状态（“打开且正在进行”、“打开”或“正在进行”、）提供 OpsItems 的摘要。
+ **具有最多开放 OpsItems 的源** - 具有最多开放 OpsItems 的热门 AWS 服务 分类。
+ **按源和使用期限显示的 OpsItems** - 提供按源和创建天数分组的 OpsItems 的计数。

**查看 OpsCenter 摘要报告**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 在 OpsItems **概览**页面上，选择**摘要**。

1. 在 **OpsItems by source and age (按源和使用期限显示的 OpsItem)** 下，选择搜索栏以根据 **Source (源)** 筛选 OpsItems。使用列表来根据**状态**筛选。

# 删除 OpsItems
<a name="OpsCenter-delete-OpsItems"></a>

您可以使用 AWS Command Line Interface 或 AWS SDK 来调用 [DeleteOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DeleteOpsItem.html) API 操作，从而删除单个 OpsItem。您无法 AWS 管理控制台在中删除 OpsItem。要删除 OpsItem，您的 AWS Identity and Access Management（IAM）用户、组或角色必须具有管理员权限，或者您必须已获得调用 `DeleteOpsItem` API 操作的权限。

**重要**  
对于此操作应注意以下重要的信息：  
删除 OpsItem 后将不可逆。您无法恢复已删除的 OpsItem。
此操作使用的是*最终一致性模型*，这意味着系统可能需要几分钟才能完成操作。如果您删除 OpsItem 后立即调用（例如 [GetOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsItem.html)），则已删除的 OpsItem 可能仍会出现在响应中。
此操作是幂等的。如果您为同一 OpsItem 反复调用此操作，系统不会发出异常。如果第一个调用成功，则所有其他调用都会返回与第一个调用相同的成功响应。
此操作不支持跨账户调用。委派管理员或管理账户无法删除其他账户中的 OpsItems，即使针对跨账户管理设置了 OpsCenter 也不可行。有关跨账户管理的更多信息，请参阅 [（可选）将 OpsCenter 设置为跨账户集中管理 OpsItems](OpsCenter-setting-up-cross-account.md)。
如果您收到 `OpsItemLimitExceededException`，则可以删除一个或多个 OpsItems，以使 OpsItems 总数低于限额。有关此异常的更多信息，请参阅 [排查 OpsCenter 问题](OpsCenter-troubleshooting.md)。

## 删除 OpsItem
<a name="OpsCenter-delete-OpsItems-deleting"></a>

按照以下过程删除 OpsItem。

**删除 OpsItem**

1. 安装并配置 AWS CLI（如果尚未执行该操作）。有关更多信息，请参阅[安装或更新 AWS CLI 的最新版本](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。

1. 运行以下命令。将 *ID* 替换为您要删除的 OpsItem ID。

   ```
   aws ssm delete-ops-item --ops-item-id ID
   ```

如果成功，该命令将不会返回任何数据。

# 修复 OpsItem 问题
<a name="OpsCenter-remediating"></a>

使用 AWS Systems Manager 自动化运行手册，您可以修复在 OpsItem 中发现的 AWS 资源的问题。自动化使用预定义的运行手册来修复 AWS 资源的常见问题。

每个 OpsItem 都包括**运行手册**部分，该部分将提供可用于修复的运行手册列表。当您从该列表中选择自动化运行手册时，OpsCenter 将自动显示运行该文档所需的一些字段。当您运行自动化运行手册时，系统会将该运行手册与 OpsItem 的相关资源关联起来。如果 Amazon EventBridge 创建了 OpsItem，它会将运行手册与 OpsItem 关联起来。OpsCenter 将为 OpsItem 保留自动化运行手册的 30 天记录。

 您可以选择某一状态以查看有关运行手册的重要详细信息，如自动化失败的原因，以及失败发生时正在运行自动化运行手册的步骤，如下面的示例所示。

![\[上次运行自动化运行手册的状态信息。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_automation_results.png)


所选 OpsItem 的 **Related resource details (相关资源详细信息)** 页面包含 **Run automation (运行自动化)** 列表。您可以选择最近或特定于资源的自动化运行手册，并且可以运行它们以修复问题。此页面还包括多个数据提供程序，其中包括 Amazon CloudWatch 指标和警报、AWS CloudTrail 日志，以及来自 AWS Config 的详细信息。

![\[“相关资源”选项卡上提供的指标。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_automation_related_resource_details.png)


您可以通过在控制台中选择自动化运行手册名称或使用 [Systems Manager 自动化运行手册参考](automation-documents-reference.md) 来查看有关该运行手册的信息。

## 使用运行手册修复 OpsItem
<a name="OpsCenter-remediating-how-to"></a>

在使用自动化运行手册修复 OpsItem 问题之前，请执行以下操作：
+ 确认您有权运行 Systems Manager 自动化运行手册。有关更多信息，请参阅 [设置自动化](automation-setup.md)。
+ 为要运行的自动化运行手册收集特定于资源的 ID 信息。例如，如果您要运行重新启动 EC2 实例的自动化，则必须指定要重新启动的 EC2 实例的 ID。

**要运行自动化运行手册来修正 OpsItem 问题，请执行以下步骤：**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择 OpsItem ID 以打开详细信息页面。  
![\[OpsCenter“概览”页面上的新 OpsItem。\]](http://docs.aws.amazon.com/zh_cn/systems-manager/latest/userguide/images/OpsItems_working_scenario_1.png)

1. 滚动到 **Runbooks (运行手册)** 部分。

1. 使用搜索栏或右上角的数字查找您要运行的自动化运行手册。

1. 选择运行手册，然后选择 **Execute (执行)**。

1. 输入运行手册的所需信息，然后选择**提交**。

   启动运行手册后，系统会返回到上一个屏幕并显示状态。

1. 在**过去 30 天内的自动化执行**部分中，选择**执行 ID** 链接以查看执行步骤和状态。

## 使用关联的运行手册修复 OpsItem
<a name="OpsCenter-remediating-associated-runbooks"></a>

在您从 OpsItem 中运行自动化运行手册后，OpsCenter 会将该运行手册与 OpsItem 关联起来。*关联的*运行手册在**运行手册**列表中的排名高于其他运行手册。

按照以下过程运行已与 OpsItem 中的相关资源关联的自动化运行手册。有关添加相关资源的信息，请参阅 [管理 OpsItems](OpsCenter-working-with-OpsItems.md)。

**要运行与资源关联的运行手册以修正 OpsItem 问题，请执行以下步骤：**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 打开 OpsItem。

1. 在 **Related resources (相关资源)** 部分中，选择要运行自动化运行手册的资源。

1. 选择 **Run automation (运行自动化)**，然后选择要运行的关联自动化运行手册。

1. 输入运行手册的所需信息，然后选择 **Execute (执行)**。

   启动运行手册后，系统会返回到上一个屏幕并显示状态。

1. 在**过去 30 天内的自动化执行**部分中，选择**执行 ID** 链接以查看执行步骤和状态。

# 查看 OpsCenter 摘要报告
<a name="OpsCenter-reports"></a>

AWS Systems Manager OpsCenter 包括一个摘要页面，其中将自动显示以下信息：
+ **OpsItem 状态摘要** – 按状态列出的 OpsItems 摘要，例如 `Open` 和 `In progress`。
+ **具有最多打开的 OpsItems 的源** – 具有最多打开的 OpsItems 的 AWS 服务 明细。
+ **按源和使用期限显示的 OpsItems** – 按源和创建天数分组的 OpsItems 的计数。

**查看 OpsCenter 摘要报告**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，选择 **OpsCenter**，然后选择**摘要**选项卡。

1. 在**按源和使用期限显示的 OpsItems** 部分中，执行以下操作：

   1. （可选）在筛选字段中，选择**来源**，选择 `Equal`、`Begin With` 或 `Not Equal`，然后输入搜索参数。

   1. 在相邻列表中，选择下列状态值之一：
      + `Open`
      + `In progress`
      + `Resolved`
      + `Open and in progress`
      + `All`

# 排查 OpsCenter 问题
<a name="OpsCenter-troubleshooting"></a>

本主题包含的信息有助于排查 OpsCenter 的常见错误和问题。

## 您收到了 OpsItemLimitExceededException
<a name="OpsCenter-troubleshooting-OpsItemLimitExceededException"></a>

如果您的 AWS 账户 在调用 CreateOpsItem API 操作时已达到允许的最大 OpsItems 数量，您将会收到 `OpsItemLimitExceededException`。如果您的调用将会超过以下任一限额的最大 OpsItems 数量时，OpsCenter 将会返回异常：
+ 每区域每 AWS 账户的 OpsItems 总数（包括 `Open` 和 `Resolved` OpsItem）：500,000 
+ 每月每 AWS 账户的最大 OpsItems 数：10000

这些限额适用于从任何来源创建的 OpsItems，但以下来源除外：
+ 由 AWS Security Hub CSPM 调查发现创建的 OpsItems
+ 在 Incident Manager 事件打开时自动生成的 OpsItems

从这些来源创建的 OpsItems 不会计入您的 OpsItem 限额，但您需要为每个 OpsItem 付费。

如果您收到了 `OpsItemLimitExceededException`，则可以手动删除 OpsItems，直到低于您的限额，不会妨碍您创建新的 OpsItem 为止。同样，删除为 Security Hub CSPM 调查发现或 Incident Manager 事件创建的 OpsItems 不会减少限额强制执行的 OpsItems 总数。您必须删除其他来源的 OpsItems。有关如何删除 OpsItem 的信息，请参阅 [删除 OpsItems](OpsCenter-delete-OpsItems.md)。

## 对于大量自动生成的 OpsItems，您会收到高额的 AWS 账单
<a name="OpsCenter-troubleshooting-auto-generated-OpsItems"></a>

如果您配置了与 AWS Security Hub CSPM 的集成，则 OpsCenter 会为 Security Hub CSPM 调查发现创建 OpsItems。根据 Security Hub CSPM 生成的调查发现数量以及您在配置集成时登录的账户，OpsCenter 可能会生成大量的 OpsItems 并且这会产生成本。以下是与 Security Hub CSPM 调查发现生成的 OpsItems 相关的更具体详细信息：
+ 如果您在配置 OpsCenter 和 Security Hub CSPM 集成时登录到 Security Hub CSPM 管理员账户，则系统会针对在管理员*和*所有成员账户中的调查发现创建 OpsItems。OpsItems 均*在管理员账户中*创建。根据各种因素，这可能会导致来自 AWS 的意外巨额账单。

  如果您在配置集成时登录到成员账户，则系统仅针对该个人账户中的调查发现创建 OpsItems。有关 Security Hub CSPM 管理员账户、成员账户及其与 EventBridge 调查发现事件源关系的更多信息，请参阅《AWS Security Hub User Guide》**中的 [Types of Security Hub CSPM integration with EventBridge](https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-cwe-integration-types.html)。
+ 对于创建 OpsItem 的每个调查发现，都将按常规价格向您收取创建 OpsItem 的费用。如果您编辑了 OpsItem 或在 Security Hub CSPM 中更新了相应的调查发现（这会触发 OpsItem 更新），则也会产生费用。
+ 通过与 AWS Security Hub CSPM 集成创建的 OpsItems 暂*不受*每个区域每个账户 50 万个 OpsItems 的最大配额限制。因此，Security Hub CSPM 警报可以在账户的每个区域中创建超过 50 万个可收费 OpsItems。

  因此，对于高负载生产环境，建议将 Security Hub CSPM 调查发现范围限定为仅高严重性问题。

**重要**  
如果您认为有大量 OpsItems 是错误创建的，并且您的 AWS 账单没有依据，请联系 支持。

如果您不再希望系统为 Security Hub CSPM 调查发现创建 OpsItems，请使用以下步骤。

**停止接收 Security Hub CSPM 调查发现的 OpsItems**

1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)，打开 AWS Systems Manager 控制台。

1. 在导航窗格中，请选择 **OpsCenter**。

1. 选择**设置**。

1. 在 **Security Hub CSPM 调查发现**部分，选择**编辑**。

1. 选择滑块将**已启用**更改为**已禁用**。如果无法切换滑块，则说明您的 AWS 账户 尚未启用 Security Hub CSPM。

1. 选择**保存**保存您的配置。OpsCenter 不再根据 Security Hub CSPM 调查发现创建 OpsItems。

**重要**  
如果 OpsCenter 将设置切换回**已启用**并继续为调查发现创建 OpsItems，请登录 Systems Manager 委派管理员账户或 AWS Organizations 管理账户，然后重复此过程。如果您无权登录其中任何一个账户，请联系您的管理员并要求他们重复此步骤，以为您的账户禁用集成。