View a markdown version of this page

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

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

CloudWatch Log

Tind CloudWatch akan Log cloudwatchLogs s () mengirimkan data ke Amazon CloudWatch Logs. Anda dapat menggunakannya batchMode untuk mengunggah dan memberi 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 melakukan logs:PutLogEvents operasilogs:CreateLogStream,logs:DescribeLogStreams, dan. Untuk informasi selengkapnya, lihat Pemberian AWS IoT mengatur akses yang dibutuhkannya.

    Di AWS IoT konsol, Anda dapat memilih atau membuat peran AWS IoT untuk memungkinkan melakukan tindakan aturan ini.

  • Jika Anda menggunakan kunci yang dikelola pelanggan AWS KMS key (kunci KMS) untuk mengenkripsi data CloudWatch log di Log, layanan harus memiliki izin untuk menggunakan kunci KMS atas nama penelepon. Untuk informasi selengkapnya, lihat Mengen kripsi data CloudWatch log AWS KMS di Log menggunakan Panduan CloudWatch Pengguna Amazon Log.

Persyaratan format pesan MQTT untuk BatchMode

Jika Anda menggunakan tindakan aturan CloudWatch Log dengan di batchMode matikan, tidak ada persyaratan pemformatan pesan MQTT. (Catatan: nilai default batchMode parameter adalahfalse.) Namun, jika Anda menggunakan tindakan aturan CloudWatch Log dengan di batchMode aktifkan (nilai parameternya adalahtrue), pesan MQTT yang berisi log sisi perangkat harus diformat untuk berisi stempel waktu dan payload pesan. Catatan: timestamp mewakili waktu peristiwa terjadi dan dinyatakan sebagai jumlah 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 dibuat, log tersebut mungkin perlu disaring dan diformat ulang sebelum dikirim untuk memenuhi persyaratan ini. Untuk informasi selengkapnya, lihat pay https://docs.aws.amazon.com/iot/latest/developerguide/topicdata.html load 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.

Men dukung template substitusi: API dan AWS CLI hanya

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 CloudWatch. Nilai termasuk true atau false (default). Untuk informasi selengkapnya, lihat Persyaratan.

Mendukung template substitusi: Tidak

Contoh

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

{
    "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