使用 OOpsItems - AWS Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

使用 OOpsItems

本部分介绍如何配置 AWS Systems Manager OpsItem 中的可用选项。有关创建 OpsItems 的信息,请参阅创建 OpsItems

A相关资源是需要调查或触发 Amazon EventBridge 事件的受影响的 AWS 资源。每个 OpsItem 都有一个相关资源部分。如果 EventBridge 创建 OpsItem,则系统会自动使用资源的 Amazon 资源名称 (ARN) 填充 OpsItem。您也可以手动指定相关资源的 ARN。对于一些 ARN 类型,AWS Systems Manager OpsCenter 会自动创建一个深层链接,可通过该链接查看有关资源的详细信息,而无需访问其他控制台页面来查看该信息。例如,您可以指定 Amazon EC2 实例的 ARN。在 OpsCenter 中,您随后可以查看 Amazon EC2 提供的有关该实例的所有详细信息。要查看已自动创建指向相关资源的深层链接的资源类型列表,请参阅支持的资源参考

注意

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

查看和添加相关资源

  1. AWS Systems Manager 控制台https://console.aws.amazon.com/systems-manager/

  2. 在导航窗格中,选择OpsCenter

  3. 选择OpsItems选项卡。

  4. 选择 OOpsItem ID。

    
                            OpsCenter OpsItem enter “概述” 页面上的新 OpsIce
  5. 要查看有关受影响的资源的信息,请选择 Related resources details (相关资源详细信息)选项卡。

    
                            查看 OpsItem ce 的 “相关资源” 选项卡

    此选项卡显示有关多个 AWS 服务的资源。展开资源详细信息 部分,查看由托管它的 AWS 服务提供的此资源的信息。您还可以切换与此 OpsItem 关联的其他相关资源,方法是使用相关资源列表。

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

  7. Related resources (相关资源) 部分中,选择 Add (添加)

  8. 适用于资源类型下,从列表中选择资源。

  9. 适用于Resource ID (资源 ID)中,输入 ID 或 Amazon 资源名称 (ARN)。您选择的信息类型取决于您在上一步中选择的资源。

查看特定资源的其他 OpsItems

为了帮助您调查问题并提供问题上下文,您可以查看特定 AWS 资源的 OpsItems 列表。该列表显示每个 OpsItem 的状态、严重性和标题。该列表还包括指向每个 OpsItem 的深层链接,因此您可以快速打开它们以查看更多信息。

查看特定资源的 OpsItems 列表

  1. AWS Systems Manager 控制台https://console.aws.amazon.com/systems-manager/

  2. 在导航窗格中,选择OpsCenter

  3. 选择 OOpsItem ce ID 以打开详细信息页面。

  4. 选择相关资源详细信息选项卡。

  5. Expand此资源的其他 OpsItems 作

编辑 OpsItem 详细信息

这些区域有:OpsItem 详细信息部分包含有关 OpsItem 的信息,其中包括描述、标题、源、OpsItem ID 和状态(仅举几例)。


                    在控制台中查看 OpsItem ce 的详细信息

对于自动创建的 OpsItems,亚马逊 EventBridge 将填充职务, 和说明字段。您可以编辑标题描述字段,但无法编辑字段。

关于 OpsItem 状态

在编辑 OpsITEM 时,您可以指定状态。Status (状态) 列表包含以下选项:

状态 详细信息
Open

在系统中处于活动状态,但 能由工程师使用。

正在进行中

在系统中处于活动状态,并且可由工程师使用。

已解决

在系统中不活动,但在搜索和使用已解决选项 M 上的过滤器概述页. 您可以编辑已解决的 OpsItem 以将状态更改为打开或者正在进行中

您可以在摘要选项卡。有关更多信息,请参阅 查看 OpsCenter 摘要报告

关于 OpsItem 优先级

在编辑 OpsItem 时,您可以通过选择一个介于 1 和 5 之间的值来为该 OpsItem 选择优先级。我们建议您的组织确定每个优先级的含义以及每个优先级的相应服务级别协议。

关于“Notifications (通知)”字段

在编辑 OpsItem ARN ce 时,您可以在通知字段。通过指定 ARN,您可以确保所有利益相关者在编辑 OpsItem 时收到通知,包括状态更改。您可能会发现,为有关不同类型的 AWS 资源或不同环境的通知创建不同的 ARN 会很有用。Amazon SNS 主题必须位于与 OpsIce 位于同一 AWS 区域中。如果它们位于不同的区域中,系统将返回错误。有关更多信息,请参阅 Amazon Simple Notification Service 开发人员指南

重要

SNS 主题必须与 OpsItem 位于同一 AWS 区域中。如果它们位于不同的区域中,系统将返回错误。

编辑 OpsItem 详细信息

  1. AWS Systems Manager 控制台https://console.aws.amazon.com/systems-manager/

  2. 在导航窗格中,选择OpsCenter

  3. 选择 OOpsItem ce ID 以打开详细信息页面。

  4. OpsItem details (OpsItem 详细信息) 部分中,选择 Edit (编辑)

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

  6. 完成后,选择 Save

使用类似和相关的 OpsItems

这些区域有:SIMILOpsItems相关 OpsItems功能旨在帮助您调查操作问题,并提供有关问题范围的上下文。

这些区域有:SIMILOpsItems功能是可能与您相关或您可能感兴趣的系统生成的 OpsItems ce 列表。为了生成此列表,系统会扫描所有 OpsItems 的标题和描述并返回使用相似单词的 OpsItems。


                    查看相似的 OpsItems。

相关 OpsItems部分中,您最多可以为与当前 OpsItems 相关的其他 OpsItem 指定 10 个 ID。OpsItems 可通过不同的方式相关联,包括 OpsItems 之间的父子关系、根本原因或重复项。


                    查看相关的 OpsItems。

为了帮助您组织 OpsItems,您可以将一个 OpsItem 与另一个 OpsiteM 关联,以便它显示在相关 OpsItems部分。

添加相关的 OpsItem

  1. AWS Systems Manager 控制台https://console.aws.amazon.com/systems-manager/

  2. 在导航窗格中,选择OpsCenter

  3. 选择 OOpsItem ce ID 以打开详细信息页面。

  4. 相关 OpsItem部分,选择。Add

  5. 适用于OpsIm ID,请指定一个 ID。

  6. 选择添加

使用操作数据

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

重要

操作数据键不能 以下列单词开头:amazon、aws、amzn、ssm、/amazon、/aws、/amzn、/ssm。


                    查看 OpsItem 的操作数据。

您可以选择使数据可供账户中其他用户搜索,也可以限制搜索访问。可搜索数据意味着具有 “OpsItem 概述” 页面访问权限(由DescribeOpsItemsAPI 操作)可以查看和搜索指定的数据。不可搜索的数据仅可供有权访问 OpsItem(由 GetOpsItem API 操作提供)的用户查看。

将操作数据添加到 OOpsItem

  1. AWS Systems Manager 控制台https://console.aws.amazon.com/systems-manager/

  2. 在导航窗格中,选择OpsCenter

  3. 选择 OOpsItem ce ID 以打开详细信息页面。

  4. 展开任一操作数据

  5. 如果 OpsItem 不存在操作数据,则选择Add。如果 OpsItem 的操作数据,则选择Manage

  6. 对于 Key (密钥),指定一个或多个单词来帮助用户了解数据的用途。键不能以下列单词开头:amazon、aws、amzn、ssm、/amazon、/aws、/amzn、/ssm。

  7. 对于 Value (值),指定该数据。

  8. 选择 Save

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

注意

您可 OpsItems 使用操作数据运 OpsItems。在“搜索”框中,选择操作数据,然后输入 JSON 格式的键值/对。您必须使用以下格式输入键/值对:{"key":"key_name","value":"a_value"}

减少重复 OpsItems

OpsCenter 使用内置逻辑和可配置的重复数据删除字符串的组合来帮助避免创建重复的 OpsItems。重复数据删除内置逻辑可随时应用CreateOpsItem调用 API 操作。创建 OpsItem 时,Systems Manager 会根据重复数据删除字符串和启动 OpsItem 的资源创建和存储哈希值。当发出创建新的 OpsIteM 的请求时,系统检查新请求的重复数据删除字符串。如果此删除重复字符串存在匹配的哈希值,则 Systems Manager 不会创建新的 OpsItem。

请注意有关 OpsCenter 和重复数据删除的以下信息:

  • 重复数据删除字符串不区分大小写。如果系统在传入的 OpsItem 中找到基于重复数据删除字符串的匹配哈希值,则不管该字符串的大小写如何,都不会创建新的 OpsItem。

  • 如果系统在 OpsItem 中找到匹配的重复数据删除字符串,并且该 OpsIteom 的状态为Open/InProgress,则不会创建新的 OpsItem。如果在状态为的 OpsIce 中找到匹配的重复数据删除字符串Resolved,则系统会创建一个新的 OpsItem。

  • 如果系统在 OpsItem 中找到匹配的重复数据删除字符串,但资源不同,则系统会创建新的 OpsItem。

  • 如果未为传入的 OpsItem 指定重复数据消除字符串,则始终创建 OpsiteM。

配置重复数据删除字符串

OpsCenter 包含以下用于配置重复数据删除字符串的选项。

  • 编辑预配置重复数据删除字符串:每个 OpsItem ce 默认 EventBridge 规则都包含一个预配置的重复数据删除字符串。您可以在 EventBridge 中编辑这些重复数据删除字符串。

  • 手动指定重复删除字符串:您可以使用重复数据删除字符串,方法是使用复数据删除字符串字段或OperationalData参数时,您可以使用 AWS Command Line Interface (AWS CLI) 或适用于 Windows PowerShell 的 AWS 工具创建新 OpsItem。

系统创建 OpsItem 后,它将填充复数据删除字符串字段(如果指定了字符串)。下面是一个示例。


                        在 AWS AWS 管理控制台中查看 OpsItem ce 重复数据删除条目

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

此部分包含以下用于配置重复数据删除字符串的过程。

注意

有关在控制台中手动创建 OpsItem 时输入重复数据删除字符串的信息,请参阅手动创建 OpsItems

在 OpsCenter 默认事件 Bridge 规则中编辑重复数据删除字符串

使用以下过程可为以 OpsCenter 为目标的 EventBridge 规则指定重复数据删除字符串。

在 OpsItem ce 默认事件 Bridge 规则中编辑重复数据删除字符串的步骤

  1. 登录 AWS 管理控制台,并通过以下网址打开 Amazon EventBridge 控制台:https://console.aws.amazon.com/events/

  2. 在导航窗格中,选择 Rules (规则)

  3. 选择规则,然后选择编辑

  4. 选择目标部分,展开配置输入。在较低的输入变换器字段中,找到"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\"}"}}
  5. 编辑重复数据删除字符串,然后选择更新以完成规则的更新。

使用 AWS CLI 指定重复数据删除字符串

您可以在使用 AWS CLI 手动创建新的 OpsIteM 时指定重复数据删除字符串。使用 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"