• 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.
# Memantau peristiwa Systems Manager dengan Amazon EventBridge
Amazon EventBridge adalah layanan bus acara tanpa server yang memungkinkan Anda menghubungkan aplikasi Anda dengan data dari berbagai sumber. EventBridge mengirimkan aliran data real-time dari aplikasi Anda sendiri, aplikasi software-as-a-service (SaaS), Layanan AWS dan dan rute data tersebut ke target seperti. AWS Lambda Anda dapat mengatur aturan perutean untuk menentukan ke mana harus mengirim data Anda untuk membangun arsitektur aplikasi yang bereaksi secara real time ke semua sumber data Anda. EventBridge memungkinkan Anda membangun arsitektur berbasis peristiwa, yang digabungkan dan didistribusikan secara longgar.
EventBridge Sebelumnya bernama Amazon CloudWatch Events. EventBridge termasuk fitur baru yang memungkinkan Anda menerima acara dari mitra SaaS dan aplikasi Anda sendiri. Pengguna CloudWatch Event yang ada dapat mengakses bus, aturan, dan acara default yang ada di EventBridge konsol baru dan di konsol CloudWatch Events. EventBridge menggunakan CloudWatch Events API yang sama, sehingga semua penggunaan CloudWatch Events API yang ada tetap sama.
EventBridge dapat menambahkan acara dari Layanan AWS lusinan aturan Anda, dan target dari lebih dari 20 Layanan AWS.
EventBridge memberikan dukungan untuk AWS Systems Manager event dan target Systems Manager.
**Jenis peristiwa Systems Manager yang didukung**
Di antara banyak jenis peristiwa Systems Manager yang EventBridge dapat mendeteksi adalah:
+ Pembaruan status permintaan akses just-in-time node untuk persetujuan manual.
+ Permintaan akses just-in-time node gagal.
+ Jendela pemeliharaan yang dimatikan.
+ Penyelesaian alur kerja Otomatisasi yang berhasil. Otomasi adalah alat dalam AWS Systems Manager.
+ Node terkelola berada di luar kepatuhan tambalan.
+ Nilai parameter yang diperbarui.
EventBridge mendukung acara dari AWS Systems Manager alat-alat berikut:
+ Just-in-time akses node (Peristiwa dipancarkan berdasarkan upaya terbaik.)
+ Otomasi (Acara dipancarkan berdasarkan upaya terbaik.)
+ Change Calendar(Peristiwa dipancarkan atas dasar upaya terbaik.)
+ Kepatuhan
+ Inventaris (Peristiwa dipancarkan atas dasar upaya terbaik.)
+ Maintenance Windows(Peristiwa dipancarkan atas dasar upaya terbaik.)
+ Parameter Store(Peristiwa dipancarkan atas dasar upaya terbaik.)
+ Run Command(Peristiwa dipancarkan atas dasar upaya terbaik.)
+ State Manager(Peristiwa dipancarkan atas dasar upaya terbaik.)
Untuk detail selengkapnya tentang jenis acara Systems Manager yang didukung, lihat [Referensi: Pola dan jenis EventBridge acara Amazon untuk Systems Manager](reference-eventbridge-events.md) dan[Contoh EventBridge acara Amazon untuk Systems Manager](monitoring-systems-manager-event-examples.md).
**Jenis target Systems Manager yang didukung**
EventBridge mendukung tiga alat Systems Manager berikut sebagai target aturan acara:
+ Menjalankan alur kerja Otomatisasi
+ Menjalankan dokumen Run Command Command (Peristiwa dipancarkan berdasarkan upaya terbaik.)
+ Menciptakan sebuah OpsCenter OpsItem
Untuk cara yang disarankan agar Anda dapat menggunakan target ini, lihat [Contoh skenario: Target Systems Manager dalam EventBridge aturan Amazon](monitoring-systems-manager-targets.md).
Untuk informasi selengkapnya tentang cara memulai EventBridge dan menyiapkan aturan, lihat [Memulai Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html) di *Panduan EventBridge Pengguna Amazon*. Untuk informasi lengkap tentang bekerja dengan EventBridge, lihat [https://docs.aws.amazon.com/eventbridge/latest/userguide/](https://docs.aws.amazon.com/eventbridge/latest/userguide/).
**Topics**
+ [Mengkonfigurasi EventBridge untuk acara Systems Manager](monitoring-systems-manager-events.md)
+ [Contoh EventBridge acara Amazon untuk Systems Manager](monitoring-systems-manager-event-examples.md)
+ [Contoh skenario: Target Systems Manager dalam EventBridge aturan Amazon](monitoring-systems-manager-targets.md)
# Mengkonfigurasi EventBridge untuk acara Systems Manager
Anda dapat menggunakan Amazon EventBridge untuk melakukan peristiwa target saat perubahan AWS Systems Manager status yang didukung, perubahan status, atau kondisi lainnya terjadi. Anda dapat membuat aturan yang berjalan setiap kali terjadi transisi tahapan atau status, atau saat ada transisi ke satu atau beberapa tahapan yang penting.
Prosedur berikut menyediakan langkah-langkah umum untuk membuat EventBridge aturan yang terlibat ketika peristiwa tertentu dipancarkan oleh Systems Manager. Untuk daftar prosedur dalam panduan pengguna ini yang membahas skenario tertentu, lihat **Info selengkapnya** di akhir topik ini.
**catatan**
Ketika layanan di Anda Akun AWS memancarkan suatu acara, itu selalu masuk ke bus acara default akun Anda. Untuk menulis aturan yang merespons peristiwa dari Layanan AWS akun Anda, kaitkan dengan bus acara default. Anda dapat membuat aturan pada bus acara khusus yang mencari acara dari Layanan AWS, tetapi aturan ini hanya berlaku ketika Anda menerima acara semacam itu dari akun lain melalui pengiriman acara lintas akun. Untuk informasi selengkapnya, lihat [Mengirim dan menerima EventBridge peristiwa Amazon antara Akun AWS](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cross-account.html) di *Panduan EventBridge Pengguna Amazon*.
**Mengkonfigurasi EventBridge untuk acara Systems Manager**
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. Pilih **Buat aturan**.
1. Masukkan nama dan deskripsi aturan.
Aturan tidak dapat memiliki nama yang sama dengan aturan lain di bus acara yang sama Wilayah AWS dan di bus acara yang sama.
1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini merespons peristiwa pencocokan yang berasal dari Anda sendiri Akun AWS, pilih **default**. Ketika Layanan AWS di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.
1. Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**.
1. Pilih **Selanjutnya**.
1. Untuk **sumber Acara**, pilih **AWS acara atau acara EventBridge mitra**.
1. Di bagian **Pola acara**, pilih **Formulir pola acara**.
1. Untuk **Sumber peristiwa**, pilih **Layanan AWS **.
1. Untuk **AWS layanan**, pilih **Systems Manager**.
1. Untuk **Jenis peristiwa**, lakukan salah satu hal berikut:
+ Pilih **Semua Peristiwa**.
Jika Anda memilih **Semua peristiwa**, semua peristiwa yang dipancarkan oleh Systems Manager ini akan sesuai dengan aturan. Ketahuilah bahwa pilihan ini dapat mengakibatkan banyak tindakan target peristiwa.
+ Pilih jenis acara Systems Manager yang akan digunakan untuk aturan ini. EventBridge mendukung acara dari AWS Systems Manager alat-alat berikut:
+ Otomatisasi
+ Change Calendar
+ Kepatuhan
+ Inventaris
+ Maintenance Windows
+ Parameter Store
+ Run Command
+ State Manager
**catatan**
Untuk tindakan Systems Manager yang tidak didukung oleh EventBridge, Anda dapat memilih panggilan AWS API CloudTrail untuk membuat aturan peristiwa yang didasarkan pada panggilan API, yang direkam oleh CloudTrail. Sebagai contoh, lihat [Memantau aktivitas sesi menggunakan Amazon EventBridge (konsol)](session-manager-auditing.md#session-manager-auditing-eventbridge-events).
1. (Opsional) Untuk membuat aturan lebih spesifik, tambahkan nilai filter. Misalnya, jika Anda memilih **State Manager**dan ingin membatasi aturan ke status instans terkelola tunggal yang ditargetkan oleh Asosiasi, untuk **tipe tertentu**, pilih **Perubahan Status Asosiasi Instans Manajer Negara EC2**.
Untuk detail selengkapnya tentang jenis detail yang didukung, lihat[Referensi: Pola dan jenis EventBridge acara Amazon untuk Systems Manager](reference-eventbridge-events.md).
Beberapa jenis detail memiliki opsi lain yang didukung seperti status. Opsi yang tersedia tergantung pada alat yang Anda pilih.
1. Pilih **Berikutnya**.
1. Untuk **Jenis target**, pilih **Layanan AWS **.
1. Untuk **Pilih target**, pilih target seperti topik atau AWS Lambda fungsi Amazon SNS. Target terpicu saat peristiwa diterima yang sesuai dengan pola peristiwa yang ditentukan dalam aturan.
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 IAM role secara otomatis, pilih **Buat peran baru untuk sumber daya khusus ini**.
+ Untuk menggunakan IAM role yang Anda buat sebelumnya, pilih **Gunakan peran yang ada**.
1. (Opsional) Pilih **Tambahkan target lain** untuk menambahkan target lain untuk aturan ini.
1. Pilih **Berikutnya**.
1. (Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) *di Panduan EventBridge Pengguna Amazon*.
1. Pilih **Berikutnya**.
1. Tinjau detail aturan dan pilih **Buat aturan**.
**Info lebih lanjut**
+ [Membuat EventBridge acara yang menggunakan runbook (konsol)](running-automations-event-bridge.md#automation-cwe-target-console)
+ [Meneruskan data ke Otomasi menggunakan transformator input](automation-tutorial-eventbridge-input-transformers.md)
+ [Memulihkan masalah kepatuhan menggunakan EventBridge](compliance-fixing.md)
+ [Melihat tindakan penghapusan inventaris di EventBridge](inventory-custom.md#delete-custom-inventory-cwe)
+ [Konfigurasikan EventBridge aturan untuk membuat OpsItems](OpsCenter-automatically-create-OpsItems-2.md)
+ [Mengkonfigurasi EventBridge aturan untuk parameter dan kebijakan parameter](sysman-paramstore-cwe.md#cwe-parameter-changes)
# Contoh EventBridge acara Amazon untuk Systems Manager
Berikut ini adalah contoh, dalam format JSON, dari EventBridge acara yang didukung untuk AWS Systems Manager.
**Topics**
+ [AWS Systems Manager Acara Otomasi](#SSM-Automation-event-types)
+ [AWS Systems Manager PeristiwaChange Calendar](#SSM-Change-Management-event-types)
+ [AWS Systems Manager PeristiwaChange Manager](#SSM-Change-Manager-event-types)
+ [AWS Systems Manager Acara Kepatuhan](#SSM-Configuration-Compliance-event-types)
+ [AWS Systems Manager PeristiwaMaintenance Windows](#EC2_maintenance_windows_event_types)
+ [AWS Systems Manager PeristiwaParameter Store](#SSM-Parameter-Store-event-types)
+ [AWS Systems Manager PeristiwaOpsCenter](#SSM-OpsCenter-event-types)
+ [AWS Systems Manager PeristiwaRun Command](#SSM-Run-Command-event-types)
+ [AWS Systems Manager PeristiwaState Manager](#SSM-State-Manager-event-types)
## AWS Systems Manager Acara Otomasi
**Pemberitahuan Perubahan Status Langkah Otomasi**
```
{
"version": "0",
"id": "eeca120b-a321-433e-9635-dab369006a6b",
"detail-type": "EC2 Automation Step Status-change Notification",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-11-29T19:43:35Z",
"region": "us-east-1",
"resources": ["arn:aws:ssm:us-east-2:123456789012:automation-execution/333ba70b-2333-48db-b17e-a5e69c6f4d1c",
"arn:aws:ssm:us-east-2:123456789012:automation-definition/runcommand1:1"],
"detail": {
"ExecutionId": "333ba70b-2333-48db-b17e-a5e69c6f4d1c",
"Definition": "runcommand1",
"DefinitionVersion": 1.0,
"Status": "Success",
"EndTime": "Nov 29, 2024 7:43:25 PM",
"StartTime": "Nov 29, 2024 7:43:23 PM",
"Time": 2630.0,
"StepName": "runFixedCmds",
"Action": "aws:runCommand"
}
}
```
**Pemberitahuan Perubahan Status Eksekusi Otomatisasi**
```
{
"version": "0",
"id": "d290ece9-1088-4383-9df6-cd5b4ac42b99",
"detail-type": "EC2 Automation Execution Status-change Notification",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-11-29T19:43:35Z",
"region": "us-east-2",
"resources": ["arn:aws:ssm:us-east-2:123456789012:automation-execution/333ba70b-2333-48db-b17e-a5e69c6f4d1c",
"arn:aws:ssm:us-east-2:123456789012:automation-definition/runcommand1:1"],
"detail": {
"ExecutionId": "333ba70b-2333-48db-b17e-a5e69c6f4d1c",
"Definition": "runcommand1",
"DefinitionVersion": 1.0,
"Status": "Success",
"StartTime": "Nov 29, 2024 7:43:20 PM",
"EndTime": "Nov 29, 2024 7:43:26 PM",
"Time": 5753.0,
"ExecutedBy": "arn:aws:iam::123456789012:user/userName"
}
}
```
## AWS Systems Manager PeristiwaChange Calendar
Gunakan informasi dalam topik ini untuk merencanakan dan memahami perilaku EventBridge peristiwa untuk AWS Systems ManagerChange Calendar.
**catatan**
Perubahan status untuk kalender yang dibagikan dari yang lain saat Akun AWS ini tidak didukung.
### Change CalendarIntegrasi dengan Amazon EventBridge
AWS Systems Manager Change Calendarterintegrasi dengan Amazon EventBridge untuk memberi tahu Anda tentang perubahan status kalender. Waspadai perilaku berikut yang terkait dengan arsitektur penjadwalan yang mendasarinya:
Waktu dan keandalan acara
+ EventBridge memberikan pemberitahuan dengan upaya terbaik dengan toleransi penjadwalan hingga 15 menit.
+ Peristiwa perubahan status mencerminkan transisi status kalender secara keseluruhan, bukan acara kalender individual.
+ Ketika beberapa peristiwa kalender terjadi secara bersamaan, hanya EventBridge menghasilkan satu peristiwa per perubahan status kalender yang sebenarnya.
+ EventBridge memicu peristiwa hanya ketika transisi status keseluruhan kalender (misalnya, dari CLOSED ke OPEN), bukan untuk acara kalender individual yang tidak menghasilkan perubahan status.
+ Acara penasehat yang tidak mengubah status kalender tidak memicu EventBridge pemberitahuan.
Modifikasi acara dan pertimbangan waktu
+ Jika Anda mengubah acara kalender dalam waktu 15 menit dari waktu mulai atau berakhir yang dijadwalkan, EventBridge mungkin menghasilkan pemberitahuan duplikat atau pemberitahuan yang tidak terjawab.
+ Perilaku ini terjadi karena sistem penjadwalan mungkin tidak memiliki cukup waktu untuk memperbarui atau membatalkan pemberitahuan yang dijadwalkan sebelumnya dengan benar.
+ Untuk kejadian berulang, perilaku ini biasanya hanya memengaruhi kejadian pertama setelah modifikasi.
Acara yang berdekatan dan tumpang tindih
+ Ketika acara kalender dijadwalkan dalam waktu 5 menit satu sama lain, peristiwa transisi status mungkin atau mungkin tidak terjadi, tergantung pada perubahan status yang sebenarnya.
+ Membuat peristiwa yang tumpang tindih dalam urutan tertentu dapat menghasilkan EventBridge peristiwa tambahan bahkan ketika tidak ada perubahan status yang sebenarnya terjadi.
+ Untuk memastikan perilaku yang dapat diprediksi, hindari membuat atau memodifikasi acara kalender yang mendekati waktu pelaksanaannya.
Praktik terbaik
+ Rancang EventBridge aturan Anda dan otomatisasi hilir untuk menangani potensi kejadian duplikat.
+ Terapkan idempotensi dalam alur kerja otomatisasi Anda untuk mencegah masalah dari pemberitahuan duplikat.
+ Berikan waktu tunggu yang cukup (setidaknya 15 menit) saat Anda membuat atau memodifikasi acara kalender.
+ Uji EventBridge integrasi Anda secara menyeluruh dengan pola acara kalender spesifik Anda.
**Kalender BUKA**
```
{
"version": "0",
"id": "47a3f03a-f30d-1011-ac9a-du3bdEXAMPLE",
"detail-type": "Calendar State Change",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-09-19T18:00:07Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:document/MyCalendar"
],
"detail": {
"state": "OPEN",
"atTime": "2024-09-19T18:00:07Z",
"nextTransitionTime": "2024-10-11T18:00:07Z"
}
}
```
**Kalender DITUTUP**
```
{
"version": "0",
"id": "f30df03a-1011-ac9a-47a3-f761eEXAMPLE",
"detail-type": "Calendar State Change",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-09-17T21:40:02Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:document/MyCalendar"
],
"detail": {
"state": "CLOSED",
"atTime": "2024-08-17T21:40:00Z",
"nextTransitionTime": "2024-09-19T18:00:07Z"
}
}
```
## AWS Systems Manager PeristiwaChange Manager
**Ubah pemberitahuan pembaruan status permintaan - contoh 1**
```
{
"version": "0",
"id": "feab80c1-a8ff-c721-b8b1-96ce70939696",
"detail-type": "Change Request Status Update",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-10-24T10:51:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:ssm:us-west-2:123456789012:opsitem/oi-12345abcdef",
"arn:aws:ssm:us-west-2:123456789012:document/MyRunbook1"
],
"detail": {
"change-request-id": "d0585556-80f6-4522-8dad-dada6d45b67d",
"change-request-title": "A change request title",
"ops-item-id": "oi-12345abcdef",
"ops-item-created-by": "arn:aws:iam::123456789012:user/JohnDoe",
"ops-item-created-time": "2024-10-24T10:50:33.180334Z",
"ops-item-modified-by": "arn:aws:iam::123456789012:user/JohnDoe",
"ops-item-modified-time": "2024-10-24T10:50:33.180340Z",
"ops-item-status": "InProgress",
"change-template-document-name": "MyChangeTemplate",
"runbook-document-arn": "arn:aws:ssm:us-west-2:123456789012:document/MyRunbook1",
"runbook-document-version": "1",
"auto-approve": true,
"approvers": [
"arn:aws:iam::123456789012:user/JaneDoe"
]
}
}
```
**Ubah pemberitahuan pembaruan status permintaan - contoh 2**
```
{
"version": "0",
"id": "25ce6b03-2e4e-1a2b-2a8f-6c9de8d278d2",
"detail-type": "Change Request Status Update",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-10-24T10:51:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:ssm:us-west-2:123456789012:opsitem/oi-abcdef12345",
"arn:aws:ssm:us-west-2:123456789012:document/MyRunbook1"
],
"detail": {
"change-request-id": "d0585556-80f6-4522-8dad-dada6d45b67d",
"change-request-title": "A change request title",
"ops-item-id": "oi-abcdef12345",
"ops-item-created-by": "arn:aws:iam::123456789012:user/JohnDoe",
"ops-item-created-time": "2024-10-24T10:50:33.180334Z",
"ops-item-modified-by": "arn:aws:iam::123456789012:user/JohnDoe",
"ops-item-modified-time": "2024-10-24T10:50:33.997163Z",
"ops-item-status": "Rejected",
"change-template-document-name": "MyChangeTemplate",
"runbook-document-arn": "arn:aws:ssm:us-west-2:123456789012:document/MyRunbook1",
"runbook-document-version": "1",
"auto-approve": true,
"approvers": [
"arn:aws:iam::123456789012:user/JaneDoe"
]
}
}
```
## AWS Systems Manager Acara Kepatuhan
Berikut ini adalah contoh peristiwa untuk AWS Systems Manager Kepatuhan.
**Sesuai Asosiasi**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-012345678901",
"detail-type": "Configuration Compliance State Change",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-07-17T19:03:26Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:managed-instance/i-01234567890abcdef"
],
"detail": {
"last-runtime": "2024-01-01T10:10:10Z",
"compliance-status": "compliant",
"resource-type": "managed-instance",
"resource-id": "i-01234567890abcdef",
"compliance-type": "Association"
}
}
```
**Asosiasi Tidak Patuh**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-012345678901",
"detail-type": "Configuration Compliance State Change",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-07-17T19:02:31Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:managed-instance/i-01234567890abcdef"
],
"detail": {
"last-runtime": "2024-01-01T10:10:10Z",
"compliance-status": "non_compliant",
"resource-type": "managed-instance",
"resource-id": "i-01234567890abcdef",
"compliance-type": "Association"
}
}
```
**Patch Compliant**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-012345678901",
"detail-type": "Configuration Compliance State Change",
"source": "aws.123456789012",
"account": "123456789012",
"time": "2024-07-17T19:03:26Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:managed-instance/i-01234567890abcdef"
],
"detail": {
"resource-type": "managed-instance",
"resource-id": "i-01234567890abcdef",
"compliance-status": "compliant",
"compliance-type": "Patch",
"patch-baseline-id": "PB789",
"severity": "critical"
}
}
```
**Patch Tidak Sesuai**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-012345678901",
"detail-type": "Configuration Compliance State Change",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-07-17T19:02:31Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:managed-instance/i-01234567890abcdef"
],
"detail": {
"resource-type": "managed-instance",
"resource-id": "i-01234567890abcdef",
"compliance-status": "non_compliant",
"compliance-type": "Patch",
"patch-baseline-id": "PB789",
"severity": "critical"
}
}
```
## AWS Systems Manager PeristiwaMaintenance Windows
Berikut ini adalah contoh peristiwa untuk Systems ManagerMaintenance Windows.
**Daftarkan Target**
Nilai status yang valid termasuk `REGISTERED` dan`DEREGISTERED`.
```
{
"version":"0",
"id":"01234567-0123-0123-0123-0123456789ab",
"detail-type":"Maintenance Window Target Registration Notification",
"source":"aws.ssm",
"account":"123456789012",
"time":"2024-11-16T00:58:37Z",
"region":"us-east-2",
"resources":[
"arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0ed7251d3fcf6e0c2",
"arn:aws:ssm:us-east-2:123456789012:windowtarget/e7265f13-3cc5-4f2f-97a9-7d3ca86c32a6"
],
"detail":{
"window-target-id":"e7265f13-3cc5-4f2f-97a9-7d3ca86c32a6",
"window-id":"mw-0ed7251d3fcf6e0c2",
"status":"REGISTERED"
}
}
```
**Jenis Eksekusi Jendela**
Nilai status yang valid meliputi yang berikut:
+ `CANCELLED`
+ `CANCELLING`
+ `FAILED`
+ `IN_PROGRESS`
+ `PENDING`
+ `SKIPPED_OVERLAPPING`
+ `SUCCESS TIMED_OUT`
```
{
"version":"0",
"id":"01234567-0123-0123-0123-0123456789ab",
"detail-type":"Maintenance Window Execution State-change Notification",
"source":"aws.ssm",
"account":"123456789012",
"time":"2025-06-02T14:52:18Z",
"region":"us-east-2",
"resources":[
"arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0c50858d01EXAMPLE"
],
"detail":{
"start-time":"2025-06-02T14:48:28.039273Z",
"end-time":"2025-06-02T14:52:18.083773Z",
"window-id":"mw-0ed7251d3fcf6e0c2",
"window-execution-id":"14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE",
"status":"SUCCESS"
}
}
```
**Jenis Eksekusi Tugas**
Nilai status yang valid meliputi`IN_PROGRESS`,`SUCCESS`,`FAILED`, dan`TIMED_OUT`.
```
{
"version":"0",
"id":"01234567-0123-0123-0123-0123456789ab",
"detail-type":"Maintenance Window Task Execution State-change Notification",
"source":"aws.ssm",
"account":"123456789012",
"time":"2025-06-02T14:52:18Z",
"region":"us-east-2",
"resources":[
"arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0c50858d01EXAMPLE"
],
"detail":{
"start-time":"2025-06-02T14:48:28.039273Z",
"task-execution-id":"6417e808-7f35-4d1a-843f-123456789012",
"end-time":"2025-06-02T14:52:18.083773Z",
"window-id":"mw-0ed7251d3fcf6e0c2",
"window-execution-id":"14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE",
"status":"SUCCESS"
}
}
```
**Target Tugas Diproses**
Nilai status yang valid meliputi`IN_PROGRESS`,`SUCCESS`,`FAILED`, dan`TIMED_OUT`.
```
{
"version":"0",
"id":"01234567-0123-0123-0123-0123456789ab",
"detail-type":"Maintenance Window Task Target Invocation State-change Notification",
"source":"aws.ssm",
"account":"123456789012",
"time":"2025-06-02T14:52:18Z",
"region":"us-east-2",
"resources":[
"arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-123456789012345678"
],
"detail":{
"start-time":"2025-06-02T14:48:28.039273Z",
"end-time":"2025-06-02T14:52:18.083773Z",
"window-id":"mw-0ed7251d3fcf6e0c2",
"window-execution-id":"791b72e0-f0da-4021-8b35-f95dfEXAMPLE",
"task-execution-id":"c9b05aba-197f-4d8d-be34-e73fbEXAMPLE",
"window-target-id":"e32eecb2-646c-4f4b-8ed1-205fbEXAMPLE",
"status":"SUCCESS",
"owner-information":"Owner"
}
}
```
**Perubahan Status Jendela**
Nilai status yang valid termasuk `ENABLED` dan`DISABLED`.
```
{
"version":"0",
"id":"01234567-0123-0123-0123-0123456789ab",
"detail-type":"Maintenance Window State-change Notification",
"source":"aws.ssm",
"account":"123456789012",
"time":"2024-11-16T00:58:37Z",
"region":"us-east-2",
"resources":[
"arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0c50858d01EXAMPLE"
],
"detail":{
"window-id":"mw-0c50858d01EXAMPLE",
"status":"DISABLED"
}
}
```
## AWS Systems Manager PeristiwaParameter Store
Berikut ini adalah contoh peristiwa untuk Systems ManagerParameter Store.
**Buat Parameter**
```
{
"version": "0",
"id": "6a7e4feb-b491-4cf7-a9f1-bf3703497718",
"detail-type": "Parameter Store Change",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-05-22T16:43:48Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:parameter/MyExampleParameter"
],
"detail": {
"operation": "Create",
"name": "MyExampleParameter",
"type": "String",
"description": "Sample Parameter"
}
}
```
**Perbarui Parameter**
```
{
"version": "0",
"id": "9547ef2d-3b7e-4057-b6cb-5fdf09ee7c8f",
"detail-type": "Parameter Store Change",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-05-22T16:44:48Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:parameter/MyExampleParameter"
],
"detail": {
"operation": "Update",
"name": "MyExampleParameter",
"type": "String",
"description": "Sample Parameter"
}
}
```
**Hapus Parameter**
```
{
"version": "0",
"id": "80e9b391-6a9b-413c-839a-453b528053af",
"detail-type": "Parameter Store Change",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-05-22T16:45:48Z",
"region": "us-east-2",
"resources": [
"arn:aws:ssm:us-east-2:123456789012:parameter/MyExampleParameter"
],
"detail": {
"operation": "Delete",
"name": "MyExampleParameter",
"type": "String",
"description": "Sample Parameter"
}
}
```
## AWS Systems Manager PeristiwaOpsCenter
**OpsCenterOpsItembuat notifikasi**
```
{
"version": "0",
"id": "aae66adc-7aac-f0c0-7854-7691e8c079b8",
"detail-type": "OpsItem Create",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-10-19T02:48:11Z",
"region": "us-east-1",
"resources": [
"arn:aws:ssm:us-west-2:123456789012:opsitem/oi-123456abcdef"
],
"detail": {
"created-by": "arn:aws:iam::123456789012:user/JohnDoe",
"created-time": "2024-10-19T02:46:53.629361Z",
"source": "aws.ssm",
"status": "Open",
"ops-item-id": "oi-123456abcdef",
"title": "An issue title",
"ops-item-type": "/aws/issue",
"description": "A long description may appear here"
}
}
```
**OpsCenterOpsItemperbarui pemberitahuan**
```
{
"version": "0",
"id": "2fb5b168-b725-41dd-a890-29311200089c",
"detail-type": "OpsItem Update",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-10-19T02:48:11Z",
"region": "us-east-1",
"resources": [
"arn:aws:ssm:us-west-2:123456789012:opsitem/oi-123456abcdef"
],
"detail": {
"created-by": "arn:aws:iam::123456789012:user/JohnDoe",
"created-time": "2024-10-19T02:46:54.049271Z",
"modified-by": "arn:aws:iam::123456789012:user/JohnDoe",
"modified-time": "2024-10-19T02:46:54.337354Z",
"source": "aws.ssm",
"status": "Open",
"ops-item-id": "oi-123456abcdef",
"title": "An issue title",
"ops-item-type": "/aws/issue",
"description": "A long description may appear here"
}
}
```
## AWS Systems Manager PeristiwaRun Command
**Run CommandPemberitahuan Perubahan Status**
```
{
"version": "0",
"id": "51c0891d-0e34-45b1-83d6-95db273d1602",
"detail-type": "EC2 Command Status-change Notification",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-07-10T21:51:32Z",
"region": "us-east-2",
"resources": ["arn:aws:ec2:us-east-2:123456789012:instance/i-02573cafcfEXAMPLE"],
"detail": {
"command-id": "e8d3c0e4-71f7-4491-898f-c9b35bee5f3b",
"document-name": "AWS-RunPowerShellScript",
"expire-after": "2024-07-14T22:01:30.049Z",
"parameters": {
"executionTimeout": ["3600"],
"commands": ["date"]
},
"requested-date-time": "2024-07-10T21:51:30.049Z",
"status": "Success"
}
}
```
**Run CommandPemberitahuan Perubahan Status Pemanggilan**
```
{
"version": "0",
"id": "4780e1b8-f56b-4de5-95f2-95dbEXAMPLE",
"detail-type": "EC2 Command Invocation Status-change Notification",
"source": "aws.ssm",
"account": "123456789012",
"time": "2024-07-10T21:51:32Z",
"region": "us-east-2",
"resources": ["arn:aws:ec2:us-east-2:123456789012:instance/i-02573cafcfEXAMPLE"],
"detail": {
"command-id": "e8d3c0e4-71f7-4491-898f-c9b35bee5f3b",
"document-name": "AWS-RunPowerShellScript",
"instance-id": "i-02573cafcfEXAMPLE",
"requested-date-time": "2024-07-10T21:51:30.049Z",
"status": "Success"
}
}
```
## AWS Systems Manager PeristiwaState Manager
**State ManagerPerubahan Negara Asosiasi**
```
{
"version":"0",
"id":"db839caf-6f6c-40af-9a48-25b2ae2b7774",
"detail-type":"EC2 State Manager Association State Change",
"source":"aws.ssm",
"account":"123456789012",
"time":"2024-05-16T23:01:10Z",
"region":"us-east-2",
"resources":[
"arn:aws:ssm:us-east-2::document/AWS-RunPowerShellScript"
],
"detail":{
"association-id":"6e37940a-23ba-4ab0-9b96-5d0a1a05464f",
"document-name":"AWS-RunPowerShellScript",
"association-version":"1",
"document-version":"Optional.empty",
"targets":"[{\"key\":\"InstanceIds\",\"values\":[\"i-12345678\"]}]",
"creation-date":"2024-02-13T17:22:54.458Z",
"last-successful-execution-date":"2024-05-16T23:00:01Z",
"last-execution-date":"2024-05-16T23:00:01Z",
"last-updated-date":"2024-02-13T17:22:54.458Z",
"status":"Success",
"association-status-aggregated-count":"{\"Success\":1}",
"schedule-expression":"cron(0 */30 * * * ? *)",
"association-cwe-version":"1.0"
}
}
```
**State ManagerPerubahan Negara Asosiasi Contoh**
```
{
"version":"0",
"id":"6a7e8feb-b491-4cf7-a9f1-bf3703467718",
"detail-type":"EC2 State Manager Instance Association State Change",
"source":"aws.ssm",
"account":"123456789012",
"time":"2024-02-23T15:23:48Z",
"region":"us-east-2",
"resources":[
"arn:aws:ec2:us-east-2:123456789012:instance/i-12345678",
"arn:aws:ssm:us-east-2:123456789012:document/my-custom-document"
],
"detail":{
"association-id":"34fcb7e0-9a14-4984-9989-0e04e3f60bd8",
"instance-id":"i-02573cafcfEXAMPLE",
"document-name":"my-custom-document",
"document-version":"1",
"targets":"[{\"key\":\"instanceids\",\"values\":[\"i-02573cafcfEXAMPLE\"]}]",
"creation-date":"2024-02-23T15:23:48Z",
"last-successful-execution-date":"2024-02-23T16:23:48Z",
"last-execution-date":"2024-02-23T16:23:48Z",
"status":"Success",
"detailed-status":"",
"error-code":"testErrorCode",
"execution-summary":"testExecutionSummary",
"output-url":"sampleurl",
"instance-association-cwe-version":"1"
}
}
```
# Contoh skenario: Target Systems Manager dalam EventBridge aturan Amazon
Saat menentukan target yang akan dipanggil dalam EventBridge aturan Amazon, Anda dapat memilih dari lebih dari 20 jenis target dan menambahkan hingga lima target ke setiap aturan.
Dari berbagai target, Anda dapat memilih dari Otomasi,OpsCenter, danRun Command, yang merupakan alat di AWS Systems Manager, sebagai tindakan target ketika suatu EventBridge peristiwa terjadi.
Berikut ini adalah beberapa contoh cara Anda dapat menggunakan alat ini sebagai target EventBridge aturan.
**Contoh Otomatisasi**
Anda dapat mengonfigurasi EventBridge aturan untuk memulai alur kerja Otomasi ketika peristiwa seperti berikut terjadi:
+ Saat CloudWatch alarm Amazon melaporkan bahwa node terkelola telah gagal melakukan pemeriksaan status (`StatusCheckFailed_Instance=1`), jalankan runbook `AWSSupport-ExecuteEC2Rescue` Otomasi di node.
+ Ketika peristiwa `EC2 Instance State-change Notification` terjadi karena instans Amazon Elastic Compute Cloud (Amazon EC2) baru berjalan, jalankan runbook Otomatisasi `AWS-AttachEBSVolume` pada instans.
+ Ketika volume Amazon Elastic Block Store (Amazon EBS) dibuat dan tersedia, jalankan runbook Otomatisasi `AWS-CreateSnapshot` pada volume.
**OpsCenter contoh**
Anda dapat mengonfigurasi EventBridge aturan untuk membuat yang baru OpsItem ketika insiden seperti berikut terjadi:
+ Peristiwa throttling untuk Amazon DynamoDB terjadi, atau performa volume Amazon EBS telah terdegradasi.
+ Grup Amazon EC2 Auto Scaling gagal meluncurkan node, atau alur kerja Otomasi Manajer Sistem gagal.
+ Instans EC2 mengubah tahapan dari `Running` ke `Stopped`.
**Run Command contoh**
Anda dapat mengonfigurasi EventBridge aturan untuk menjalankan dokumen Command Systems Manager Run Command ketika peristiwa seperti berikut terjadi:
+ Ketika grup Auto Scaling akan berakhir, Run Command skrip dapat menangkap file log dari node sebelum berakhir.
+ Ketika node baru dibuat dalam grup Auto Scaling, tindakan Run Command target dapat mengaktifkan peran server web atau menginstal perangkat lunak pada node.
+ Ketika node terkelola ditemukan tidak sesuai, tindakan Run Command target dapat memperbarui tambalan pada node dengan menjalankan `AWS-RunPatchBaseline` dokumen.