Konfigurasikan AWS IoT logging

1. Di bawah Pilih entitas tepercaya, pilih AWS Layanan. Kemudian pilih IoT di bawah Kasus penggunaan. Jika Anda tidak melihat IoT, masukkan dan cari IoT dari menu tarik-turun Kasus penggunaan untuk AWS layanan lain:. Pilih Selanjutnya.

2. Pada halaman Tambahkan izin, Anda akan melihat kebijakan yang secara otomatis dilampirkan ke peran layanan. Pilih Berikutnya.

3. Pada halaman Nama, tinjau, dan buat, masukkan nama Peran dan Deskripsi peran untuk peran tersebut, lalu pilih Buat peran.

Untuk mengkonfigurasi AWS IoT logging:

1. Masuk ke AWS IoT konsol. Untuk informasi selengkapnya, lihat Buka AWS IoT konsol.

2. Di panel navigasi kiri, pilih Log (sebelumnya bagian di bawah Pengaturan).

3. Konfigurasi pencatatan tingkat akun: pencatatan tingkat akun berlaku untuk semua AWS IoT armada Anda (perangkat atau titik akhir), kecuali diganti dengan pengaturan tingkat peristiwa atau khusus sumber daya.

   1. Di bawah Pencatatan tingkat akun, pilih Kelola pencatatan tingkat akun untuk melakukan pembaruan.

   2. Pilih kotak centang “Aktifkan pencatatan” untuk mulai mengirim log ke CloudWatch. Ketika “Aktifkan logging” tidak dicentang, tidak AWS IoT akan mengirim log apa pun ke grup CloudWatch log, terlepas dari konfigurasi logging tingkat peristiwa atau sumber daya.

   3. Di bawah peran log IAM, pilih peran yang ada dari daftar tarik-turun. Anda dapat Melihat detail peran untuk memeriksa izin peran. Atau, pilih Buat peran baru untuk menyiapkan peran IAM baru. Peran logging menyediakan kebijakan yang memungkinkan AWS IoT untuk mengirimkan entri log atas nama Anda. CloudWatch Jika Anda mengonfigurasi pencatatan tingkat peristiwa dengan grup CloudWatch log kustom, Anda harus memperbarui kebijakan peran untuk menyertakan ARN untuk grup log ini.

   4. Pilih tingkat Log Default yang sesuai dengan tingkat detail entri log yang ingin Anda tampilkan di CloudWatch Log. Catatan: Tingkat log “DEBUG” memberikan detail paling banyak tetapi meningkatkan CloudWatch biaya. CloudWatch Tujuan grup log tidak dapat dikonfigurasi di tingkat akun. Namun, Anda dapat menentukan grup log kustom untuk masing-masing jenis peristiwa seperti yang dijelaskan di bagian berikut.

   5. Pilih Perbarui logging untuk menyimpan perubahan Anda.

4. Pencatatan tingkat peristiwa memungkinkan Anda untuk secara selektif menangkap log untuk peristiwa yang relevan dan mengarahkannya ke grup log khusus CloudWatch . Ini memberi Anda fleksibilitas untuk mengatur log berdasarkan kasus penggunaan agar dapat ditemukan dengan lebih baik, membagikannya dengan audiens yang berbeda, dan mengurangi CloudWatch biaya dengan mengaktifkan log dan menetapkan tingkat log berdasarkan kekritisan peristiwa.

   Konfigurasi pencatatan tingkat peristiwa: pencatatan tingkat peristiwa menangkap AWS IoT peristiwa tertentu, seperti upaya otentikasi klien. Pengaturan ini mengesampingkan Pencatatan Tingkat Akun.

   1. Di bawah bagian Pencatatan tingkat peristiwa, pilih Kelola pencatatan tingkat peristiwa untuk melakukan pembaruan.

   2. Secara default, tipe acara mewarisi konfigurasi logging tingkat akun. Catatan: Saat logging khusus sumber daya dikonfigurasi, pencatatan akan mengganti pengaturan tingkat akun dan peristiwa.

   3. Untuk mengubah pengaturan untuk setiap peristiwa, klik nilai di baris peristiwa yang sesuai. Anda dapat menyesuaikan tingkat log dan tujuan grup CloudWatch log. Saat menentukan tujuan grup CloudWatch log kustom, Anda harus memverifikasi bahwa kebijakan peran IAM menyertakan izin untuk grup log baru. Kegagalan untuk memperbarui kebijakan peran akan AWS IoT mencegah penulisan log ke grup log kustom. Setelah membuat pilihan Anda, klik tanda centang untuk mengonfirmasi pilihan Anda. Kolom 'Is Modified' akan menampilkan 'Ya' untuk menunjukkan perubahan yang tertunda.

   4. Klik Perbarui Logging untuk menerapkan perubahan Anda atau pilih Batalkan untuk membuang.

5. Konfigurasi penggantian khusus Sumber Daya: Penggantian khusus sumber daya menerapkan setelan logging ke sumber daya yang dipilih. Sumber daya dapat berupa grup benda, IP sumber, ID klien, atau ID utama. Konfigurasi logging khusus sumber daya mengesampingkan pengaturan tingkat akun dan tingkat peristiwa. Saat diaktifkan, ini menghasilkan log untuk semua jenis peristiwa pada tingkat logging yang dikonfigurasi untuk sumber daya yang ditentukan. Misalnya, Anda dapat mengatur logging tingkat debug untuk Hal tertentu sambil menyimpan pencatatan tingkat info untuk semua Hal lainnya.

   1. Pilih Tambahkan penggantian khusus sumber daya di bagian penggantian khusus sumber daya.

   2. Pilih target log: Thing group, Source IP, Client ID atau Principal ID.

   3. Masukkan nilai target log yang sesuai untuk jenis target yang Anda pilih.

   4. Pilih level log yang diinginkan dari menu tarik-turun di bagian tingkat log khusus sumber daya.

   5. Klik Kirim untuk menambahkan penggantian atau Batalkan untuk membuang perubahan.

   6. Untuk mengubah penggantian khusus sumber daya yang ada, pilih kotak centang di sebelah sumber daya dan klik “Hapus” untuk menghapus penggantian atau “Edit” untuk memodifikasi.

Untuk menggunakan CLI untuk mengonfigurasi logging default untuk AWS IoT

1. Gunakan set-v2-logging-optionsperintah untuk mengatur opsi pencatatan untuk akun Anda.

   aws iot set-v2-logging-options \
       --event-configurations event-configuration-list \
       --role-arn logging-role-arn \
       --default-log-level log-level

   di mana:

   --role-arn

   Peran ARN yang memberikan AWS IoT izin untuk menulis ke log Anda di Log. CloudWatch Konfigurasi role-ARN diperlukan untuk pengaturan awal.

   --default-log-level

   Level log yang akan digunakan. Nilai yang valid adalah:ERROR,WARN,INFO,DEBUG, atauDISABLED. Default-log-levelkonfigurasi diperlukan untuk pengaturan awal.

   --no-disable-all-logs

   Parameter opsional yang memungkinkan semua AWS IoT logging. Gunakan parameter ini untuk mengaktifkan logging saat saat ini dinonaktifkan.

   --disable-all-logs

   Parameter opsional yang menonaktifkan semua AWS IoT logging. Gunakan parameter ini untuk menonaktifkan logging saat saat ini diaktifkan.

   --event-configurations

   Parameter ini opsional dan memungkinkan Anda untuk menyesuaikan pengaturan logging untuk masing-masing jenis acara:

   • EventType: Jenis peristiwa yang menggantikan setelan tingkat akun

   • LogLevel: Ganti pengaturan tingkat akun dengan DEBUG, INFO, ERROR, WARN, atau DISABLED

   • LogDestination: Tentukan grup CloudWatch log kustom untuk pengiriman log

   Anda dapat mengonfigurasi tingkat pencatatan dan tujuan log secara independen untuk setiap jenis acara. Jika tidak ditentukan, peristiwa akan mewarisi pengaturan tingkat akun

   aws iot set-v2-logging-options \
       --event-configurations "[{\"eventType\":\"Publish-In\",\"logLevel\":\"INFO\",\"logDestination\":\"examplePublishInLogGroup\"}]"

2. Gunakan get-v2-logging-optionsperintah untuk mendapatkan opsi logging Anda saat ini.

   aws iot get-v2-logging-options \
       --verbose

   di mana:

   --verbose

   Parameter opsional yang memungkinkan Anda mengambil semua EventTypes dan konfigurasinya.

Untuk menggunakan CLI untuk mengonfigurasi penggantian khusus Sumber Daya untuk AWS IoT

1. Aktifkan logging tingkat akun sebelum mengonfigurasi logging khusus sumber daya menggunakan perintah berikut: perintah aws iot set-v2-logging-options

2. Gunakan set-v2-logging-levelperintah untuk mengonfigurasi penggantian khusus Sumber Daya. Lihat contoh berikut untuk konfigurasi grup benda:

   aws iot set-v2-logging-level \
                 --log-target targetType=THING_GROUP,targetName=thing_group_name \
                 --log-level log_level

   --log-target

   Jenis dan nama sumber daya yang Anda konfigurasikan logging. targetTypeNilai harus salah satu dari: THING_GROUP | CLIENT_ID | SOURCE_IP |PRINCIPAL_ID. Nilai parameter log-target dapat berupa teks, seperti yang ditunjukkan pada contoh perintah sebelumnya, atau string JSON, seperti contoh berikut.

   aws iot set-v2-logging-level \
                 --log-target '{"targetType": "THING_GROUP","targetName": "thing_group_name"}' \
                 --log-level log_level

   --log-level

   Tingkat logging yang digunakan saat membuat log untuk sumber daya yang ditentukan. Nilai yang valid adalah: DEBUG, INFO, ERROR, WARN, dan DISABLED.

3. Gunakan list-v2-logging-levelsperintah untuk mencantumkan level logging yang saat ini dikonfigurasi.

   aws iot list-v2-logging-levels

4. Gunakan delete-v2-logging-levelperintah untuk menghapus tingkat logging khusus sumber daya, seperti contoh berikut.

   aws iot delete-v2-logging-level \
                 --target-type "THING_GROUP" \
                 --target-name "thing_group_name"

   aws iot delete-v2-logging-level \
                 --target-type=CLIENT_ID 
                 --target-name=ClientId1

   --target-type

   target-typeNilai harus salah satu dari: THING_GROUP | CLIENT_ID | SOURCE_IP |PRINCIPAL_ID.

   --target-name

   Nama grup benda untuk menghapus level logging.