Mengatur CloudWatch Log untuk pembaruan OTA

Layanan Pembaruan OTA mendukung pencatatan dengan AmazonCloudWatch. Anda dapat menggunakan AWS IoT konsol untuk mengaktifkan dan mengonfigurasi CloudWatch pencatatan Amazon untuk pembaruan OTA. Untuk informasi selengkapnya, lihat Log Cloudwatch.

Untuk mengaktifkan logging, Anda harus membuat peran IAM dan mengkonfigurasi pencatatan pembaruan OTA.

catatan

Sebelum Anda mengaktifkan pencatatan pembaruan OTA, pastikan Anda memahami izin akses CloudWatch Log. Pengguna dengan akses ke CloudWatch Log dapat melihat informasi debugging Anda. Untuk informasi, lihat Autentikasi dan Kontrol Akses untuk CloudWatch Log Amazon.

Buat peran logging dan aktifkan logging

Gunakan AWS IoTkonsol untuk membuat peran logging dan mengaktifkan logging.

1. Dari panel navigasi, pilih Pengaturan.

2. Di bawah Log, pilih Edit.

3. Di bawah Level verbositas, pilih Debug.

4. Di bawah Tetapkan peran, pilih Buat baru untuk membuat peran IAM untuk dicatat.

5. Di bawah Nama, masukkan nama unik untuk peran Anda. Peran Anda akan dibuat dengan semua izin yang diperlukan.

6. Pilih Update (Perbarui).

Log pembaruan OTA

Layanan Pembaruan OTA menerbitkan log ke akun Anda ketika salah satu dari hal berikut terjadi:

• Pembaruan OTA dibuat.

• Pembaruan OTA selesai.

• Pekerjaan penandatanganan kode dibuat.

• Pekerjaan penandatanganan kode selesai.

• Sebuah AWS IoT pekerjaan dibuat.

• Sebuah AWS IoT pekerjaan selesai.

• Aliran dibuat.

Anda dapat melihat log Anda di CloudWatchkonsol.

Untuk melihat pembaruan OTA di CloudWatch Log

1. Dari panel navigasi, pilih Log.

2. Di Grup Log, pilih AWSIoTLogsV2.

Log pembaruan OTA dapat berisi properti berikut:

accountId

ID AWS akun di mana log dihasilkan.

ActionType

Tindakan yang dihasilkan log. Ini dapat diatur ke salah satu nilai berikut:

• CreateOTAUpdate: Pembaruan OTA telah dibuat.

• DeleteOTAUpdate: Pembaruan OTA telah dihapus.

• StartCodeSigning: Pekerjaan penandatanganan kode dimulai.

• CreateAWSJob: AWS IoT Pekerjaan telah dibuat.

• CreateStream: Aliran telah dibuat.

• GetStream: Permintaan untuk aliran dikirim ke fitur pengiriman file AWS IoT berbasis MQTT.

• DescribeStream: Permintaan informasi tentang aliran dikirim ke fitur pengiriman file AWS IoT berbasis MQTT.

awsJobId

ID AWS IoT pekerjaan yang dihasilkan log.

clientId

ID klien MQTT yang membuat permintaan yang dihasilkan log.

ClientToken

Token klien yang terkait dengan permintaan yang dihasilkan log.

detail

Informasi lebih lanjut tentang operasi yang dihasilkan log.

LogLevel

Tingkat logging log. Untuk log pembaruan OTA, ini selalu diatur keDEBUG.

otaUpdateId

ID pembaruan OTA yang menghasilkan log.

protokol

Protokol yang digunakan untuk membuat permintaan yang dihasilkan log.

status

Status operasi yang dihasilkan log. Nilai yang valid adalah:

• Berhasil

• Kegagalan

StreamID

ID AWS IoT aliran yang dihasilkan log.

timestamp

Waktu ketika log dihasilkan.

Nama Topik

Topik MQTT yang digunakan untuk membuat permintaan yang dihasilkan log.

Contoh log

Berikut ini adalah contoh log yang dihasilkan saat pekerjaan penandatanganan kode dimulai:

{ 
    "timestamp": "2018-07-23 22:59:44.955", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "StartCodeSigning", 
    "otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a", 
    "details": "Start code signing job. The request status is SUCCESS." 
}

Berikut ini adalah contoh log yang dihasilkan saat AWS IoT pekerjaan dibuat:

{ 
    "timestamp": "2018-07-23 22:59:45.363", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "CreateAWSJob", 
    "otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a", 
    "awsJobId": "08957b03-eea3-448a-87fe-743e6891ca3a", 
    "details": "Create AWS Job The request status is SUCCESS." 
}

Berikut ini adalah contoh log yang dihasilkan saat pembaruan OTA dibuat:

{ 
    "timestamp": "2018-07-23 22:59:45.413", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "CreateOTAUpdate", 
    "otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a", 
    "details": "OTAUpdate creation complete. The request status is SUCCESS." 
}

Berikut ini adalah contoh log yang dihasilkan saat aliran dibuat:

{ 
    "timestamp": "2018-07-23 23:00:26.391", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "CreateStream", 
    "otaUpdateId": "3d3dc5f7-3d6d-47ac-9252-45821ac7cfb0", 
    "streamId": "6be2303d-3637-48f0-ace9-0b87b1b9a824", 
    "details": "Create stream. The request status is SUCCESS." 
}

Berikut ini adalah contoh log yang dihasilkan saat pembaruan OTA dihapus:

{ 
    "timestamp": "2018-07-23 23:03:09.505", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "DeleteOTAUpdate", 
    "otaUpdateId": "9bdd78fb-f113-4001-9675-1b595982292f", 
    "details": "Delete OTA Update. The request status is SUCCESS." 
}

Berikut ini adalah contoh log yang dihasilkan saat perangkat meminta aliran dari fitur pengiriman file berbasis MQTT:

{ 
    "timestamp": "2018-07-25 22:09:02.678", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "GetStream", 
    "protocol": "MQTT", 
    "clientId": "b9d2e49c-94fe-4ed1-9b07-286afed7e4c8", 
    "topicName": "$aws/things/b9d2e49c-94fe-4ed1-9b07-286afed7e4c8/streams/1e51e9a8-9a4c-4c50-b005-d38452a956af/get/json", 
    "streamId": "1e51e9a8-9a4c-4c50-b005-d38452a956af", 
    "details": "The request status is SUCCESS." 
}

Berikut ini adalah contoh log yang dihasilkan saat perangkat memanggil DescribeStream API:

{ 
    "timestamp": "2018-07-25 22:10:12.690", 
    "logLevel": "DEBUG", 
    "accountId": "123456789012", 
    "status": "Success", 
    "actionType": "DescribeStream", 
    "protocol": "MQTT", 
    "clientId": "581075e0-4639-48ee-8b94-2cf304168e43", 
    "topicName": "$aws/things/581075e0-4639-48ee-8b94-2cf304168e43/streams/71c101a8-bcc5-4929-9fe2-af563af0c139/describe/json", 
    "streamId": "71c101a8-bcc5-4929-9fe2-af563af0c139", 
    "clientToken": "clientToken", 
    "details": "The request status is SUCCESS." 
}