Dapatkan pemberitahuan status kesehatan penerapan dan komponen - AWS IoT Greengrass
Acara perubahan status penerapanAcara perubahan status komponenPrasyarat untuk membuat aturan EventBridge Konfigurasikan pemberitahuan kesehatan perangkat (konsol)Konfigurasikan pemberitahuan kesehatan perangkat (CLI)Konfigurasikan pemberitahuan kesehatan perangkat (AWS CloudFormation)Lihat juga

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 Greengrassmengirimkan 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 dan penyebaran serta pemberitahuan komponen. Untuk informasi selengkapnya, lihat Apa itu Amazon EventBridge? di Panduan EventBridge Pengguna Amazon.

Acara perubahan status penerapan

AWS IoT Greengrassmemancarkan peristiwa ketika penerapan memasuki status berikut:FAILED, SUCCEEDED dan. COMPLETED 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 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",
        "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. Peristiwa dimulai ketika penerapan selesai sebagaiFAILED,, SUCCEEDED ATAU. COMPLETED Jika penerapan gagal pada perangkat inti, Anda akan menerima respons terperinci yang menjelaskan mengapa penerapan gagal. Untuk informasi selengkapnya tentang kode kesalahan penerapan, lihatKode kesalahan penyebaran terperinci.

Status penyebaran

  • FAILED. Deployment gagal.

  • SUCCEEDED. Penyebaran yang ditargetkan ke grup sesuatu berhasil diselesaikan.

  • COMPLETED. Penyebaran yang ditargetkan untuk sesuatu yang berhasil diselesaikan.

Ada kemungkinan bahwa peristiwa dapat diduplikasi atau rusak. Untuk menentukan urutan peristiwa, gunakan properti time ini.

Untuk daftar lengkap kode kesalahan di errorStacks danerrorTypes, lihat Kode kesalahan penyebaran terperinci danKode status komponen rinci.

Acara perubahan status komponen

AWS IoT Greengrassmemancarkan peristiwa ketika komponen memasuki status berikut: ERRORED danBROKEN. 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 untuk perubahan status komponen menggunakan format berikut:

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

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, lihatKode status komponen rinci.

Prasyarat untuk membuat aturan EventBridge

Sebelum Anda membuat EventBridge aturan untukAWS 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)

    • Fungsi AWS Lambda

    • Amazon Kinesis Video Streams

    • Antrean Amazon Simple Queue Service (Amazon SQS)

Untuk informasi selengkapnya, lihat Apa itu Amazon EventBridge? dan Memulai Amazon EventBridge 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 di Panduan EventBridge Pengguna Amazon.

  1. Buka EventBridgekonsol Amazon.

  2. Di panel navigasi, pilih Aturan.

  3. Pilih Buat aturan.

  4. 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.

  5. 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. Saat layanan AWS di akun Anda menghasilkan peristiwa, layanan tersebut akan selalu masuk ke bus peristiwa default akun Anda.

  6. Untuk Tipe aturan, pilih Aturan dengan pola peristiwa.

  7. Pilih Selanjutnya.

  8. Untuk sumber acara, pilih AWSacara.

  9. Untuk pola Acara, pilih AWSlayanan.

  10. Untuk AWSlayanan, pilih Greengrass.

  11. 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.

  12. Pilih Berikutnya.

  13. Untuk Jenis Target, pilih Layanan AWS.

  14. 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.

    2. Untuk Topik, pilih topik target Anda.

    3. Pilih Selanjutnya.

  15. Pilih Selanjutnya.

  16. 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.

  2. Tambahkan topik sebagai target aturan.

    • Ganti topik-arn dengan ARN dari 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 Pengguna Amazon EventBridge .

Untuk informasi selengkapnya, lihat Peristiwa dan pola acara EventBridge di Panduan EventBridge Pengguna Amazon.

Konfigurasikan pemberitahuan kesehatan perangkat (AWS CloudFormation)

Gunakan AWS 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 di Panduan AWS CloudFormation Pengguna.

Lihat juga