Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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:
-
IAMPeran yang AWS IoT dapat diasumsikan untuk melakukan
logs:CreateLogStream
,logs:DescribeLogStreams
, danlogs: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 AWS KMS key (KMSkunci) yang dikelola pelanggan untuk mengenkripsi data CloudWatch log di Log, layanan harus memiliki izin untuk menggunakan KMS kunci atas nama pemanggil. Untuk informasi selengkapnya, lihat Mengenkripsi data CloudWatch log di Log menggunakan AWS KMS Panduan Pengguna Amazon CloudWatch Logs.
MQTTpersyaratan format pesan untuk batchMode
Jika Anda menggunakan tindakan aturan CloudWatch Log dengan batchMode
dimatikan, tidak ada persyaratan pemformatan MQTT pesan. (Catatan: nilai default batchMode
parameter adalahfalse
.) Namun, jika Anda menggunakan tindakan aturan CloudWatch Log dengan batchMode
diaktifkan (nilai parameternyatrue
), MQTT pesan 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:00UTC.
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 Payload MQTT pesan.
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
-
IAMPeran 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
ataufalse
(default). Untuk informasi selengkapnya, lihat Persyaratan.Mendukung template substitusi: Tidak
Contoh
JSONContoh berikut mendefinisikan tindakan CloudWatch Log 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
-
Apa itu Amazon CloudWatch Logs? di Panduan Pengguna CloudWatch Log Amazon