

• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola CloudWatch dasbor Amazon mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat [dokumentasi CloudWatch Dasbor Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Buat OpsItems
<a name="OpsCenter-create-OpsItems"></a>

Setelah Anda mengatur OpsCenter, alat di AWS Systems Manager, dan mengintegrasikannya dengan Anda Layanan AWS, Anda Layanan AWS secara otomatis membuat OpsItems berdasarkan aturan default, peristiwa, atau alarm. 

Anda dapat melihat status dan tingkat keparahan EventBridge aturan Amazon default. Jika diperlukan, Anda dapat membuat atau mengedit aturan ini dari Amazon EventBridge. Anda juga dapat melihat alarm dari Amazon CloudWatch, dan membuat atau mengedit alarm. Menggunakan aturan dan alarm, Anda dapat mengonfigurasi acara yang ingin Anda hasilkan OpsItems secara otomatis.

Ketika sistem membuat OpsItem, itu dalam status **Terbuka**. Anda dapat mengubah status menjadi **Sedang berlangsung** saat Anda memulai penyelidikan OpsItem dan untuk **Diselesaikan** setelah Anda memperbaiki OpsItem. Untuk informasi selengkapnya tentang cara mengonfigurasi alarm dan aturan Layanan AWS untuk membuat OpsItems dan cara membuat OpsItems secara manual, lihat topik berikut. 

**Topics**
+ [Konfigurasikan EventBridge aturan untuk membuat OpsItems](OpsCenter-automatically-create-OpsItems-2.md)
+ [CloudWatch Konfigurasikan alarm untuk membuat OpsItems](OpsCenter-create-OpsItems-from-CloudWatch-Alarms.md)
+ [Buat OpsItems secara manual](OpsCenter-manually-create-OpsItems.md)

# Konfigurasikan EventBridge aturan untuk membuat OpsItems
<a name="OpsCenter-automatically-create-OpsItems-2"></a>

Ketika Amazon EventBridge menerima acara, itu membuat yang baru OpsItem berdasarkan aturan default. Anda dapat membuat aturan atau mengedit aturan yang ada untuk ditetapkan OpsCenter sebagai target EventBridge acara. Untuk informasi tentang cara membuat aturan acara, lihat [Membuat aturan untuk Layanan AWS](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) di *Panduan EventBridge Pengguna Amazon*.

**Untuk mengkonfigurasi EventBridge aturan untuk dibuat OpsItems di OpsCenter**

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Di panel navigasi, pilih **Aturan**.

1. Pada halaman **Aturan**, untuk **bus Acara**, pilih **default**.

1. Untuk **Aturan**, pilih aturan dengan memilih kotak centang di sebelah namanya.

1. Pilih nama aturan untuk membuka halaman detailnya. Dalam **detail Aturan**, verifikasi bahwa **Status** disetel ke **Diaktifkan**.
**catatan**  
Jika diperlukan, Anda dapat memperbarui status menggunakan **Edit** di sudut kanan atas halaman.

1. Pilih tab**Target**. 

1. Di tab**Targets**, pilih **Edit**.

1. Untuk **jenis Target**, pilih **Layanan AWS**.

1. Untuk **Pilih target**, pilih **Systems Manager OpsItem**.

1. Untuk banyak jenis target, EventBridge perlu izin untuk mengirim acara ke target. Dalam kasus ini, EventBridge dapat membuat peran AWS Identity and Access Management (IAM) yang diperlukan agar aturan Anda berjalan: 
   + Untuk membuat peran IAM secara otomatis, pilih **Buat peran baru untuk sumber daya khusus ini**.
   + Untuk menggunakan peran IAM yang Anda buat untuk memberikan EventBridge izin untuk membuat OpsItemsOpsCenter, pilih **Gunakan peran yang ada**.

1. Di **Pengaturan tambahan**, untuk **Konfigurasi input target**, pilih **Input Transformer**.

   Anda dapat menggunakan opsi **Transformator input** untuk menentukan string deduplikasi dan informasi penting lainnyaOpsItems, seperti judul dan tingkat keparahan.

1. Pilih **Konfigurasi transformator input**.

1. Di **Transformator input target**, untuk **jalur Input**, tentukan nilai yang akan diuraikan dari peristiwa pemicu. Misalnya, untuk mengurai waktu mulai, waktu akhir, dan detail lainnya dari peristiwa yang memicu aturan, gunakan JSON berikut.

   ```
   {
       "end-time": "$.detail.EndTime",
       "failure-cause": "$.detail.cause",
       "resources": "$.resources[0]",
       "source": "$.detail.source",
       "start-time": "$.detail.StartTime"
   }
   ```

1. Untuk **Template**, tentukan informasi yang akan dikirim ke target. Misalnya, gunakan JSON berikut untuk meneruskan informasi keOpsCenter. Informasi tersebut digunakan untuk membuatOpsItem.
**catatan**  
Jika template input dalam format JSON, maka nilai objek dalam template tidak dapat menyertakan tanda kutip. Misalnya, nilai untuk sumber daya, penyebab kegagalan, sumber, waktu mulai, dan waktu akhir tidak dapat dalam tanda kutip. 

   ```
   {
       "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": <failure-cause>
           },
           "source": {
               "value": <source>
           },
           "start-time": {
               "value": <start-time>
           },
           "end-time": {
               "value": <end-time>
           },
            },
           "resources": {
               "value": <resources>
           }
       }
   }
   ```

   Untuk informasi selengkapnya tentang bidang ini, lihat [Mengubah input target](https://docs.aws.amazon.com/eventbridge/latest/userguide/transform-input.html) di *Panduan EventBridge Pengguna Amazon*.

1. Pilih **Konfirmasi**.

1. Pilih **Berikutnya**.

1. Pilih **Berikutnya**.

1. Pilih **Perbarui aturan**.

Setelah OpsItem dibuat dari suatu acara, Anda dapat melihat detail acara dengan membuka OpsItem dan menggulir ke bawah ke bagian **Data operasional pribadi**. Untuk informasi tentang cara mengkonfigurasi opsi diOpsItem, lihat[Kelola OpsItems](OpsCenter-working-with-OpsItems.md).

# CloudWatch Konfigurasikan alarm untuk membuat OpsItems
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms"></a>

Selama penyiapan terintegrasiOpsCenter, alat di AWS Systems Manager, Anda mengaktifkan Amazon CloudWatch untuk secara otomatis membuat OpsItems berdasarkan alarm umum. Anda dapat membuat alarm atau mengedit alarm yang ada untuk membuat OpsItemsOpsCenter. 

CloudWatch membuat peran terkait layanan baru di AWS Identity and Access Management (IAM) saat Anda mengonfigurasi alarm untuk dibuat. OpsItems Peran baru ini bernama `AWSServiceRoleForCloudWatchAlarms_ActionSSM`. *Untuk informasi selengkapnya tentang peran CloudWatch terkait layanan, lihat [Menggunakan peran terkait layanan di Panduan Pengguna CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-service-linked-roles.html) Amazon. CloudWatch * 

Ketika CloudWatch alarm menghasilkanOpsItem, OpsItem menampilkan **CloudWatch alarm - '*alarm\$1name*' dalam keadaan ALARM**. 

Untuk melihat detail tentang spesifikOpsItem, pilih tab Detail sumber daya terkait, lalu pilih tab **Detail sumber daya terkait**. OpsItem Anda dapat mengedit secara manual OpsItems untuk mengubah detail, seperti tingkat keparahan atau kategori. Namun, saat Anda mengedit tingkat keparahan atau kategori alarm, Systems Manager tidak dapat memperbarui tingkat keparahan atau kategori OpsItems yang sudah dibuat dari alarm. Jika alarm membuat OpsItem dan jika Anda menentukan string deduplikasi, alarm tidak akan membuat tambahan OpsItems bahkan jika Anda mengedit alarm. CloudWatch Jika OpsItem diselesaikan diOpsCenter, CloudWatch akan membuat yang baruOpsItem.

Untuk informasi selengkapnya tentang mengonfigurasi CloudWatch alarm, lihat topik berikut.

**Topics**
+ [Mengkonfigurasi CloudWatch alarm untuk membuat OpsItems (konsol)](OpsCenter-creating-or-editing-existing-alarm-console.md)
+ [Mengkonfigurasi CloudWatch alarm yang ada untuk membuat OpsItems (secara terprogram)](OpsCenter-configuring-an-existing-alarm-programmatically.md)

# Mengkonfigurasi CloudWatch alarm untuk membuat OpsItems (konsol)
<a name="OpsCenter-creating-or-editing-existing-alarm-console"></a>

Anda dapat membuat alarm secara manual atau memperbarui alarm yang ada untuk dibuat OpsItems dari Amazon CloudWatch.

**Untuk membuat CloudWatch alarm dan mengkonfigurasi Systems Manager sebagai target alarm itu**

1. Selesaikan langkah 1—9 seperti yang ditentukan dalam [Membuat CloudWatch alarm berdasarkan ambang batas statis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) di * CloudWatch Panduan Pengguna Amazon*.

1. Di bagian **tindakan Systems Manager**, pilih ** OpsCenter tindakan Add Systems Manager**.

1. Pilih **OpsItems**.

1. Untuk **Keparahan**, pilih dari 1 hingga 4. 

1. (Opsional) Untuk **Kategori**, pilih kategori untukOpsItem.

1. Selesaikan langkah 11—13 seperti yang ditentukan dalam [Membuat CloudWatch alarm berdasarkan ambang batas statis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) di * CloudWatch Panduan Pengguna Amazon*.

1. Pilih **Selanjutnya** dan selesaikan wizard.

**Untuk mengedit alarm yang ada dan mengkonfigurasi Systems Manager sebagai target alarm tersebut**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Di panel navigasi, pilih **Alarm**.

1. Pilih alarm, dan kemudian pilih **Tindakan**, **Edit**.

1. (Opsional) Ubah pengaturan di bagian **Metrik** dan **Kondisi**, dan kemudian pilih **Selanjutnya**.

1. Di bagian **Systems Manager**, pilih **OpsCentertindakan Add Systems Manager**. 

1. Untuk **Kepelikan**, pilih sebuah angka. 
**catatan**  
Kepelikan adalah nilai yang ditentukan pengguna. Anda atau organisasi Anda menentukan arti setiap nilai kepelikan dan perjanjian tingkat layanan yang terkait dengan setiap kepelikan.

1. (Opsional) Untuk **Kategori**, pilih sebuah opsi. 

1. Pilih **Selanjutnya** dan selesaikan wizard.

# Mengkonfigurasi CloudWatch alarm yang ada untuk membuat OpsItems (secara terprogram)
<a name="OpsCenter-configuring-an-existing-alarm-programmatically"></a>

Anda dapat mengonfigurasi CloudWatch alarm Amazon untuk membuat OpsItems secara terprogram menggunakan AWS Command Line Interface (AWS CLI), AWS CloudFormation template, atau Java cuplikan kode.

**Topics**
+ [Sebelum Anda mulai](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)
+ [Mengkonfigurasi CloudWatch alarm untuk membuat OpsItems ()AWS CLI](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli)
+ [Mengkonfigurasi CloudWatch alarm untuk membuat atau memperbarui OpsItems () CloudFormation](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation)
+ [Mengkonfigurasi CloudWatch alarm untuk membuat atau memperbarui OpsItems () Java](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java)

## Sebelum Anda mulai
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin"></a>

Jika Anda mengedit alarm yang ada secara terprogram atau membuat alarm yang dibuatOpsItems, Anda harus menentukan Nama Sumber Daya Amazon (ARN). ARN ini mengidentifikasi Systems Manager OpsCenter sebagai target yang OpsItems dibuat dari alarm. Anda dapat menyesuaikan ARN sehingga OpsItems dibuat dari alarm menyertakan informasi spesifik seperti tingkat keparahan atau kategori. Setiap ARN menyertakan informasi yang dijelaskan dalam tabel berikut.


****  

| Parameter | Detail | 
| --- | --- | 
|  `Region`(Diperlukan)  |  Di Wilayah AWS mana alarm ada. Sebagai contoh: `us-west-2`. Untuk informasi tentang Wilayah AWS tempat Anda dapat menggunakanOpsCenter, lihat [AWS Systems Manager titik akhir dan kuota](https://docs.aws.amazon.com/general/latest/gr/ssm.html).  | 
|  `account_ID`(Diperlukan)  |   Akun AWS ID yang sama digunakan untuk membuat alarm. Sebagai contoh: `123456789012`. ID akun harus diikuti oleh titik dua (`:`) dan parameter `opsitem` seperti yang ditunjukkan pada contoh berikut.  | 
|  `severity`(Diperlukan)  |  Tingkat keparahan yang ditentukan pengguna untuk OpsItems dibuat dari alarm. Nilai valid: `1`, `2`, `3`, `4`  | 
|  `Category`(opsional)  |  Kategori untuk OpsItems dibuat dari alarm. Nilai yang valid:`Availability`,`Cost`,`Performance`,`Recovery`, dan`Security`.  | 

Buat ARN dengan menggunakan sintaks berikut. ARN ini tidak termasuk parameter `Category` opsional.

```
arn:aws:ssm:Region:account_ID:opsitem:severity
```

Berikut adalah contohnya.

```
arn:aws:ssm:us-west-2:123456789012:opsitem:3
```

Untuk membuat ARN yang menggunakan parameter `Category` opsional, gunakan sintaks berikut.

```
arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name
```

Berikut adalah contohnya.

```
arn:aws:ssm:us-west-2:123456789012:opsitem:3#CATEGORY=Security
```

## Mengkonfigurasi CloudWatch alarm untuk membuat OpsItems ()AWS CLI
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli"></a>

Perintah ini mengharuskan Anda menentukan ARN untuk parameter. `alarm-actions` Untuk informasi tentang cara membuat ARN, lihat [Sebelum Anda mulai](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).

**Untuk mengkonfigurasi CloudWatch alarm untuk membuat OpsItems (AWS CLI)**

1. Instal dan konfigurasikan AWS Command Line Interface (AWS CLI), jika Anda belum melakukannya.

   Untuk selengkapnya, lihat [Menginstal atau memperbarui versi terbaru AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).

1. Jalankan perintah berikut untuk mengumpulkan informasi tentang alarm yang ingin Anda konfigurasi.

   ```
   aws cloudwatch describe-alarms --alarm-names "alarm name"
   ```

1. Jalankan perintah berikut untuk memperbarui alarm. Ganti masing-masing *example resource placeholder* dengan informasi Anda sendiri.

   ```
   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
   ```

   Inilah contohnya.

------
#### [ 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
   ```

------

## Mengkonfigurasi CloudWatch alarm untuk membuat atau memperbarui OpsItems () CloudFormation
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation"></a>

Bagian ini mencakup AWS CloudFormation templat yang dapat Anda gunakan untuk mengonfigurasi CloudWatch alarm agar dibuat atau diperbarui OpsItems secara otomatis. Setiap template mengharuskan Anda menentukan ARN untuk parameter. `AlarmActions` Untuk informasi tentang cara membuat ARN, lihat [Sebelum Anda mulai](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).

**Alarm metrik** - Gunakan CloudFormation templat berikut untuk membuat atau memperbarui alarm CloudWatch metrik. Alarm yang ditentukan dalam template ini memantau pemeriksaan status instans Amazon Elastic Compute Cloud (Amazon EC2). Jika alarm memasuki `ALARM` status, itu menciptakan OpsItem masukOpsCenter. 

```
    {
      "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"}}]
          }
        }
      }
    }
```

**Alarm komposit** - Gunakan CloudFormation template berikut untuk membuat atau memperbarui alarm komposit. Alarm komposit terdiri dari beberapa alarm metrik. Jika alarm memasuki `ALARM` status, itu menciptakan OpsItem masukOpsCenter.

```
"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"
          }
       }
    }
```

## Mengkonfigurasi CloudWatch alarm untuk membuat atau memperbarui OpsItems () Java
<a name="OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java"></a>

Bagian ini mencakup cuplikan Java kode yang dapat Anda gunakan untuk mengonfigurasi CloudWatch alarm agar dibuat atau diperbarui secara otomatis. OpsItems Setiap cuplikan mengharuskan Anda menentukan ARN untuk parameter tersebut. `validSsmActionStr` Untuk informasi tentang cara membuat ARN, lihat [Sebelum Anda mulai](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).

**Alarm tertentu** — Gunakan cuplikan Java kode berikut untuk membuat atau memperbarui alarm. CloudWatch alarm yang ditentukan dalam templat ini memantau pemeriksaan status instans Amazon EC2. Jika alarm memasuki `ALARM` status, itu menciptakan OpsItem masukOpsCenter.

```
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);
    }
```

**Perbarui semua alarm** — Gunakan cuplikan Java kode berikut untuk memperbarui semua CloudWatch alarm di Anda Akun AWS untuk membuat OpsItems ketika alarm memasuki status. `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;
            }
        }
    }
```

# Buat OpsItems secara manual
<a name="OpsCenter-manually-create-OpsItems"></a>

Ketika Anda menemukan masalah operasional, Anda dapat membuat OpsItem From OpsCenter, alat di AWS Systems Manager, untuk mengelola dan menyelesaikan masalah. 

Jika Anda mengatur OpsCenter untuk administrasi lintas akun, administrator atau akun AWS Organizations manajemen yang didelegasikan Systems Manager dapat membuat OpsItems untuk akun anggota. Untuk informasi selengkapnya, lihat [(Opsional) Diatur secara manual OpsCenter untuk mengelola OpsItems seluruh akun secara terpusat](OpsCenter-getting-started-multiple-accounts.md).

Anda dapat membuat OpsItems dengan menggunakan AWS Systems Manager konsol, AWS Command Line Interface (AWS CLI), atau AWS Tools for Windows PowerShell.

**Topics**
+ [Membuat OpsItems secara manual (konsol)](OpsCenter-creating-OpsItems-console.md)
+ [Membuat OpsItems secara manual (AWS CLI)](OpsCenter-creating-OpsItems-CLI.md)
+ [Membuat OpsItems secara manual (PowerShell)](OpsCenter-creating-OpsItems-Powershell.md)

# Membuat OpsItems secara manual (konsol)
<a name="OpsCenter-creating-OpsItems-console"></a>

 Anda dapat membuat secara manual OpsItems menggunakan AWS Systems Manager konsol. Saat Anda membuatOpsItem, itu ditampilkan di OpsCenter akun Anda. Jika Anda mengatur OpsCenter administrasi lintas akun, OpsCenter berikan administrator atau akun manajemen yang didelegasikan dengan opsi OpsItems untuk membuat akun anggota yang dipilih. Untuk informasi selengkapnya, lihat [(Opsional) Diatur secara manual OpsCenter untuk mengelola OpsItems seluruh akun secara terpusat](OpsCenter-getting-started-multiple-accounts.md).

**Untuk membuat OpsItem menggunakan AWS Systems Manager konsol**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Di panel navigasi, pilih **OpsCenter**.

1. Pilih **BuatOpsItem**. Jika Anda tidak melihat tombol ini, pilih **OpsItems**tab, lalu pilih **Buat OpsItem**.

1.  (Opsional) Pilih **Akun lain**, lalu pilih akun tempat Anda ingin membuat akunOpsItem. 
**catatan**  
Langkah ini diperlukan jika Anda membuat OpsItems akun anggota. 

1. Untuk **Judul**, masukkan nama deskriptif untuk membantu Anda memahami tujuan. OpsItem

1. Untuk **Sumber**, masukkan jenis sumber AWS daya yang terkena dampak atau informasi sumber lainnya untuk membantu pengguna memahami asal usulnya. OpsItem
**catatan**  
Anda tidak dapat mengedit bidang **Sumber** setelah membuatOpsItem.

1. (Opsional) Untuk **Prioritas**, pilih tingkat prioritas.

1. (Opsional) Untuk **Kepelikan**, pilih tingkat kepelikan.

1. (Opsional) Untuk **Kategori**, pilih kategori.

1. Untuk **Deskripsi**, masukkan informasi tentang ini OpsItem termasuk (jika ada) langkah-langkah untuk mereproduksi masalah. 
**catatan**  
Konsol mendukung sebagian besar pemformatan penurunan harga di bidang OpsItem deskripsi. Untuk informasi selengkapnya, lihat [Menggunakan Penurunan Harga di Konsol](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html) di *Panduan Memulai dengan Konsol Manajemen AWS Memulai*.

1. Untuk **string Deduplikasi**, masukkan kata-kata yang dapat digunakan sistem untuk memeriksa duplikat. OpsItems Untuk informasi lebih lanjut tentang string deduplikasi, lihat [Mengelola duplikat OpsItems](OpsCenter-working-deduplication.md). 

1. (Opsional) Untuk **Pemberitahuan**, tentukan Nama Sumber Daya Amazon (ARN) dari topik Amazon SNS tempat Anda ingin pemberitahuan dikirim saat OpsItem ini diperbarui. Anda harus menentukan Amazon SNS ARN yang sama dengan. Wilayah AWS OpsItem

1. (Opsional) Untuk **sumber daya terkait**, pilih **Tambah** untuk menentukan ID atau ARN dari sumber daya yang terkena dampak dan sumber daya terkait apa pun.

1. Pilih **BuatOpsItem**.

Jika berhasil, halaman akan menampilkan fileOpsItem. Ketika administrator atau akun manajemen yang didelegasikan membuat OpsItem untuk akun anggota yang dipilih, akun baru OpsItems akan ditampilkan di OpsCenter akun administrator dan anggota. Untuk informasi tentang cara mengkonfigurasi opsi diOpsItem, lihat[Kelola OpsItems](OpsCenter-working-with-OpsItems.md).

# Membuat OpsItems secara manual (AWS CLI)
<a name="OpsCenter-creating-OpsItems-CLI"></a>

Prosedur berikut menjelaskan cara membuat OpsItem dengan menggunakan AWS Command Line Interface (AWS CLI).

**Untuk membuat OpsItem menggunakan AWS CLI**

1. Instal dan konfigurasikan AWS Command Line Interface (AWS CLI), jika Anda belum melakukannya.

   Untuk selengkapnya, lihat [Menginstal atau memperbarui versi terbaru AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).

1. Buka AWS CLI dan jalankan perintah berikut untuk membuat fileOpsItem. Ganti masing-masing *example resource placeholder* dengan informasi Anda sendiri.

   ```
   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"
   ```

   **Tentukan data operasional dari file**

   Saat Anda membuatOpsItem, Anda dapat menentukan data operasional dari file. File harus berupa JSON file, dan isi file harus menggunakan format berikut.

   ```
   {
     "key_name": {
       "Type": "SearchableString",
       "Value": "Up to 20 KB of data"
     }
   }
   ```

   Inilah contohnya.

   ```
   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"
   ```
**catatan**  
*Untuk informasi tentang cara memasukkan parameter berformat JSON pada baris perintah pada sistem operasi lokal yang berbeda, lihat [Menggunakan tanda kutip dengan string di dalam](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) Panduan Pengguna. AWS CLIAWS Command Line Interface *

   Sistem mengembalikan informasi seperti berikut ini.

   ```
   {
       "OpsItemId": "oi-1a2b3c4d5e6f"
   }
   ```

1. Jalankan perintah berikut untuk melihat detail tentang OpsItem yang Anda buat.

   ```
   aws ssm get-ops-item --ops-item-id ID
   ```

   Sistem mengembalikan informasi seperti berikut ini.

   ```
   {
       "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. Jalankan perintah berikut untuk memperbarui fileOpsItem. Perintah ini mengubah status dari `Open` (default) ke `InProgress`.

   ```
   aws ssm update-ops-item --ops-item-id ID --status InProgress
   ```

   Perintah tidak memiliki output.

1. Jalankan perintah berikut lagi untuk memverifikasi bahwa status berubah menjadi`InProgress`.

   ```
   aws ssm get-ops-item --ops-item-id ID
   ```

## Contoh membuat OpsItem
<a name="OpsCenter_creating_OpsItems-CLI_examples"></a>

Contoh kode berikut menunjukkan cara membuat OpsItem dengan menggunakan portal Linux manajemen,macOS, atauWindows Server. 

**Linuxportal manajemen atau macOS**

Perintah berikut membuat OpsItem ketika disk instans Amazon Elastic Compute Cloud (Amazon EC2) penuh. 

```
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"
```

Perintah berikut menggunakan `/aws/resources` kunci `OperationalData` untuk membuat OpsItem dengan sumber daya terkait Amazon DynamoDB.

```
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"
```

Perintah berikut menggunakan `/aws/automations` kunci `OperationalData` untuk membuat dokumen OpsItem yang menentukan `AWS-ASGEnterStandby` dokumen sebagai runbook Otomasi terkait.

```
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**

Perintah berikut akan membuat instance OpsItem saat Amazon Relational Database Service (Amazon RDS) tidak merespons. 

```
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"
```

Perintah berikut menggunakan `/aws/resources` kunci `OperationalData` untuk membuat OpsItem dengan sumber daya terkait instans Amazon EC2.

```
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\"}}
```

Perintah berikut menggunakan `/aws/automations` kunci `OperationalData` untuk membuat OpsItem yang menentukan `AWS-RestartEC2Instance` runbook sebagai runbook Otomasi terkait.

```
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\"}}
```

# Membuat OpsItems secara manual (PowerShell)
<a name="OpsCenter-creating-OpsItems-Powershell"></a>

Prosedur berikut menjelaskan cara membuat OpsItem dengan menggunakan AWS Tools for Windows PowerShell. 

**Untuk membuat OpsItem penggunaan AWS Tools for Windows PowerShell**

1. Buka AWS Tools for Windows PowerShell dan jalankan perintah berikut untuk menentukan kredensialmu. 

   ```
   Set-AWSCredentials –AccessKey key-name –SecretKey key-name
   ```

1. Jalankan perintah berikut Wilayah AWS untuk mengatur PowerShell sesi Anda.

   ```
   Set-DefaultAWSRegion -Region Region
   ```

1. Jalankan perintah berikut untuk membuat yang baruOpsItem. Ganti masing-masing *example resource placeholder* dengan informasi Anda sendiri. Perintah ini menentukan runbook Automation Systems Manager untuk memulihkan ini. OpsItem 

   ```
   $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
   ```

   Jika berhasil, perintah mengeluarkan ID yang baruOpsItem.

Contoh berikut menentukan Nama Sumber Daya Amazon (ARN) dari instance Amazon Elastic Compute Cloud (Amazon EC2) yang mengalami gangguan.

```
$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
```