Verwalten von OpsItems-Duplikaten

OpsCenter kann mehrere OpsItems-Duplikate für eine einzelne Quelle von mehreren AWS-Services erhalten. OpsCenter verwendet eine Kombination aus integrierter Logik und konfigurierbaren Deduplizierungszeichenfolgen, um die Erstellung von OpsItems-Duplikaten zu vermeiden. AWS Systems Manager wendet die integrierte Deduplizierungslogik an, wenn der API-Vorgang OpsItem erstellen aufgerufen wird.

AWS Systems Manager verwendet die folgende Deduplizierungslogik:

1. Beim Erstellen des OpsItem erstellt und speichert Systems Manager einen Hash-Wert basierend auf der Deduplizierungszeichenfolge und der Ressource, durch die das OpsItem ausgelöst wurde.

2. Wenn eine weitere Anfrage zur Erstellung eines OpsItem gestellt wird, prüft das System die Deduplizierungszeichenfolge der neuen Anfrage.

3. Wenn ein übereinstimmender Hash-Wert für diese Deduplizierungszeichenfolge vorhanden ist, überprüft Systems Manager den Status des vorhandenen OpsItem. Wenn der Status eines vorhandenen OpsItem offen oder in Bearbeitung ist, wird das OpsItem nicht erstellt. Wenn das vorhandene OpsItem gelöst wird, erstellt Systems Manager ein neues OpsItem.

Nachdem Sie ein OpsItem erstellt haben, können Sie die Deduplizierungszeichenfolgen in diesem OpsItem nicht ändern.

Zur Verwaltung von OpsItems-Duplikaten können Sie wie folgt vorgehen:

• Bearbeiten Sie die Deduplizierungszeichenfolge für eine Amazon-EventBridge-Regel, die auf OpsCenter ausgerichtet ist. Weitere Informationen finden Sie unter Bearbeiten einer Deduplizierungszeichenfolge in einer Standard-EventBridge-Regel.

• Geben Sie eine Deduplizierungszeichenfolge an, wenn Sie ein neues OpsItem manuell erstellen. Weitere Informationen finden Sie unter Angeben einer Deduplizierungszeichenfolge mit der AWS CLI.

• Überprüfen und beheben Sie OpsItems-Duplikate mit betrieblichen Einblicken. Sie können Runbooks verwenden, um OpsItems-Duplikate zu lösen.

  Um Sie bei der Auflösung von OpsItems-Duplikaten zu unterstützen und die Anzahl der von einer Quelle erstellten OpsItems zu reduzieren, stellt Systems-Manager-Automation-Runbooks bereit. Weitere Informationen finden Sie unter Lösen von OpsItems-Duplikaten basierend auf Erkenntnissen.

Bearbeiten einer Deduplizierungszeichenfolge in einer Standard-EventBridge-Regel

Führen Sie die folgenden Schritte aus, um eine Deduplizierungszeichenfolge für eine EventBridge-Regel mit Ziel OpsCenter zu erstellen.

So bearbeiten Sie eine Deduplizierungszeichenfolge für eine EventBridge-Regel

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon EventBridge-Konsole unter https://console.aws.amazon.com/events/.

2. Wählen Sie im Navigationsbereich Rules aus.

3. Wählen Sie eine Regel und anschließend Edit (Bearbeiten) aus.

4. Rufen Sie die Seite Select target(s) (Ziel(e) auswählen) auf.

5. Wählen Sie im Bereich Additional settings (Zusätzliche Einstellungen) die Option Configure input transformer (Eingabetransformator konfigurieren).

6. Suchen Sie im Feld Template (Vorlage) den "operationalData": { "/aws/dedup" JSON-Eintrag und die Deduplizierungszeichenfolgen, die Sie bearbeiten möchten.

   Der Eintrag der Deduplizierungszeichenfolge in EventBridge-Regeln verwendet das folgenden JSON-Format.

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

   Ein Beispiel.

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

7. Bearbeiten Sie die Deduplizierungszeichenfolgen und wählen Sie dann Bestätigen aus.

8. Wählen Sie Next (Weiter).

9. Wählen Sie Next (Weiter).

10. Wählen Sie Update rule (Regel aktualisieren) aus.

Angeben einer Deduplizierungszeichenfolge mit der AWS CLI

Sie können eine Deduplizierungszeichenfolge angeben, wenn Sie ein neues OpsItem mit der AWS Systems Manager-Konsole oder der AWS CLI manuell erstellt haben. Weitere Informationen zum Eingeben von Deduplizierungszeichenfolgen, wenn Sie ein OpsItem manuell in der Konsole erstellen, finden Sie unter Manuelles Erstellen der OpsItems. Wenn Sie die AWS CLI verwenden, können Sie die Deduplizierungszeichenfolge für den OperationalData-Parameter eingeben. Die Parameter-Syntax verwendet JSON, wie im folgenden Beispiel gezeigt.

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

Es folgt ein Beispiel für einen Befehl, mit dem die Deduplizierungszeichenfolge disk full angegeben wird.

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"