Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Dapatkan pemberitahuan status kesehatan penerapan dan komponen
Aturan EventBridge acara Amazon memberi Anda pemberitahuan tentang perubahan status untuk penerapan Greengrass yang diterima oleh perangkat Anda dan untuk komponen yang diinstal pada perangkat Anda. EventBridge memberikan aliran peristiwa sistem yang mendekati real-time yang menjelaskan perubahan AWS sumber daya. AWS IoT Greengrass mengirimkan acara ini ke EventBridge atas dasar *upaya terbaik*. Ini berarti bahwa AWS IoT Greengrass upaya untuk mengirim semua acara ke EventBridge tetapi, dalam beberapa kasus yang jarang terjadi, suatu peristiwa mungkin tidak disampaikan. Selain itu, AWS IoT Greengrass mungkin mengirim beberapa salinan dari peristiwa tertentu, yang berarti bahwa pendengar acara Anda mungkin tidak menerima peristiwa dalam urutan kejadian terjadi.
**catatan**
Amazon EventBridge adalah layanan bus acara yang dapat Anda gunakan untuk menghubungkan aplikasi Anda dengan data dari berbagai sumber, seperti perangkat [inti Greengrass](telemetry.md) dan penyebaran serta pemberitahuan komponen. Untuk informasi selengkapnya, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) di *Panduan EventBridge Pengguna Amazon*.
**Topics**
+ [Acara perubahan status penerapan](#deployment.events-message-format)
+ [Acara perubahan status komponen](#component.events-message-format)
+ [Prasyarat untuk membuat aturan EventBridge](#create-events-rule-prereqs)
+ [Konfigurasikan pemberitahuan kesehatan perangkat (konsol)](#create-events-rule-console)
+ [Konfigurasikan pemberitahuan kesehatan perangkat (CLI)](#create-events-rule-cli)
+ [Konfigurasikan pemberitahuan kesehatan perangkat (CloudFormation)](#create-events-rule-cloudformation)
+ [Lihat juga](#deployment-notifications-see-also)
## Acara perubahan status penerapan
AWS IoT Greengrass memancarkan peristiwa ketika penerapan memasuki status berikut:`FAILED`,,, `SUCCEEDED` `COMPLETED``REJECTED`, dan. `CANCELED` Anda dapat membuat EventBridge aturan yang berjalan untuk semua transisi status atau transisi ke status yang Anda tentukan. Saat penerapan memasuki status yang memulai aturan, EventBridge memanggil tindakan target yang ditentukan dalam aturan. Hal ini mengizinkan Anda untuk mengirim pemberitahuan, menangkap informasi peristiwa, mengambil tindakan korektif, atau menginisiasi peristiwa lain untuk merespon perubahan keadaan. Sebagai contoh, Anda dapat membuat aturan untuk kasus penggunaan berikut:
+ Memulai operasi pasca deployment, seperti mengunduh aset dan memberi tahu personil.
+ Kirim pemberitahuan setelah deployment berhasil atau gagal.
+ Terbitkankan metrik kustom tentang peristiwa deployment.
[peristiwa](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) untuk perubahan keadaan deployment menggunakan format berikut:
```
{
"version":"0",
"id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
"detail-type":"Greengrass V2 Effective Deployment Status Change",
"source":"aws.greengrass",
"account":"123456789012",
"region":"us-west-2",
"time":"2018-03-22T00:38:11Z",
"resources":["arn:aws:greengrass:us-east-1:123456789012:coreDevices:MyGreengrassCore"],
"detail":{
"deploymentId": "4f38f1a7-3dd0-42a1-af48-EXAMPLE09681",
"coreDeviceExecutionStatus": "FAILED|SUCCEEDED|COMPLETED|REJECTED|CANCELED",
"statusDetails": {
"errorStack": ["DEPLOYMENT_FAILURE", "ARTIFACT_DOWNLOAD_ERROR", "S3_ERROR", "S3_ACCESS_DENIED", "S3_HEAD_OBJECT_ACCESS_DENIED"],
"errorTypes": ["DEPENDENCY_ERROR", "PERMISSION_ERROR"],
},
"reason": "S3_HEAD_OBJECT_ACCESS_DENIED: FAILED_NO_STATE_CHANGE: Failed to download artifact name: 's3://pentest27/nucleus/281/aws.greengrass.nucleus.zip' for component aws.greengrass.Nucleus-2.8.1, reason: S3 HeadObject returns 403 Access Denied. Ensure the IAM role associated with the core device has a policy granting s3:GetObject. null (Service: S3, Status Code: 403, Request ID: HR94ZNT2161DAR58, Extended Request ID: wTX4DDI+qigQt3uzwl9rlnQiYlBgwvPm/KJFWeFAn9t1mnGXTms/luLCYANgq08RIH+x2H+hEKc=)"
}
}
```
Anda dapat membuat aturan dan acara yang akan memperbarui Anda tentang status penerapan. Sebuah peristiwa dimulai ketika penerapan selesai sebagai salah satu`FAILED`,,, `SUCCEEDED``COMPLETED`, `REJECTED` atau. `CANCELED` Jika penerapan gagal pada perangkat inti, Anda akan menerima respons terperinci yang menjelaskan mengapa penerapan gagal. Untuk informasi selengkapnya tentang kode kesalahan penerapan, lihat[Kode kesalahan penyebaran terperinci](troubleshooting-deployment.md).
**Status penyebaran**
+ `FAILED`. Deployment gagal.
+ `SUCCEEDED`. Penyebaran yang ditargetkan ke grup sesuatu berhasil diselesaikan.
+ `COMPLETED`. Penyebaran yang ditargetkan untuk sesuatu yang berhasil diselesaikan.
+ `REJECTED`. Penyebaran ditolak. Untuk informasi lebih lanjut, lihat `statusDetails` bidangnya.
+ `CANCELED`. Penerapan dibatalkan oleh pengguna.
Ada kemungkinan bahwa peristiwa dapat diduplikasi atau rusak. Untuk menentukan urutan peristiwa, gunakan properti `time` ini.
Untuk daftar lengkap kode kesalahan di `errorStacks` dan`errorTypes`, lihat [Kode kesalahan penyebaran terperinci](troubleshooting-deployment.md) dan[Kode status komponen terperinci](troubleshooting-component.md).
## Acara perubahan status komponen
Untuk AWS IoT Greengrass versi 2.12.2 dan versi sebelumnya, Greengrass memancarkan peristiwa saat komponen memasuki status berikut: dan. `ERRORED` `BROKEN` Untuk Greengrass nucleus versi 2.12.3 dan yang lebih baru, Greengrass memancarkan peristiwa ketika komponen memasuki status berikut:,,, dan. `ERRORED` `BROKEN` `RUNNING` `FINISHED` Greengrass juga akan memancarkan peristiwa saat penerapan selesai. Anda dapat membuat EventBridge aturan yang berjalan untuk semua transisi status atau transisi ke status yang Anda tentukan. Ketika komponen yang diinstal memasuki status yang memulai aturan, EventBridge memanggil tindakan target yang ditentukan dalam aturan. Hal ini mengizinkan Anda untuk mengirim pemberitahuan, menangkap informasi peristiwa, mengambil tindakan korektif, atau menginisiasi peristiwa lain untuk merespon perubahan keadaan.
[Acara](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) untuk perubahan status komponen menggunakan format berikut:
------
#### [ Greengrass nucleus v2.12.2 and earlier ]
Status komponen: `ERRORED` atau `BROKEN`
```
{
"version":"0",
"id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
"detail-type":"Greengrass V2 Installed Component Status Change",
"source":"aws.greengrass",
"account":"123456789012",
"region":"us-west-2",
"time":"2018-03-22T00:38:11Z",
"resources":["arn:aws:greengrass:us-east-1:123456789012:coreDevices:MyGreengrassCore"],
"detail": {
"components": [
{
"componentName": "MyComponent",
"componentVersion": "1.0.0",
"root": true,
"lifecycleState": "ERRORED|BROKEN",
"lifecycleStatusCodes": ["STARTUP_ERROR"],
"lifecycleStateDetails": "An error occurred during startup. The startup script exited with code 1."
}
]
}
}
```
------
#### [ Greengrass nucleus v2.12.3 and later ]
Status komponen: `ERRORED` atau `BROKEN`
```
{
"version":"0",
"id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
"detail-type":"Greengrass V2 Installed Component Status Change",
"source":"aws.greengrass",
"account":"123456789012",
"region":"us-west-2",
"time":"2018-03-22T00:38:11Z",
"resources":["arn:aws:greengrass:us-east-1:123456789012:coreDevices:MyGreengrassCore"],
"detail": {
"components": [
{
"componentName": "MyComponent",
"componentVersion": "1.0.0",
"root": true,
"lifecycleState": "ERRORED|BROKEN",
"lifecycleStatusCodes": ["STARTUP_ERROR"],
"lifecycleStateDetails": "An error occurred during startup. The startup script exited with code 1."
}
]
}
}
```
Status komponen: `RUNNING` atau `FINISHED`
```
{
"version":"0",
"id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
"detail-type":"Greengrass V2 Installed Component Status Change",
"source":"aws.greengrass",
"account":"123456789012",
"region":"us-west-2",
"time":"2018-03-22T00:38:11Z",
"resources":["arn:aws:greengrass:us-east-1:123456789012:coreDevices:MyGreengrassCore"],
"detail": {
"components": [
{
"componentName": "MyComponent",
"componentVersion": "1.0.0",
"root": true,
"lifecycleState": "RUNNING|FINISHED",
"lifecycleStateDetails": null
}
]
}
}
```
------
Anda dapat membuat aturan dan acara yang akan memperbarui Anda tentang status komponen yang diinstal. Peristiwa dimulai saat komponen mengubah status pada perangkat. Anda akan menerima tanggapan terperinci yang menjelaskan mengapa suatu komponen salah atau rusak. Anda juga akan menerima kode status yang akan menunjukkan alasan kegagalan tersebut. Untuk informasi selengkapnya tentang kode status komponen, lihat[Kode status komponen terperinci](troubleshooting-component.md).
## Prasyarat untuk membuat aturan EventBridge
Sebelum Anda membuat EventBridge aturan untuk AWS IoT Greengrass, lakukan hal berikut:
+ Biasakan diri Anda dengan acara, aturan, dan target di EventBridge.
+ Buat dan konfigurasikan target yang dipanggil oleh EventBridge aturan Anda. Aturan dapat menginvokasi berbagai jenis target, termasuk:
+ Amazon Simple Notification Service (Amazon SNS)
+ AWS Lambda fungsi
+ Amazon Kinesis Video Streams
+ Antrean Amazon Simple Queue Service (Amazon SQS)
Untuk informasi selengkapnya, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) dan [Memulai dengan Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) di *Panduan EventBridge Pengguna Amazon*.
## Konfigurasikan pemberitahuan kesehatan perangkat (konsol)
Gunakan langkah-langkah berikut untuk membuat EventBridge aturan yang menerbitkan topik Amazon SNS saat status penerapan berubah untuk grup. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut. Untuk informasi selengkapnya, lihat [Membuat EventBridge aturan yang memicu peristiwa dari AWS sumber daya](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) di *Panduan EventBridge Pengguna Amazon*.
1. Buka [ EventBridgekonsol Amazon](https://console.aws.amazon.com/events/).
1. Di panel navigasi, pilih **Aturan**.
1. Pilih **Buat aturan**.
1. Masukkan nama dan deskripsi untuk aturan.
Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus kejadian yang sama.
1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan acara yang berasal dari akun Anda, pilih **bus acara AWS default**. Ketika AWS layanan di akun Anda memancarkan suatu 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**.
1. Untuk **pola Acara**, pilih **AWS layanan**.
1. Untuk **AWS layanan**, pilih Greengrass.
1. Untuk **jenis Acara**, pilih dari berikut ini:
+ Untuk peristiwa penerapan, pilih **Greengrass** V2 Perubahan Status Penerapan Efektif.
+ Untuk event komponen, pilih **Greengrass** V2 Installed Component Status Change.
1. Pilih **Berikutnya**.
1. Untuk **Jenis target**, pilih **Layanan AWS **.
1. Untuk **Pilih target**, konfigurasikan target Anda. Contoh ini menggunakan topik Amazon SNS, tetapi Anda dapat mengonfigurasi tipe target lain untuk mengirim pemberitahuan.
1. Untuk **Target**, pilih **topik SNS**.
1. Untuk **Topik**, pilih topik target Anda.
1. Pilih **Berikutnya**.
1. Pilih **Berikutnya**.
1. Tinjau detail aturan dan pilih **Buat aturan**.
## Konfigurasikan pemberitahuan kesehatan perangkat (CLI)
Gunakan langkah-langkah berikut untuk membuat EventBridge aturan yang menerbitkan topik Amazon SNS saat ada peristiwa perubahan status Greengrass. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut.
1. Buat aturan.
+ Untuk peristiwa perubahan status penerapan.
```
aws events put-rule \
--name TestRule \
--event-pattern "{\"source\": [\"aws.greengrass\"], \"detail-type\": [\"Greengrass V2 Effective Deployment Status Change\"]}"
```
+ Untuk peristiwa perubahan status komponen.
```
aws events put-rule \
--name TestRule \
--event-pattern "{\"source\": [\"aws.greengrass\"], \"detail-type\": [\"Greengrass V2 Installed Component Status Change\"]}"
```
Properti yang dihilangkan dari tersebut pola akan diabaikan.
1. Tambahkan topik sebagai target aturan.
+ Ganti *topic-arn* dengan ARN topik Amazon SNS Anda.
```
aws events put-targets \
--rule TestRule \
--targets "Id"="1","Arn"="topic-arn"
```
**catatan**
Untuk mengizinkan Amazon EventBridge memanggil topik target Anda, Anda harus menambahkan kebijakan berbasis sumber daya ke topik Anda. Untuk informasi selengkapnya, lihat [izin Amazon SNS di Panduan](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sns-permissions) Pengguna *Amazon EventBridge *.
Untuk informasi selengkapnya, lihat [Peristiwa dan pola acara EventBridge di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Panduan EventBridge Pengguna Amazon*.
## Konfigurasikan pemberitahuan kesehatan perangkat (CloudFormation)
Gunakan CloudFormation templat untuk membuat EventBridge aturan yang mengirim pemberitahuan tentang perubahan status untuk penerapan grup Greengrass Anda. Untuk informasi selengkapnya, lihat [referensi jenis EventBridge sumber daya Amazon](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Events.html) di *Panduan AWS CloudFormation Pengguna*.
## Lihat juga
+ [Periksa status deployment perangkat](check-deployment-status.md#check-device-deployment-status)
+ [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) di *Panduan EventBridge Pengguna Amazon*