使用重複資料刪除字串 - AWS Systems Manager

使用重複資料刪除字串

OpsCenter 使用內建邏輯和可設定重複資料刪除字串的組合,協助避免建立重複的 OpsItems。只要呼叫建立 OpsItem API 操作,即可套用重複資料刪除內建邏輯。建立 OpsItem 時,Systems Manager 會根據重複資料刪除字串和起始 OpsItem 的資源來建立會和存放雜湊。提出建立新 OpsItem 的請求時,系統會檢查新請求的重複資料刪除字串。如果此重複資料刪除字串存在相符的雜湊,則 Systems Manager 不會建立新 OpsItem。

請注意以下的 OpsCenter 和重複資料刪除資訊:

  • 重複資料刪除字串不區分大小寫。如果系統在傳入 OpsItem 中找到基於重複資料刪除字串的相符雜湊,無論重複資料刪除字串大小寫,都不會建立新的 OpsItem。

  • 如果系統在 OpsItem 中找到相符的重複資料刪除字串,且該 OpsItem 狀態為 Open/InProgress,則不建立新的 OpsItem。如果在狀態為 Resolved 的 OpsItem 中找到相符的重複資料刪除字串,則系統會建立新的 OpsItem。

  • 如果系統在 OpsItem 中找到相符的重複資料刪除字串,但資源不同,則系統會建立新的 OpsItem。

  • 如果未指定傳入 OpsItem 的重複資料刪除字串,然後一律建立 OpsItem。

設定重複資料刪除字串

OpsCenter 包含用於設定重複資料刪除字串的下列選項。

  • Edit preconfigured deduplication strings (編輯預先設定的重複資料刪除字串):每個 OpsItem 預設的 EventBridge 規則都包含預先設定的重複資料刪除字串。您可以在 EventBridge 中編輯這些重複資料刪除字串。

  • 手動指定重複資料刪除字串:您可以使用主控台中 Deduplication string (重複資料刪除) 欄位或藉由 AWS Command Line Interface (AWS CLI) 或 AWS Tools for Windows PowerShell 建立新 OpsItem 時的 OperationalData 參數,輸入重複資料刪除字串。

在系統建立 OpsItem 之後,它會填入 Deduplication string (重複資料刪除字串) 欄位,如已指定字串。範例如下。


                        檢視 AWS AWS Management Console 中的 OpsItem 重複資料刪除項目

建立 OpsItem 後,您就不能在該 OpsItem 中編輯或變更重複資料刪除字串。

本節包含下列設定重複資料刪除字串的程序。

注意

如需在主控台手動建立 OpsItem 時輸入重複資料刪除字串的詳細資訊,請參閱 手動建立 OpsItems

在 OpsCenter 預設的 EventBridge 規則中編輯重複資料刪除字串

使用下列處理程序指定以 OpsCenter 為目標之 EventBridge 規則的重複資料刪除字串。

在 OpsItem 預設的 EventBridge 規則中編輯重複資料刪除字串

  1. 登入 AWS Management Console,並在 https://console.aws.amazon.com/events/ 開啟 Amazon EventBridge 主控台。

  2. 在導覽窗格中,選擇 Rules (規則)。

  3. 選擇規則,然後選擇 Edit (編輯)。

  4. Select targets (選取目標) 區段中,展開 Configure input (設定輸入)。在較低的 Input transformer (輸入轉換器) 區段中,並找出 "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. 編輯重複資料刪除字串,然後選擇 Update (更新) 來完成規則的更新。

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