Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan CloudWatch Log untuk pembaruan OTA
Layanan Pembaruan OTA mendukung pencatatan dengan Amazon CloudWatch. Anda dapat menggunakan AWS IoT konsol untuk mengaktifkan dan mengonfigurasi CloudWatch pencatatan Amazon untuk pembaruan OTA. Untuk informasi selengkapnya, lihat Log [Cloudwatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html).
Untuk mengaktifkan logging, Anda harus membuat peran IAM dan mengonfigurasi logging 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 selengkapnya, lihat [Otentikasi dan Kontrol Akses untuk CloudWatch Log Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/auth-and-access-control-cwl.html).
## Buat peran logging dan aktifkan logging
Gunakan [AWS IoT konsol](https://console.aws.amazon.com/iot/home) untuk membuat peran logging dan mengaktifkan logging.
1. Dari panel navigasi, pilih **Pengaturan**.
1. Di bawah **Log**, pilih **Edit**.
1. **Di bawah **Tingkat verbositas**, pilih Debug.**
1. Di bawah **Tetapkan peran**, pilih **Buat baru** untuk membuat peran IAM untuk logging.
1. Di bawah **Nama**, masukkan nama unik untuk peran Anda. Peran Anda akan dibuat dengan semua izin yang diperlukan.
1. Pilih **Perbarui**.
## Log pembaruan OTA
Layanan Pembaruan OTA menerbitkan log ke akun Anda ketika salah satu 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 [CloudWatch konsol.](https://console.aws.amazon.com/cloudwatch/home)
**Untuk melihat pembaruan OTA di CloudWatch Log**
1. Dari panel navigasi, pilih **Log**.
1. Di **Grup Log**, pilih **AWSIoTLogsV2**.
Log pembaruan OTA dapat berisi properti berikut:
**accountId**
ID AWS akun tempat log dibuat.
**actionType**
Tindakan yang menghasilkan 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`: Sebuah 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 menghasilkan log.
**clientId**
ID klien MQTT yang membuat permintaan yang menghasilkan log.
**clientToken**
Token klien terkait dengan permintaan yang menghasilkan log.
**detail**
Informasi lebih lanjut tentang operasi yang menghasilkan log.
**logLevel**
Tingkat logging log. Untuk log pembaruan OTA, ini selalu disetel ke`DEBUG`.
**otaUpdateId**
ID pembaruan OTA yang menghasilkan log.
**protokol**
Protokol yang digunakan untuk membuat permintaan yang menghasilkan log.
**status**
Status operasi yang menghasilkan log. Nilai yang valid adalah:
+ Berhasil
+ Kegagalan
**streamId**
ID AWS IoT aliran yang menghasilkan log.
**timestamp**
Waktu ketika log dihasilkan.
**topicName**
Topik MQTT yang digunakan untuk membuat permintaan yang menghasilkan 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 ketika 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."
}
```