• Das AWS Systems Manager CloudWatch Dashboard wird nach dem 30. April 2026 nicht mehr verfügbar sein. Kunden können weiterhin die CloudWatch Amazon-Konsole verwenden, um ihre CloudWatch Amazon-Dashboards anzusehen, zu erstellen und zu verwalten, so wie sie es heute tun. Weitere Informationen finden Sie in der [Amazon CloudWatch Dashboard-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Geben Sie einen Namen für den Benutzer ein und klicken Sie dann auf OpsItems
Nachdem Sie OpsCenter, ein Tool in AWS Systems Manager, eingerichtet und in Ihre AWS-Services integriert haben, erstellen die AWS-Services automatisch OpsItems anhand von Standardregeln, Ereignissen oder Warnungen.
Sie können die Status und Schweregrade der standardmäßigen Amazon EventBridge-Regeln anzeigen. Falls erforderlich, können Sie diese Regeln in Amazon EventBridge erstellen oder bearbeiten. Sie können auch Warnungen von Amazon CloudWatch anzeigen und Warnungen erstellen oder bearbeiten. Mit Regeln und Warnungen können Sie Ereignisse konfigurieren, für die Sie OpsItems automatisch generieren möchten.
Wenn das System ein OpsItem erstellt, befindet es sich im Status **Offen**. Sie können den Status zu **In Bearbeitung** ändern, wenn Sie mit der Untersuchung des OpsItem beginnen und in **Gelöst**, nachdem Sie das OpsItem behoben haben. Weitere Informationen zum Konfigurieren von Alarmen und Regeln in AWS-Services zum Erstellen von OpsItems und zum manuellen Erstellen von OpsItems finden Sie in den folgenden Themen.
**Topics**
+ [Zu erstellende EventBridge Regeln konfigurieren OpsItems](OpsCenter-automatically-create-OpsItems-2.md)
+ [Zu CloudWatch erstellende Alarme konfigurieren OpsItems](OpsCenter-create-OpsItems-from-CloudWatch-Alarms.md)
+ [Manuelles Erstellen der OpsItems](OpsCenter-manually-create-OpsItems.md)
# Zu erstellende EventBridge Regeln konfigurieren OpsItems
Wenn Amazon ein Ereignis EventBridge empfängt, erstellt es ein neues, das auf Standardregeln OpsItem basiert. Sie können eine Regel erstellen oder eine bestehende Regel bearbeiten, um sie OpsCenter als Ziel für ein EventBridge Ereignis festzulegen. Informationen zum Erstellen einer Event-Regel finden Sie unter [Creating a rule for an AWS-Service](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) im * EventBridge Amazon-Benutzerhandbuch*.
**So konfigurieren Sie eine EventBridge Regel zum Erstellen OpsItems in OpsCenter**
1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Wählen Sie im Navigationsbereich **Regeln** aus.
1. Auf der Seite **Regeln** wählen Sie für **Event Bus** die Option **Standard**.
1. Wählen Sie für **Regeln** eine Regel aus, indem Sie das Kontrollkästchen neben dessen Namen aktivieren.
1. Wählen Sie den Namen der Regel aus, um die Detailseite zu öffnen. Stellen Sie im Abschnitt **Regeldetails** sicher, dass der **Status** auf **Aktiviert** festgelegt ist.
**Anmerkung**
Falls erforderlich, können Sie den Status mit **Bearbeiten** in der oberen rechten Ecke der Seite aktualisieren.
1. Wählen Sie die Registerkarte **Ziele**.
1. Klicken Sie in der Registerkarte **Targets** (Ziele) auf **Edit** (Bearbeiten).
1. Wählen Sie für **Zieltypen** aus **AWS-Service**.
1. Für **Select a target** (Ziel auswählen), wählen Sie **Systems Manager OpsItem**.
1. Für viele Zieltypen ist die Erlaubnis EventBridge erforderlich, Ereignisse an das Ziel zu senden. In diesen Fällen EventBridge kann die AWS Identity and Access Management (IAM) -Rolle erstellt werden, die für die Ausführung Ihrer Regel erforderlich ist:
+ Um automatisch eine IAM-Rolle zu erstellen, wählen Sie **Eine neue Rolle für diese spezifische Ressource erstellen** aus.
+ Um eine IAM-Rolle zu verwenden, die Sie erstellt haben, um die EventBridge Erlaubnis zum Erstellen OpsItems zu erteilenOpsCenter, wählen Sie **Bestehende Rolle verwenden** aus.
1. Wählen Sie unter **Zusätzliche Einstellungen** für **Zieleingabe konfigurieren** die Option **Eingabe-Transformator** aus.
Sie können die Option **Eingabe-Transformer** verwenden, um eine Deduplizierungszeichenfolge und andere wichtige Informationen für OpsItems anzugeben, z. B. Titel und Schweregrad.
1. Wählen Sie **Configure input transformer** (Eingabetransformator konfigurieren).
1. Geben Sie unter **Zieleingabe-Transformator** für **Eingabepfad** die Werte an, die aus dem auslösenden Ereignis analysiert werden sollen. Um beispielsweise die Startzeit, die Endzeit und andere Details des Ereignisses zu analysieren, das die Regel auslöst, verwenden Sie den folgenden JSON.
```
{
"end-time": "$.detail.EndTime",
"failure-cause": "$.detail.cause",
"resources": "$.resources[0]",
"source": "$.detail.source",
"start-time": "$.detail.StartTime"
}
```
1. Geben Sie für **Template** (Vorlage) die Informationen an, die an das Ziel gesendet werden sollen. Verwenden Sie beispielsweise den folgenden JSON, um Informationen an OpsCenter zu übergeben. Die Informationen werden verwendet, um eine OpsItem zu erstellen.
**Anmerkung**
Wenn die Eingabevorlage im JSON-Format vorliegt, darf der Objektwert in der Vorlage keine Anführungszeichen enthalten. Beispielsweise dürfen die Werte für Ressourcen, Fehlerursache, Quelle, Startzeit und Endzeit nicht in Anführungszeichen stehen.
```
{
"title": "EBS snapshot copy failed",
"description": "CloudWatch Event Rule SSMOpsItems-EBS-snapshot-copy-failed was triggered. Your EBS snapshot copy has failed. See below for more details.",
"category": "Availability",
"severity": "2",
"source": "EC2",
"operationalData": {
"/aws/dedup": {
"type": "SearchableString",
"value": "{\"dedupString\":\"SSMOpsItems-EBS-snapshot-copy-failed\"}"
},
"/aws/automations": {
"value": "[ { \"automationType\": \"AWS:SSM:Automation\", \"automationId\": \"AWS-CopySnapshot\" } ]"
},
"failure-cause": {
"value":
},
"source": {
"value":
},
"start-time": {
"value":
},
"end-time": {
"value":
},
},
"resources": {
"value":
}
}
}
```
Weitere Informationen zu diesen Feldern finden Sie unter [Transformieren der Zieleingabe](https://docs.aws.amazon.com/eventbridge/latest/userguide/transform-input.html) im * EventBridge Amazon-Benutzerhandbuch*.
1. Wählen Sie **Bestätigen** aus.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie **Regel aktualisieren** aus.
Nachdem ein OpsItem aus einem Ereignis erstellt wurde, können Sie die Ereignisdetails einsehen. Öffnen Sie hierzu das OpsItem und blättern Sie nach unten zum Abschnitt **Private operational data (Private Betriebsdaten)**. Weitere Informationen zum Konfigurieren der Optionen in einem OpsItem finden Sie unter [Verwalten von OpsItems](OpsCenter-working-with-OpsItems.md).
# Zu CloudWatch erstellende Alarme konfigurieren OpsItems
Während der integrierten Einrichtung vonOpsCenter, einem Tool in AWS Systems Manager, ermöglichen Sie Amazon, automatisch CloudWatch auf der OpsItems Grundlage gängiger Alarme zu erstellen. Sie können eine Warnungerstellen oder eine vorhandenen Warnung bearbeiten, um OpsItems in OpsCenter zu erstellen.
CloudWatch erstellt eine neue serviceverknüpfte Rolle in AWS Identity and Access Management (IAM), wenn Sie einen zu erstellenden Alarm konfigurieren. OpsItems Der Name der neuen Rolle lautet `AWSServiceRoleForCloudWatchAlarms_ActionSSM`. Weitere Informationen zu CloudWatch serviceverknüpften Rollen finden Sie unter [Verwenden von serviceverknüpften Rollen für CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-service-linked-roles.html) im * CloudWatch Amazon-Benutzerhandbuch*.
Wenn ein CloudWatch Alarm ausgelöst wirdOpsItem, OpsItem wird **CloudWatch Alarm angezeigt - '*alarm\$1name*' befindet sich im Zustand ALARM**.
Um Details zu einem bestimmten OpsItem anzuzeigen, wählen Sie das OpsItem und dann die Registerkarte **Details zu zugehörigen Ressourcen** aus. Sie können OpsItems manuell ändern, um Details wie den Schweregrad oder die Kategorie zu ändern. Wenn Sie jedoch den Schweregrad oder die Kategorie einer Warnung bearbeiten, kann Systems Manager den Schweregrad oder die Kategorie von OpsItems, die bereits aus der Warnung erstellt wurden, nicht aktualisieren. Wenn ein Alarm einen ausgelöst hat OpsItem und Sie eine Deduplizierungszeichenfolge angegeben haben, erzeugt der Alarm keine zusätzliche Zeichenfolge, OpsItems auch wenn Sie den Alarm in bearbeiten. CloudWatch Wenn der in behoben OpsItem istOpsCenter, CloudWatch wird ein neuer erstellt. OpsItem
Weitere Informationen zur Konfiguration von CloudWatch Alarmen finden Sie in den folgenden Themen.
**Topics**
+ [Konfiguration eines zu erstellenden CloudWatch Alarms OpsItems (Konsole)](OpsCenter-creating-or-editing-existing-alarm-console.md)
+ [Konfiguration eines vorhandenen CloudWatch Alarms zur Erstellung OpsItems (programmgesteuert)](OpsCenter-configuring-an-existing-alarm-programmatically.md)
# Konfiguration eines zu erstellenden CloudWatch Alarms OpsItems (Konsole)
Sie können manuell einen Alarm erstellen oder einen vorhandenen Alarm aktualisieren, um ihn OpsItems von Amazon zu erstellen CloudWatch.
**Um einen CloudWatch Alarm zu erstellen und Systems Manager als Ziel dieses Alarms zu konfigurieren**
1. Führen Sie die Schritte 1—9 aus, wie im * CloudWatch Amazon-Benutzerhandbuch* unter [Erstellen eines CloudWatch Alarms basierend auf einem statischen Schwellenwert](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) beschrieben.
1. Wählen Sie im Bereich **Systems Manager Manager-Aktion** die Option **Systems Manager OpsCenter Manager-Aktion hinzufügen** aus.
1. Wählen Sie **OpsItems**.
1. Wählen Sie für **Schweregrad** eine Zahl von 1 bis 4 aus.
1. (Optional) Wählen Sie für **Kategorie** eine Kategorie für das OpsItem aus.
1. Führen Sie die Schritte 11—13 aus, wie unter [Erstellen eines CloudWatch Alarms auf der Grundlage eines statischen Schwellenwerts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) im * CloudWatch Amazon-Benutzerhandbuch beschrieben*.
1. Klicken Sie auf **Next (Weiter)** und schließen Sie den Assistenten ab.
**Bearbeiten eines vorhandenen Alarms und Konfigurieren des Systems Managers als Ziel dieses Alarms**
1. Öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)
1. Klicken Sie im Navigationsbereich auf **Alarms** (Alarme).
1. Wählen Sie den Alarm aus, wählen Sie dann **Actions** und anschließend **Edit**.
1. (Optional) Ändern Sie Einstellungen in den Bereichen **Metrics** (Metriken) und **Conditions** (Bedingungen) und wählen Sie dann **Next** (Weiter).
1. Wählen Sie im Bereich **Systems Manager** **Add Systems Manager OpsCenter action**.
1. Wählen Sie für **Schweregrad** eine Zahl aus.
**Anmerkung**
Der Schweregrad ist ein benutzerdefinierter Wert. Sie oder Ihre Organisation bestimmen, was jeder Schweregrad bedeutet und welche Service-Level-Vereinbarungen mit jedem Schweregrad verknüpft sind.
1. (Optional) Wählen Sie für **Category** eine Option aus.
1. Klicken Sie auf **Next (Weiter)** und schließen Sie den Assistenten ab.
# Konfiguration eines vorhandenen CloudWatch Alarms zur Erstellung OpsItems (programmgesteuert)
Sie können CloudWatch Amazon-Alarme so konfigurieren, dass sie OpsItems programmgesteuert erstellt werden, indem Sie AWS Command Line Interface (AWS CLI), AWS CloudFormation Vorlagen oder Java Codefragmente verwenden.
**Topics**
+ [Bevor Sie beginnen](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)
+ [Konfiguration der zu erstellenden CloudWatch Alarme OpsItems (AWS CLI)](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli)
+ [Konfiguration von CloudWatch Alarmen zum Erstellen oder Aktualisieren OpsItems (CloudFormation)](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation)
+ [Konfiguration von CloudWatch Alarmen zum Erstellen oder Aktualisieren OpsItems (Java)](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java)
## Bevor Sie beginnen
Wenn Sie eine vorhandenen Warnung programmgesteuert bearbeiten oder eine neuen Warnung erstellen, der OpsItems erstellt, müssen Sie einen Amazon-Ressourcennamen (ARN) angeben. Dieser ARN identifiziert Systems Manager OpsCenter als Ziel für OpsItems, die aus dem Alarm erstellt wurden. Sie können den ARN so anpassen, dass OpsItems, die aus dem Alarm erstellt wurden, bestimmte Informationen wie Schweregrad oder Kategorie enthalten. Jede ARN enthält die in der folgenden Tabelle beschriebenen Informationen.
****
| Parameter | Details |
| --- | --- |
| `Region` (Erforderlich) | Der AWS-Region Ort, an dem der Alarm existiert. Beispiel: `us-west-2`. Weitere Informationen zu AWS-Regionen , in denen Sie OpsCenter verwenden können, finden Sie unter [AWS Systems Manager -Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/ssm.html). |
| `account_ID` (Erforderlich) | Dieselbe AWS-Konto ID, mit der der Alarm erstellt wurde. Beispiel: `123456789012`. Der Konto-ID muss ein Doppelpunkt (`:`) und der Parameter `opsitem` folgen, wie in den folgenden Beispielen gezeigt. |
| `severity` (Erforderlich) | Ein benutzerdefinierter Schweregrad für OpsItems wurde aus dem Alarm erstellt. Zulässige Werte: `1`, `2`, `3`, `4` |
| `Category` (Optional) | Eine Kategorie für OpsItems, die aus dem Alarm erstellt wurde. Gültige Werte: `Availability`, `Cost`, `Performance`, `Recovery` und `Security`. |
Erstellen Sie den ARN mit der folgenden Syntax. Dieser ARN enthält nicht den optionalen `Category`-Parameter.
```
arn:aws:ssm:Region:account_ID:opsitem:severity
```
Im Folgenden sehen Sie ein Beispiel.
```
arn:aws:ssm:us-west-2:123456789012:opsitem:3
```
Verwenden Sie die folgende Syntax, um einen ARN zu erstellen, der den optionalen `Category`-Parameter verwendet.
```
arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name
```
Im Folgenden sehen Sie ein Beispiel.
```
arn:aws:ssm:us-west-2:123456789012:opsitem:3#CATEGORY=Security
```
## Konfiguration der zu erstellenden CloudWatch Alarme OpsItems (AWS CLI)
Für diesen Befehl müssen Sie einen ARN für den `alarm-actions`-Parameter angeben. Informationen zum Erstellen des ARN finden Sie unter [Bevor Sie beginnen](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Um einen zu CloudWatch erstellenden Alarm zu konfigurieren OpsItems (AWS CLI)**
1. Installieren und konfigurieren Sie AWS Command Line Interface (AWS CLI), falls Sie dies noch nicht getan haben.
Weitere Informationen finden Sie unter [Installieren oder Aktualisieren der neuesten Version von AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
1. Führen Sie den folgenden Befehl aus, um Informationen über den Alarm zu sammeln, den Sie konfigurieren möchten.
```
aws cloudwatch describe-alarms --alarm-names "alarm name"
```
1. Führen Sie den folgenden Befehl aus, um einen Alarm zu aktualisieren. Ersetzen Sie jeden *example resource placeholder* durch Ihre Informationen.
```
aws cloudwatch put-metric-alarm --alarm-name name \
--alarm-description "description" \
--metric-name name --namespace namespace \
--statistic statistic --period value --threshold value \
--comparison-operator value \
--dimensions "dimensions" --evaluation-periods value \
--alarm-actions arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name \
--unit unit
```
Ein Beispiel:
------
#### [ Linux & macOS ]
```
aws cloudwatch put-metric-alarm --alarm-name cpu-mon \
--alarm-description "Alarm when CPU exceeds 70 percent" \
--metric-name CPUUtilization --namespace AWS/EC2 \
--statistic Average --period 300 --threshold 70 \
--comparison-operator GreaterThanThreshold \
--dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 \
--alarm-actions arn:aws:ssm:us-east-1:123456789012:opsitem:3#CATEGORY=Security \
--unit Percent
```
------
#### [ Windows ]
```
aws cloudwatch put-metric-alarm --alarm-name cpu-mon ^
--alarm-description "Alarm when CPU exceeds 70 percent" ^
--metric-name CPUUtilization --namespace AWS/EC2 ^
--statistic Average --period 300 --threshold 70 ^
--comparison-operator GreaterThanThreshold ^
--dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 ^
--alarm-actions arn:aws:ssm:us-east-1:123456789012:opsitem:3#CATEGORY=Security ^
--unit Percent
```
------
## Konfiguration von CloudWatch Alarmen zum Erstellen oder Aktualisieren OpsItems (CloudFormation)
Dieser Abschnitt enthält AWS CloudFormation Vorlagen, mit denen Sie CloudWatch Alarme so konfigurieren können, dass sie automatisch erstellt oder aktualisiert werdenOpsItems. Für jede Vorlage muss ein ARN für den `AlarmActions`-Parameter angegeben werden. Informationen zum Erstellen des ARN finden Sie unter [Bevor Sie beginnen](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Metrischer Alarm** — Verwenden Sie die folgende CloudFormation Vorlage, um einen CloudWatch metrischen Alarm zu erstellen oder zu aktualisieren. Der in dieser Vorlage angegebene Alarm überwacht die Statusprüfungen der Amazon Elastic Compute Cloud (Amazon EC2)-Instance. Wenn der Alarm in den `ALARM`-Zustand wecchselt, erstellt es ein OpsItem in OpsCenter.
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Parameters" : {
"RecoveryInstance" : {
"Description" : "The EC2 instance ID to associate this alarm with.",
"Type" : "AWS::EC2::Instance::Id"
}
},
"Resources": {
"RecoveryTestAlarm": {
"Type": "AWS::CloudWatch::Alarm",
"Properties": {
"AlarmDescription": "Run a recovery action when instance status check fails for 15 consecutive minutes.",
"Namespace": "AWS/EC2" ,
"MetricName": "StatusCheckFailed_System",
"Statistic": "Minimum",
"Period": "60",
"EvaluationPeriods": "15",
"ComparisonOperator": "GreaterThanThreshold",
"Threshold": "0",
"AlarmActions": [ {"Fn::Join" : ["", ["arn:arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name", { "Ref" : "AWS::Partition" }, ":ssm:", { "Ref" : "AWS::Region" }, { "Ref" : "AWS:: AccountId" }, ":opsitem:3" ]]} ],
"Dimensions": [{"Name": "InstanceId","Value": {"Ref": "RecoveryInstance"}}]
}
}
}
}
```
**Zusammengesetzter Alarm** — Verwenden Sie die folgende CloudFormation Vorlage, um einen zusammengesetzten Alarm zu erstellen oder zu aktualisieren. Ein zusammengesetzter Alarm besteht aus mehreren Metrikalarmen. Wenn der Alarm in den `ALARM`-Zustand wecchselt, erstellt es ein OpsItem in OpsCenter.
```
"Resources":{
"HighResourceUsage":{
"Type":"AWS::CloudWatch::CompositeAlarm",
"Properties":{
"AlarmName":"HighResourceUsage",
"AlarmRule":"(ALARM(HighCPUUsage) OR ALARM(HighMemoryUsage)) AND NOT ALARM(DeploymentInProgress)",
"AlarmActions":"arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name",
"AlarmDescription":"Indicates that the system resource usage is high while no known deployment is in progress"
},
"DependsOn":[
"DeploymentInProgress",
"HighCPUUsage",
"HighMemoryUsage"
]
},
"DeploymentInProgress":{
"Type":"AWS::CloudWatch::CompositeAlarm",
"Properties":{
"AlarmName":"DeploymentInProgress",
"AlarmRule":"FALSE",
"AlarmDescription":"Manually updated to TRUE/FALSE to disable other alarms"
}
},
"HighCPUUsage":{
"Type":"AWS::CloudWatch::Alarm",
"Properties":{
"AlarmDescription":"CPUusageishigh",
"AlarmName":"HighCPUUsage",
"ComparisonOperator":"GreaterThanThreshold",
"EvaluationPeriods":1,
"MetricName":"CPUUsage",
"Namespace":"CustomNamespace",
"Period":60,
"Statistic":"Average",
"Threshold":70,
"TreatMissingData":"notBreaching"
}
},
"HighMemoryUsage":{
"Type":"AWS::CloudWatch::Alarm",
"Properties":{
"AlarmDescription":"Memoryusageishigh",
"AlarmName":"HighMemoryUsage",
"ComparisonOperator":"GreaterThanThreshold",
"EvaluationPeriods":1,
"MetricName":"MemoryUsage",
"Namespace":"CustomNamespace",
"Period":60,
"Statistic":"Average",
"Threshold":65,
"TreatMissingData":"breaching"
}
}
}
```
## Konfiguration von CloudWatch Alarmen zum Erstellen oder Aktualisieren OpsItems (Java)
Dieser Abschnitt enthält Java Codefragmente, mit denen Sie CloudWatch Alarme so konfigurieren können, dass sie automatisch erstellt oder aktualisiert werden. OpsItems Für jeden Ausschnitt müssen Sie einen ARN für den `validSsmActionStr`-Parameter angeben. Informationen zum Erstellen des ARN finden Sie unter [Bevor Sie beginnen](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Ein bestimmter Alarm** — Verwenden Sie den folgenden Java Codeausschnitt, um einen Alarm zu erstellen oder zu aktualisieren. CloudWatch Der in dieser Vorlage angegebene Alarm überwacht die Statusprüfungen der Amazon-EC2-Instance. Wenn der Alarm in den `ALARM`-Zustand wecchselt, erstellt es ein OpsItem in OpsCenter.
```
import com.amazonaws.services.cloudwatch.AmazonCloudWatch;
import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder;
import com.amazonaws.services.cloudwatch.model.ComparisonOperator;
import com.amazonaws.services.cloudwatch.model.Dimension;
import com.amazonaws.services.cloudwatch.model.PutMetricAlarmRequest;
import com.amazonaws.services.cloudwatch.model.PutMetricAlarmResult;
import com.amazonaws.services.cloudwatch.model.StandardUnit;
import com.amazonaws.services.cloudwatch.model.Statistic;
private void putMetricAlarmWithSsmAction() {
final AmazonCloudWatch cw =
AmazonCloudWatchClientBuilder.defaultClient();
Dimension dimension = new Dimension()
.withName("InstanceId")
.withValue(instanceId);
String validSsmActionStr = "arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name";
PutMetricAlarmRequest request = new PutMetricAlarmRequest()
.withAlarmName(alarmName)
.withComparisonOperator(
ComparisonOperator.GreaterThanThreshold)
.withEvaluationPeriods(1)
.withMetricName("CPUUtilization")
.withNamespace("AWS/EC2")
.withPeriod(60)
.withStatistic(Statistic.Average)
.withThreshold(70.0)
.withActionsEnabled(false)
.withAlarmDescription(
"Alarm when server CPU utilization exceeds 70%")
.withUnit(StandardUnit.Seconds)
.withDimensions(dimension)
.withAlarmActions(validSsmActionStr);
PutMetricAlarmResult response = cw.putMetricAlarm(request);
}
```
**Alle Alarme aktualisieren** — Verwenden Sie den folgenden Java Codeausschnitt, um alle CloudWatch Alarme in Ihrem System zu aktualisieren AWS-Konto , OpsItems wenn ein Alarm in den Status wechselt. `ALARM`
```
import com.amazonaws.services.cloudwatch.AmazonCloudWatch;
import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder;
import com.amazonaws.services.cloudwatch.model.DescribeAlarmsRequest;
import com.amazonaws.services.cloudwatch.model.DescribeAlarmsResult;
import com.amazonaws.services.cloudwatch.model.MetricAlarm;
private void listMetricAlarmsAndAddSsmAction() {
final AmazonCloudWatch cw = AmazonCloudWatchClientBuilder.defaultClient();
boolean done = false;
DescribeAlarmsRequest request = new DescribeAlarmsRequest();
String validSsmActionStr = "arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name";
while(!done) {
DescribeAlarmsResult response = cw.describeAlarms(request);
for(MetricAlarm alarm : response.getMetricAlarms()) {
// assuming there are no alarm actions added for the metric alarm
alarm.setAlarmActions(ImmutableList.of(validSsmActionStr));
}
request.setNextToken(response.getNextToken());
if(response.getNextToken() == null) {
done = true;
}
}
}
```
# Manuelles Erstellen der OpsItems
Wenn Sie ein Betriebsproblem feststellen, können Sie in OpsCenter, einem Tool in AWS Systems Manager, manuell ein OpsItem erstellen, um das Problem zu verwalten und zu lösen.
Wenn Sie eine OpsCenter für eine kontoübergreifende Verwaltung einrichten, kann ein delegierter Administrator von Systems Manager oder einem AWS Organizations-Verwaltungskonto OpsItems für Mitgliederkonten erstellen. Weitere Informationen finden Sie unter [(Optional) Manuelle Einrichtung von OpsCenter für die zentrale kontenübergreifende Verwaltung von OpsItems](OpsCenter-getting-started-multiple-accounts.md).
Sie können OpsItems mit der AWS Systems Manager-Konsole, der AWS Command Line Interface (AWS CLI), oder der AWS Tools for Windows PowerShell erstellen.
**Topics**
+ [Manuelles Erstellen von OpsItems (Konsole)](OpsCenter-creating-OpsItems-console.md)
+ [Manuelles Erstellen von OpsItems (AWS CLI)](OpsCenter-creating-OpsItems-CLI.md)
+ [Manuelles Erstellen von OpsItems (PowerShell)](OpsCenter-creating-OpsItems-Powershell.md)
# Manuelles Erstellen von OpsItems (Konsole)
Sie können manuell OpsItems mit der AWS Systems Manager Konsole erstellen. Wenn Sie ein OpsItem erstellen, wird es in Ihrem OpsCenter-Konto angezeigt. Wenn Sie OpsCenter für die kontoübergreifende Verwaltung einrichten, bietet OpsCenter dem delegierten Administrator oder dem Verwaltungskonto die Möglichkeit, OpsItems für ausgewählte Mitgliedskonten zu erstellen. Weitere Informationen finden Sie unter [(Optional) Manuelle Einrichtung von OpsCenter für die zentrale kontenübergreifende Verwaltung von OpsItems](OpsCenter-getting-started-multiple-accounts.md).
**Um eine OpsItem mit der AWS Systems Manager Konsole zu erstellen**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **OpsCenter** aus.
1. Wählen Sie **Create (Erstellen)OpsItem** aus. Wenn diese Schaltfläche nicht angezeigt wird, wählen Sie die Registerkarte **OpsItems** und dann **Create OpsItem** aus.
1. (Optional) Wählen Sie **Anderes Konto** und dann das Konto aus, für das Sie das OpsItem erstellen möchten.
**Anmerkung**
Dieser Schritt ist erforderlich, wenn Sie OpsItems für ein Mitgliedskonto erstellen.
1. Geben Sie unter **Title (Titel)** einen aussagekräftigen Namen ein, um den Zweck des OpsItem zu verstehen.
1. Geben Sie unter **Source (Quelle)** den Typ der betroffenen AWS -Ressource oder andere Informationen der Quelle ein, damit Benutzer die Herkunft des OpsItem verstehen.
**Anmerkung**
Es ist nicht möglich, das Feld **Source (Quelle)** nach dem Erstellen des OpsItem zu bearbeiten.
1. (Optional) Wählen Sie unter **Priority (Priorität)** die Priorität aus.
1. (Optional) Wählen Sie für **Severity (Schweregrad)** den Schweregrad aus.
1. (Optional) Wählen Sie für **Category (Kategorie)** eine Kategorie aus.
1. Geben Sie unter **Description (Beschreibung)** Informationen zu diesem OpsItem ein, einschließlich der Schritte, um das Problem zu reproduzieren (falls zutreffend).
**Anmerkung**
Die Konsole unterstützt die meisten Markdown-Formatierungen im OpsItem Beschreibungsfeld. Weitere Informationen finden Sie unter [Verwenden von Markdown in der Konsole](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html) im Einsteiger-Handbuch *Erste Schritte mit der AWS-Managementkonsole .*
1. Geben Sie für **Deduplizierungszeichenfolge** Wörter ein, die das System bei der Überprüfung auf OpsItems-Duplikate überprüfen soll. Weitere Informationen zu Deduplizierungszeichenfolgen finden Sie unter [Verwalten von OpsItems-Duplikaten](OpsCenter-working-deduplication.md).
1. (Optional) Geben Sie unter **Benachrichtigungen** den Amazon-Ressourcenname (ARN) des Amazon-SNS-Themas an, an das Benachrichtigungen gesendet werden sollen, wenn dieses OpsItem aktualisiert wird. Sie müssen einen Amazon SNS SNS-ARN angeben, der mit dem AWS-Region OpsItem identisch ist.
1. (Optional) Wählen Sie unter **Zugehörige Ressourcen** die Option **Hinzufügen** zur Angabe der ID oder des ARN der betroffenen Ressource und aller zugehörigen Ressourcen.
1. Wählen Sie **ErstellenOpsItem** aus.
Bei Erfolg wird auf der Seite das OpsItem angezeigt. Wenn ein delegiertes Administrator- oder Verwaltungskonto ein OpsItem für ausgewählte Mitglieder erstellt, werden die neuen OpsItems im OpsCenter des Administrator- und Mitgliedskontos angezeigt. Weitere Informationen zum Konfigurieren der Optionen in einem OpsItem finden Sie unter [Verwalten von OpsItems](OpsCenter-working-with-OpsItems.md).
# Manuelles Erstellen von OpsItems (AWS CLI)
Im folgenden Verfahren wird das Erstellen eines OpsItem über die AWS Command Line Interface (AWS CLI) beschrieben.
**Um einen zu erstellen OpsItem mit dem AWS CLI**
1. Installieren und konfigurieren Sie AWS Command Line Interface (AWS CLI), falls Sie dies noch nicht getan haben.
Weitere Informationen finden Sie unter [Installieren oder Aktualisieren der neuesten Version von AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
1. Öffnen Sie den AWS CLI und führen Sie den folgenden Befehl aus, um einen zu erstellenOpsItem. Ersetzen Sie jeden *example resource placeholder* durch Ihre Informationen.
```
aws ssm create-ops-item \
--title "Descriptive_title" \
--description "Information_about_the_issue" \
--priority Number_between_1_and_5 \
--source Source_of_the_issue \
--operational-data Up_to_20_KB_of_data_or_path_to_JSON_file \
--notifications Arn="SNS_ARN_in_same_Region" \
--tags "Key=key_name,Value=a_value"
```
**Angabe von Betriebsdaten aus einer Datei**
Wenn Sie ein OpsItem erstellen, können Sie Betriebsdaten aus einer Datei angeben. Die Datei muss eine JSON-Datei sein, und der Inhalt der Datei muss das folgende Format aufweisen.
```
{
"key_name": {
"Type": "SearchableString",
"Value": "Up to 20 KB of data"
}
}
```
Ein Beispiel.
```
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 2 ^
--source ec2 ^
--operational-data file:///Users/TestUser1/Desktop/OpsItems/opsData.json ^
--notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^
--tags "Key=EC2,Value=Production"
```
**Anmerkung**
Informationen zur Eingabe von JSON-formatierten Parametern in der Befehlszeile verschiedener lokaler Betriebssysteme finden Sie unter [Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) im *AWS Command Line Interface -Benutzerhandbuch*.
Das System gibt unter anderem folgende Informationen zurück
```
{
"OpsItemId": "oi-1a2b3c4d5e6f"
}
```
1. Führen Sie den folgenden Befehl aus, um Details zu dem von Ihnen erstellten OpsItem anzuzeigen.
```
aws ssm get-ops-item --ops-item-id ID
```
Das System gibt unter anderem folgende Informationen zurück
```
{
"OpsItem": {
"CreatedBy": "arn:aws:iam::12345678:user/TestUser",
"CreatedTime": 1558386334.995,
"Description": "Log clean up may have failed which caused the disk to be full",
"LastModifiedBy": "arn:aws:iam::12345678:user/TestUser",
"LastModifiedTime": 1558386334.995,
"Notifications": [
{
"Arn": "arn:aws:sns:us-west-1:12345678:TestUser"
}
],
"Priority": 2,
"RelatedOpsItems": [],
"Status": "Open",
"OpsItemId": "oi-1a2b3c4d5e6f",
"Title": "EC2 instance disk full",
"Source": "ec2",
"OperationalData": {
"EC2": {
"Value": "12345",
"Type": "SearchableString"
}
}
}
}
```
1. Führen Sie den folgenden Befehl aus, um das OpsItem zu aktualisieren. Dieser Befehl ändert den Status von `Open` (Standardwert) zu `InProgress`.
```
aws ssm update-ops-item --ops-item-id ID --status InProgress
```
Der Befehl hat keine Ausgabe.
1. Führen Sie den folgenden Befehl erneut aus, um zu überprüfen, ob der Status zu `InProgress` geändert wurde.
```
aws ssm get-ops-item --ops-item-id ID
```
## Beispiele für die Erstellung eines OpsItem
Die folgenden Beispiele zeigen, wie Sie ein OpsItem mit dem Linux-Verwaltungsportal, macOS oder Windows Server erstellen und verwalten.
**Linux-Verwaltungsportal oder macOS**
Der folgende Befehl erstellt ein OpsItem, wenn eine Instance-Festplatte von Amazon Elastic Compute Cloud (Amazon EC2) voll ist.
```
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 2 \
--source ec2 \
--operational-data '{"EC2":{"Value":"12345","Type":"SearchableString"}}' \
--notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" \
--tags "Key=EC2,Value=ProductionServers"
```
Der folgende Befehl verwendet den `/aws/resources`-Schlüssel in `OperationalData`, um ein OpsItem mit einer Amazon-DynamoDB-bezogenen Ressource zu erstellen.
```
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 2 \
--source ec2 \
--operational-data '{"/aws/resources":{"Value":"[{\"arn\": \"arn:aws:dynamodb:us-west-2:12345678:table/OpsItems\"}]","Type":"SearchableString"}}' \
--notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"
```
Der folgende Befehl verwendet den `/aws/automations`-Schlüssel in `OperationalData`, um ein OpsItem zu erstellen, das das `AWS-ASGEnterStandby`-Dokument als zugeordnetes Automation-Runbook angibt.
```
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 2 \
--source ec2 \
--operational-data '{"/aws/automations":{"Value":"[{\"automationId\": \"AWS-ASGEnterStandby\", \"automationType\": \"AWS::SSM::Automation\"}]","Type":"SearchableString"}}' \
--notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"
```
**Windows**
Der folgende Befehl erstellt ein OpsItem wenn eine Amazon Relational Database Service (Amazon RDS)-Instance nicht reagiert.
```
aws ssm create-ops-item ^
--title "RDS instance not responding" ^
--description "RDS instance not responding to ping" ^
--priority 1 ^
--source RDS ^
--operational-data={\"RDS\":{\"Value\":\"abcd\",\"Type\":\"SearchableString\"}} ^
--notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^
--tags "Key=RDS,Value=ProductionServers"
```
Der folgende Befehl verwendet den `/aws/resources`-Schlüssel in `OperationalData`, um ein OpsItem mit einer Amazon-EC2-Instance-bezogenen Ressource zu erstellen.
```
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 2 ^
--source ec2 ^
--operational-data={\"/aws/resources\":{\"Value\":\"[{\\"""arn\\""":\\"""arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\\"""}]\",\"Type\":\"SearchableString\"}}
```
Der folgende Befehl verwendet den `/aws/automations`-Schlüssel in `OperationalData`, um ein OpsItem zu erstellen, das das `AWS-RestartEC2Instance`-Runbook als zugeordnetes Automation-Runbook angibt.
```
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 2 ^
--source ec2 ^
--operational-data={\"/aws/automations\":{\"Value\":\"[{\\"""automationId\\""":\\"""AWS-RestartEC2Instance\\”"",\\"""automationType\\""":\\"""AWS::SSM::Automation\\"""}]\",\"Type\":\"SearchableString\"}}
```
# Manuelles Erstellen von OpsItems (PowerShell)
Im folgenden Verfahren wird das Erstellen eines OpsItem über AWS Tools for Windows PowerShell beschrieben.
**Um eine OpsItem zu erstellen AWS Tools for Windows PowerShell**
1. Öffnen Sie den folgenden Befehl AWS Tools for Windows PowerShell und führen Sie ihn aus, um Ihre Anmeldeinformationen anzugeben.
```
Set-AWSCredentials –AccessKey key-name –SecretKey key-name
```
1. Führen Sie den folgenden Befehl aus, um den AWS-Region für Ihre PowerShell Sitzung festzulegen.
```
Set-DefaultAWSRegion -Region Region
```
1. Führen Sie den folgenden Befehl aus, um ein neues OpsItem zu erstellen. Ersetzen Sie jeden *example resource placeholder* durch Ihre Informationen. Dieser Befehl gibt ein Systems Manager Automation-Runbook zum Beheben dieses OpsItem an.
```
$opsItem = New-Object Amazon.SimpleSystemsManagement.Model.OpsItemDataValue
$opsItem.Type = [Amazon.SimpleSystemsManagement.OpsItemDataType]::SearchableString
$opsItem.Value = '[{\"automationId\":\"runbook_name\",\"automationType\":\"AWS::SSM::Automation\"}]'
$newHash = @{" /aws/automations"=[Amazon.SimpleSystemsManagement.Model.OpsItemDataValue]$opsItem}
New-SSMOpsItem `
-Title "title" `
-Description "description" `
-Priority priority_number `
-Source AWS_service `
-OperationalData $newHash
```
Im Erfolgsfall gibt der Befehl die ID des neuen OpsItem aus.
Das folgende Beispiel gibt den Amazon-Ressourcennamen (ARN) einer beeinträchtigten Amazon Elastic Compute Cloud (Amazon EC2)-Instance an.
```
$opsItem = New-Object Amazon.SimpleSystemsManagement.Model.OpsItemDataValue
$opsItem.Type = [Amazon.SimpleSystemsManagement.OpsItemDataType]::SearchableString
$opsItem.Value = '[{\"arn\":\"arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\"}]'
$newHash = @{" /aws/resources"=[Amazon.SimpleSystemsManagement.Model.OpsItemDataValue]$opsItem}
New-SSMOpsItem -Title "EC2 instance disk full still" -Description "Log clean up may have failed which caused the disk to be full" -Priority 2 -Source ec2 -OperationalData $newHash
```