Aktifkan CloudWatch Log

Hub SDK menyediakan fungsionalitas pencatatan yang komprehensif. Secara default, Hub SDK menulis log ke sistem file lokal. Namun, Anda dapat memanfaatkan cloud API untuk mengonfigurasi streaming CloudWatch log ke Log, yang menawarkan:

• Pantau kinerja perangkat: Tangkap log runtime terperinci untuk manajemen perangkat proaktif. Aktifkan analisis log lanjutan dan pemantauan di seluruh armada perangkat Anda

• Memecahkan masalah: Hasilkan entri log granular untuk analisis diagnostik cepat. Rekam sistem dan acara tingkat aplikasi untuk penyelidikan mendalam.

• Pencatatan yang fleksibel dan terpusat: Manajemen log jarak jauh tanpa akses perangkat langsung. Agregat log dari beberapa perangkat dalam satu repositori yang dapat dicari.

Prasyarat

• Onboard perangkat yang dikelola ke cloud. Lihat Pengaturan orientasi hub untuk detail.

• Verifikasi startup agen Hub dan inisialisasi yang berhasil. Lihat Instal dan validasi integrasi terkelola Hub SDK untuk detail.

catatan

Untuk membuat konfigurasi logging, lihat PutRuntimeLogConfiguration API untuk detailnya.

Awas

Mengaktifkan log dihitung terhadap pengukuran kuota berjenjang. Peningkatan level log akan menghasilkan volume pesan yang lebih tinggi dan biaya tambahan.

Pengaturan konfigurasi log SDK Hub

Konfigurasikan setelan log SDK hub dengan memanggil API untuk menyiapkan konfigurasi log runtime.

contoh Permintaan API

aws iot-managed-integrations put-runtime-log-configuration \
    --managed-thing-id MANAGED_THING_ID \
    --runtime-log-configurations LogLevel=DEBUG,UploadLog=TRUE               

RuntimeLogConfigurations atribut

Atribut berikut bersifat opsional dan dapat dikonfigurasi di RuntimeLogConfigurations API.

LogLevel

Menetapkan tingkat keparahan minimum untuk jejak runtime. Nilai: DEBUG, ERROR, INFO, WARN

Default: WARN (rilis build)

LogFlushLevel

Menentukan tingkat keparahan untuk pembilasan data langsung ke penyimpanan lokal. Nilai: DEBUG, ERROR, INFO, WARN

Default: DISABLED

LocalStoreLocation

Menentukan lokasi penyimpanan untuk jejak runtime. Default: /var/log/awsiotmi

• Log aktif: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.log

• Log yang diputar: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.N.log (N menunjukkan urutan rotasi)

LocalStoreFileRotationMaxBytes

Memicu rotasi file ketika file saat ini melebihi ukuran yang ditentukan.

penting

Untuk efisiensi optimal, pertahankan ukuran file di bawah 125 KB. Nilai di atas 125 KB akan dibatasi secara otomatis.

LocalStoreFileRotationMaxFiles,

Menetapkan jumlah maksimum file rotasi yang diizinkan oleh daemon log.

UploadLog

Mengontrol transfer jejak runtime ke cloud. Log disimpan dalam grup /aws/iotmanagedintegration CloudWatch Log.

Default: false.

UploadPeriodMinutes

Mendefinisikan frekuensi unggahan runtime trace. Default: 5

DeleteLocalStoreAfterUpload

Mengontrol penghapusan file setelah diunggah. Default: true

catatan

Jika disetel ke false, file yang diunggah diganti namanya menjadi: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.uploaded.{uploaded_timestamp}

Contoh file log

Lihat contoh file CloudWatch Log di bawah ini: