CloudWatch Log - AWS IoT Core
PersyaratanPersyaratan format pesan MQTT untuk batchModeParameterContohLihat juga

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

CloudWatch Log

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

Tindakan aturan ini memiliki persyaratan sebagai berikut:

  • Peran IAM yang AWS IoT dapat diasumsikan untuk melakukanlogs:CreateLogStream,logs:DescribeLogStreams, dan logs:PutLogEvents operasi. Untuk informasi selengkapnya, lihat Memberikan AWS IoT aturan akses yang dibutuhkannya.

    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 Panduan Pengguna Amazon CloudWatch Logs.

Persyaratan format pesan MQTT untuk batchMode

Jika Anda menggunakan tindakan aturan CloudWatch Log dengan batchMode dimatikan, tidak ada persyaratan pemformatan pesan MQTT. (Catatan: nilai default batchMode parameter adalahfalse.) Namun, jika Anda menggunakan tindakan aturan CloudWatch Log dengan batchMode diaktifkan (nilai parameternyatrue), 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.

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.

Parameter

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: API dan hanya AWS CLI

roleArn

Peran IAM yang memungkinkan akses ke grup CloudWatch log. Untuk informasi selengkapnya, lihat Persyaratan.

Mendukung template substitusi: 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.

Mendukung template substitusi: Tidak

Contoh

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