Managing duplicate OpsItems - Amazon Systems Manager
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Managing duplicate OpsItems

OpsCenter can receive multiple duplicate OpsItems for a single source from multiple Amazon Web Services. OpsCenter uses a combination of built-in logic and configurable deduplication strings to avoid creating duplicate OpsItems. Amazon Systems Manager applies deduplication built-in logic when the CreateOpsItem API operation is called.

Amazon Systems Manager uses the following deduplication logic:

  1. When creating the OpsItem, Systems Manager creates and stores a hash based on the deduplication string and the resource that initiated the OpsItem.

  2. When another request is made to create an OpsItem, the system checks the deduplication string of the new request.

  3. If a matching hash exists for this deduplication string, Systems Manager checks the status of the existing OpsItem. If the status of an existing OpsItem is open or in progress, the OpsItem is not created. If the existing OpsItem is resolved, Systems Manager creates a new OpsItem.

After you create an OpsItem, you can't edit or change the deduplication strings in that OpsItem.

To manage duplicate OpsItems, you can do the following:

Editing a deduplication string in a default EventBridge rule

Use the following procedure to specify a deduplication string for an EventBridge rule that targets OpsCenter.

To edit a deduplication string for an EventBridge rule
  1. Sign in to the Amazon Web Services Management Console and open the Amazon EventBridge console at

  2. In the navigation pane, choose Rules.

  3. Choose a rule, and then choose Edit.

  4. Go to the Select target(s) page.

  5. In the Additional settings section, choose Configure input transformer.

  6. In the Template box, locate the "operationalData": { "/aws/dedup" JSON entry and the deduplication strings that you want to edit.

    The deduplication string entry in EventBridge rules uses the following JSON format.

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

    Here is an example.

    "operationalData": { "/aws/dedup": {"type": "SearchableString","value": "{\"dedupString\":\"SSMOpsCenter-EBS-volume-performance-issue\"}"}}
  7. Edit the deduplication strings, and then choose Confirm.

  8. Choose Next.

  9. Choose Next.

  10. Choose Update rule.

Specifying a deduplication string using Amazon CLI

You can specify a deduplication string when you manually create a new OpsItem by using either the Amazon Systems Manager console or the Amazon CLI. For information about entering deduplication strings when you manually create an OpsItem in the console, see Create OpsItems manually. If you're using the Amazon CLI, you can enter the deduplication string for the OperationalData parameter. The parameter syntax uses JSON, as shown in the following example.

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

Here is an example command that specifies a deduplication string of 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-cn:sns:us-west-1:12345678:TestUser"
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-cn:sns:us-west-1:12345678:TestUser"