OpsItems の重複を管理する - AWS Systems Manager

OpsItems の重複を管理する

OpsCenter は、1 つのソースに対して複数の AWS のサービス から複数の重複する OpsItems を受け取ることができます。OpsCenter は、組み込みロジックと設定可能な重複排除文字列の組み合わせを使用して、重複する OpsItems を作成しないようにします。AWS Systems Manager は、Create OpsItem API オペレーションが呼び出されると、重複排除の組み込みロジックを適用します。

AWS Systems Manager は、次の重複排除ロジックを使用します。

  1. OpsItem を作成するとき、Systems Manager は重複排除文字列と OpsItem を開始したリソースに基づいてハッシュを作成して保存します。

  2. OpsItem を作成するリクエストを受け取ると、システムは新しいリクエストの重複排除文字列をチェックします。

  3. この重複排除文字列に一致するハッシュが存在する場合、Systems Manager は既存の OpsItem をチェックします。既存の OpsItem のステータスが未解決または進行中の場合、OpsItem は作成されません。既存の OpsItem が解決されると、Systems Manager は新しい OpsItem を作成します。

OpsItem を作成した後、その OpsItem で重複排除文字列を編集または変更することはできません

OpsItems の重複を管理するには、次の操作を行います。

デフォルトの EventBridge ルールの重複排除文字列を編集する

OpsCenter をターゲットとする EventBridge ルールに重複排除文字列を指定するには、次の手順を使用します。

デフォルトの EventBridge ルールの重複排除文字列を編集するには
  1. AWS Management Console にサインインし、Amazon EventBridge コンソール (https://console.aws.amazon.com/events/) を開きます。

  2. ナビゲーションペインで [ルール] を選択します。

  3. ルールを選択し、[編集] を選択します。

  4. [Select target(s)] (ターゲットの選択) ページに移動します。

  5. [Additional settings] (追加設定) セクションの [Configure input transformer] (入力トランスフォーマーの設定) を選択します。

  6. [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\"}"}}
  7. 重複排除文字列を編集し、[確認] をクリックします。

  8. [Next] を選択します。

  9. [Next] を選択します。

  10. [ルールの更新] を選択します。

AWS CLI を使用して重複排除文字列を指定する

重複排除文字列は、AWS Systems Manager コンソールまたは AWS CLI のいずれかを使用して、新しい OpsItem を手動で作成するときに指定することができます。コンソールで OpsItem を手動で作成するときに重複排除文字列を入力する方法については、「OpsItems を手動で作成する」を参照してください。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"