Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# CloudWatch Log
<a name="cloudwatch-logs-rule-action"></a>

Tindakan CloudWatch Logs (`cloudwatchLogs`) mengirimkan data ke Amazon CloudWatch Logs. Anda dapat menggunakan `batchMode` untuk mengunggah dan stempel waktu beberapa catatan log perangkat dalam satu pesan. Anda juga dapat menentukan grup log tempat tindakan mengirim data.

## Persyaratan
<a name="cloudwatch-logs-rule-action-requirements"></a>

Tindakan aturan ini memiliki persyaratan sebagai berikut:
+ Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan`logs:CreateLogStream`,`logs:DescribeLogStreams`, dan `logs:PutLogEvents` operasi. Untuk informasi selengkapnya, lihat [Memberikan AWS IoT aturan akses yang dibutuhkannya](iot-create-role.md).

  Di AWS IoT konsol, Anda dapat memilih atau membuat peran untuk memungkinkan AWS IoT untuk melakukan tindakan aturan ini.
+ Jika Anda menggunakan pelanggan yang dikelola AWS KMS key (kunci KMS) untuk mengenkripsi data CloudWatch log di Log, layanan harus memiliki izin untuk menggunakan kunci KMS atas nama pemanggil. Untuk informasi selengkapnya, lihat [Mengenkripsi data CloudWatch log di Log menggunakan AWS KMS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/encrypt-log-data-kms.html) *Panduan Pengguna Amazon CloudWatch Logs*.

## Persyaratan format pesan MQTT untuk `batchMode`
<a name="cloudwatch-logs-rule-action-message-format"></a>

Jika Anda menggunakan tindakan aturan CloudWatch Log dengan `batchMode` dimatikan, tidak ada persyaratan pemformatan pesan MQTT. (Catatan: nilai default `batchMode` parameter adalah`false`.) Namun, jika Anda menggunakan tindakan aturan CloudWatch Log dengan `batchMode` diaktifkan (nilai parameternya`true`), pesan MQTT yang berisi log sisi perangkat harus diformat agar berisi stempel waktu dan muatan pesan. **Catatan:** `timestamp` mewakili waktu terjadinya peristiwa dan dinyatakan sebagai sejumlah milidetik setelah 1 Januari 1970 00:00:00 UTC.

Berikut ini adalah contoh format publikasi:

```
[
  {"timestamp": 1673520691093, "message": "Test message 1"}, 
  {"timestamp": 1673520692879, "message": "Test message 2"}, 
  {"timestamp": 1673520693442, "message": "Test message 3"}
]
```

Bergantung pada bagaimana log sisi perangkat dihasilkan, log tersebut mungkin perlu difilter dan diformat ulang sebelum dikirim untuk memenuhi persyaratan ini. Untuk informasi selengkapnya, lihat [Muatan Pesan MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topicdata.html).

Terlepas dari `batchMode` parameter, `message` konten harus mematuhi batasan ukuran AWS IoT pesan. Untuk informasi lebih lanjut, lihat [AWS IoT Core kuota dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/iot-core.html).

## Parameter
<a name="cloudwatch-logs-rule-action-parameters"></a>

Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut:

`logGroupName`  
Grup CloudWatch log tempat tindakan mengirimkan data.  
Mendukung [template substitusi](iot-substitution-templates.md): API dan hanya AWS CLI 

`roleArn`  
Peran IAM yang memungkinkan akses ke grup CloudWatch log. Untuk informasi selengkapnya, lihat [Persyaratan](#cloudwatch-logs-rule-action-requirements).   
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

(opsional) `batchMode`  
 Menunjukkan apakah kumpulan catatan log akan diekstraksi dan diunggah ke dalam. CloudWatch Nilai termasuk `true` atau `false` (default). Untuk informasi selengkapnya, lihat [Persyaratan](#cloudwatch-logs-rule-action-requirements).   
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

## Contoh
<a name="cloudwatch-logs-rule-action-examples"></a>

Contoh JSON berikut mendefinisikan tindakan CloudWatch Log dalam aturan. AWS IoT 

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "cloudwatchLogs": {
                    "logGroupName": "IotLogs",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw",
                    "batchMode": false                    
                }
            }
        ]
    }
}
```

## Lihat juga
<a name="cloudwatch-logs-rule-action-see-also"></a>
+ [Apa itu Amazon CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/) di *Panduan Pengguna CloudWatch Log Amazon*