Manajer log - AWS IoT Greengrass

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

Manajer log

Komponen pengelola log (aws.greengrass.LogManager) upload log dariAWS IoT Greengrassperangkat inti ke Amazon CloudWatch Log. Anda dapat meng-upload log dari inti Greengrass, komponen Greengrass lainnya, dan aplikasi dan layanan lain yang bukan komponen Greengrass. Untuk informasi selengkapnya tentang cara memonitor log masuk CloudWatch Log dan pada sistem file lokal, lihatPemantauanAWS IoT Greengrasslog.

Pertimbangan berikut berlaku saat Anda menggunakan komponen manajer log untuk menulis CloudWatch Log:

  • Penundaan log

    Komponen pengelola log menulis log dari hanya file log yang diputar. Secara default,AWS IoT GreengrassPerangkat lunak inti berputar file log setiap jam atau setelah mereka 1.024 KB. Akibatnya, komponen pengelola log mengunggah log hanya setelahAWS IoT GreengrassPerangkat lunak inti atau komponen Greengrass menulis lebih dari 1.024 KB log. Anda dapat mengkonfigurasi batas ukuran file log yang lebih rendah untuk menyebabkan file log untuk memutar lebih sering. Hal ini menyebabkan komponen pengelola log untuk mengunggah log ke CloudWatch Log lebih sering.

    Komponen pengelola log juga mengunggah log baru secara berkala. Secara default, komponen pengelola log mengunggah log baru setiap 5 menit. Anda dapat mengonfigurasi interval upload yang lebih rendah, sehingga komponen pengelola log mengunggah log ke CloudWatch Log lebih sering.

    Jika Anda perlu mengamati log secara real time, pertimbangkan untuk menggunakanlog sistem file.

  • Clock skew

    Komponen pengelola log akan menggunakan proses penandatanganan Signature Version 4 standar untuk membuat permintaan API CloudWatch Log. Jika waktu sistem pada perangkat inti tidak sinkron lebih dari 15 menit, maka CloudWatch Log menolak permintaan. Untuk informasi selengkapnya, lihatProses penandatanganan Signature Version 4di dalamAWSReferensi umum.

Untuk informasi tentang grup log dan pengaliran log yang padanya komponen ini meng-upload log, lihat Penggunaan.

Versi

Komponen ini memiliki versi berikut:

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipe

Komponen ini adalah komponen plugin (aws.greengrass.plugin). Inti Greengrass menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nucleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat PemantauanAWS IoT Greengrasslog.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

  • Peran perangkat Greengrass harus mengizinkan tindakan logs:CreateLogGroup, logs:CreateLogStream, logs:PutLogEvents, dan logs:DescribeLogStreams, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams" ], "Effect": "Allow", "Resource": "arn:aws:logs:*:*:*" } ] }
    catatan

    Peran perangkat Greengrass yang Anda buat ketika Anda menginstal perangkat lunak inti AWS IoT Greengrass mencakup izin dalam contoh kebijakan ini secara default.

    Untuk informasi selengkapnya, lihatMenggunakan kebijakan berbasis identitas (kebijakan IAM) untuk CloudWatch Beberapa catatandi dalamAmazon CloudWatch Panduan Pengguna log.

Titik akhir dan port

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Titik Akhir Port Diperlukan Deskripsi

logs.region.amazonaws.com

443 Tidak

Diperlukan jika Anda menulis log ke CloudWatch Log.

Dependensi

Saat Anda men-deploy komponen, AWS IoT Greengrass juga men-deploy versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

2.2.6

Tabel berikut mencantumkan dependensi untuk versi 2.6 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.8.0 Lunak
2.2.5

Tabel berikut mencantumkan dependensi untuk versi 2.2.5 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.0 Lunak
2.2.1 - 2.2.4

Tabel berikut mencantumkan dependensi untuk versi 2.2.1 - 2.2.4 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.6.0 Lunak
2.1.3 and 2.2.0

Tabel berikut mencantumkan dependensi untuk versi 2.1.3 dan 2.2.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.5.0 Lunak
2.1.2

Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.4.0 Lunak
2.1.1

Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.3.0 Lunak
2.1.0

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.2.0 Lunak
2.0.x

Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.3 <2.1.0 Lunak

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

v2.2.x
logsUploaderConfiguration

(Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut:

systemLogsConfiguration

(Opsional) Konfigurasi untukAWS IoT GreengrassLog sistem perangkat lunak inti, yang mencakup log dariInti Greengrassdankomponen plugin. Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log untuk mengelola log sistem. Objek ini berisi informasi berikut:

uploadToCloudWatch

(Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log.

Default: false

minimumLogLevel

(Opsional) Tingkat minimum pesan log yang akan diunggah. Tingkat minimum ini hanya berlaku jika Anda mengkonfigurasiKomponen Greengrassuntuk menampilkan log format JSON. Untuk mengaktifkan log format JSON, tentukanJSONuntukformat logparameter (logging.format).

Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Default: INFO

diskSpaceLimit

(Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukandiskSpaceLimitUnit. Setelah ukuran total file log Greengrass melebihi ukuran total maksimum ini,AWS IoT GreengrassPerangkat lunak inti menghapus file log sistem Greengrass tertua.

Parameter ini setara denganBatas ukuran logparameter (totalLogsSizeKB) dariKomponen Greengrass. YangAWS IoT Greengrassperangkat lunak inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran log sistem Greengrass maksimum.

diskSpaceLimitUnit

(Opsional) Unit untuk diskSpaceLimit. Pilih dari salah satu pilihan berikut:

  • KB – kilobyte

  • MB – megabyte

  • GB – gigabyte

Default: KB

deleteLogFileAfterCloudUpload

(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah log ke CloudWatch Log.

Default: false

componentLogsConfigurationMap

(Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. MASING-MASINGcomponentNameobjek di peta ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen manajer log mengunggah log komponen ini CloudWatch Log.

catatan

Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakancomponentLogsConfigurationdaftar bukancomponentLogsConfigurationMap. Namun, kami sangat menyarankan agar Anda menggunakan format peta sehingga Anda dapat menggunakan penggabungan dan pengaturan ulang pembaruan untuk mengubah konfigurasi komponen tertentu. Untuk informasi tentangcomponentLogsConfigurationparameter, lihat parameter konfigurasi untuk v2.1.x komponen ini.

componentName

Konfigurasi log untukcomponentNamekomponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini.

Setiap objek berisi informasi berikut.

minimumLogLevel

(Opsional) Tingkat minimum pesan log yang akan diunggah. Tingkat minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan diAWS IoT Greengrassmodul logrepositori pada GitHub.

Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Default: INFO

diskSpaceLimit

(Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di diskSpaceLimitUnit. Setelah ukuran total semua file log melebihi ukuran total maksimum ini,AWS IoT GreengrassPerangkat lunak inti menghapus file log tertua komponen ini.

Parameter ini terkait denganBatas ukuran logparameter (totalLogsSizeKB) dariKomponen Greengrass. YangAWS IoT GreengrassPerangkat lunak inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran total log maksimum untuk komponen ini.

diskSpaceLimitUnit

(Opsional) Unit untuk diskSpaceLimit. Pilih dari salah satu pilihan berikut:

  • KB – kilobyte

  • MB – megabyte

  • GB – gigabyte

Default: KB

logFileDirectoryPath

(Opsional) Path ke folder yang berisi file log komponen ini.

Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr).

Default: /greengrass/v2/logs.

logFileRegex

(Opsional) Ekspresi reguler yang menentukan format nama file log yang menggunakan komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di logFileDirectoryPath.

Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr).

Jika komponen atau aplikasi Anda memutar file log, tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan hello_world\\w*.log untuk meng-upload log untuk aplikasi Hello World. Pola \\w* cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut:

  • hello_world.log – Berkas log terbaru untuk aplikasi Hello World.

  • hello_world_2020_12_15_17_0.log – Berkas log yang lebih lama untuk aplikasi Hello World.

Default: componentName\\w*.log, tempat componentName adalah nama komponen untuk konfigurasi log ini.

deleteLogFileAfterCloudUpload

(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah log ke CloudWatch Log.

Default: false

multiLineStartPattern

(Opsional) Sebuah ekspresi reguler yang mengidentifikasi ketika pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya.

Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, ia menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti pelacakan tumpukan.

periodicUploadIntervalSec

(Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah.

Default: 300 (5 menit)

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dancom.example.HelloWorldlog komponen CloudWatch Log.

{ "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfigurationMap": { "com.example.HelloWorld": { "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "300" }
v2.1.x
logsUploaderConfiguration

(Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut:

systemLogsConfiguration

(Opsional) Konfigurasi untukAWS IoT GreengrassLog sistem perangkat lunak inti, yang mencakup log dariInti Greengrassdankomponen plugin. Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log untuk mengelola log sistem. Objek ini berisi informasi berikut:

uploadToCloudWatch

(Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log.

Default: false

minimumLogLevel

(Opsional) Tingkat minimum pesan log yang akan diunggah. Tingkat minimum ini hanya berlaku jika Anda mengkonfigurasiKomponen Greengrassuntuk menampilkan log format JSON. Untuk mengaktifkan log format JSON, tentukanJSONuntukformat logparameter (logging.format).

Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Default: INFO

diskSpaceLimit

(Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukandiskSpaceLimitUnit. Setelah ukuran total file log Greengrass melebihi ukuran total maksimum ini,AWS IoT GreengrassPerangkat lunak inti menghapus file log sistem Greengrass tertua.

Parameter ini setara denganBatas ukuran logparameter (totalLogsSizeKB) dariKomponen Greengrass. YangAWS IoT Greengrassperangkat lunak inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran log sistem Greengrass maksimum.

diskSpaceLimitUnit

(Opsional) Unit untuk diskSpaceLimit. Pilih dari salah satu pilihan berikut:

  • KB – kilobyte

  • MB – megabyte

  • GB – gigabyte

Default: KB

deleteLogFileAfterCloudUpload

(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah log ke CloudWatch Log.

Default: false

componentLogsConfiguration

(Opsional) Daftar konfigurasi log untuk komponen pada perangkat inti. Setiap konfigurasi dalam daftar ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen manajer log mengunggah log komponen ini CloudWatch Beberapa catatan

Setiap objek berisi informasi berikut.

componentName

Nama komponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini.

minimumLogLevel

(Opsional) Tingkat minimum pesan log yang akan diunggah. Tingkat minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan diAWS IoT Greengrassmodul logrepositori pada GitHub.

Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Default: INFO

diskSpaceLimit

(Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di diskSpaceLimitUnit. Setelah ukuran total semua file log melebihi ukuran total maksimum ini,AWS IoT GreengrassPerangkat lunak inti menghapus file log tertua komponen ini.

Parameter ini terkait denganBatas ukuran logparameter (totalLogsSizeKB) dariKomponen Greengrass. YangAWS IoT GreengrassPerangkat lunak inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran total log maksimum untuk komponen ini.

diskSpaceLimitUnit

(Opsional) Unit untuk diskSpaceLimit. Pilih dari salah satu pilihan berikut:

  • KB – kilobyte

  • MB – megabyte

  • GB – gigabyte

Default: KB

logFileDirectoryPath

(Opsional) Path ke folder yang berisi file log komponen ini.

Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr).

Default: /greengrass/v2/logs.

logFileRegex

(Opsional) Ekspresi reguler yang menentukan format nama file log yang menggunakan komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di logFileDirectoryPath.

Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr).

Jika komponen atau aplikasi Anda memutar file log, tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan hello_world\\w*.log untuk meng-upload log untuk aplikasi Hello World. Pola \\w* cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut:

  • hello_world.log – Berkas log terbaru untuk aplikasi Hello World.

  • hello_world_2020_12_15_17_0.log – Berkas log yang lebih lama untuk aplikasi Hello World.

Default: componentName\\w*.log, tempat componentName adalah nama komponen untuk konfigurasi log ini.

deleteLogFileAfterCloudUpload

(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah log ke CloudWatch Log.

Default: false

multiLineStartPattern

(Opsional) Sebuah ekspresi reguler yang mengidentifikasi ketika pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya.

Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, ia menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti pelacakan tumpukan.

periodicUploadIntervalSec

(Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah.

Default: 300 (5 menit)

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dancom.example.HelloWorldlog komponen CloudWatch Log.

{ "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfiguration": [ { "componentName": "com.example.HelloWorld", "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } ] }, "periodicUploadIntervalSec": "300" }
v2.0.x
logsUploaderConfiguration

(Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut:

systemLogsConfiguration

(Opsional) Konfigurasi untuk log sistem perangkat lunak inti AWS IoT Greengrass. Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log untuk mengelola log sistem. Objek ini berisi informasi berikut:

uploadToCloudWatch

(Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log.

Default: false

minimumLogLevel

(Opsional) Tingkat minimum pesan log yang akan diunggah. Tingkat minimum ini hanya berlaku jika Anda mengkonfigurasiKomponen Greengrassuntuk menampilkan log format JSON. Untuk mengaktifkan log format JSON, tentukanJSONuntukformat logparameter (logging.format).

Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Default: INFO

diskSpaceLimit

(Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukandiskSpaceLimitUnit. Setelah ukuran total file log Greengrass melebihi ukuran total maksimum ini,AWS IoT GreengrassPerangkat lunak inti menghapus file log sistem Greengrass tertua.

Parameter ini setara denganBatas ukuran logparameter (totalLogsSizeKB) dariKomponen Greengrass. YangAWS IoT Greengrassperangkat lunak inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran log sistem Greengrass maksimum.

diskSpaceLimitUnit

(Opsional) Unit untuk diskSpaceLimit. Pilih dari salah satu pilihan berikut:

  • KB – kilobyte

  • MB – megabyte

  • GB – gigabyte

Default: KB

deleteLogFileAfterCloudUpload

(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah log ke CloudWatch Log.

Default: false

componentLogsConfiguration

(Opsional) Daftar konfigurasi log untuk komponen pada perangkat inti. Setiap konfigurasi dalam daftar ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen manajer log mengunggah log komponen ini CloudWatch Beberapa catatan

Setiap objek berisi informasi berikut.

componentName

Nama komponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini.

minimumLogLevel

(Opsional) Tingkat minimum pesan log yang akan diunggah. Tingkat minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan diAWS IoT Greengrassmodul logrepositori pada GitHub.

Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Default: INFO

diskSpaceLimit

(Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di diskSpaceLimitUnit. Setelah ukuran total semua file log melebihi ukuran total maksimum ini,AWS IoT GreengrassPerangkat lunak inti menghapus file log tertua komponen ini.

Parameter ini terkait denganBatas ukuran logparameter (totalLogsSizeKB) dariKomponen Greengrass. YangAWS IoT GreengrassPerangkat lunak inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran total log maksimum untuk komponen ini.

diskSpaceLimitUnit

(Opsional) Unit untuk diskSpaceLimit. Pilih dari salah satu pilihan berikut:

  • KB – kilobyte

  • MB – megabyte

  • GB – gigabyte

Default: KB

logFileDirectoryPath

Path ke folder yang berisi file log komponen ini.

Untuk meng-upload log komponen Greengrass, tentukan /greengrass/v2/logs, dan ganti /greengrass/v2 dengan folder root Greengrass Anda.

logFileRegex

Ekspresi reguler yang menentukan format nama file log yang digunakan oleh komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di logFileDirectoryPath.

Untuk meng-upload log komponen Greengrass tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan com.example.HelloWorld\\w*.log untuk meng-upload log untuk aplikasi Hello World. Pola \\w* cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut:

  • com.example.HelloWorld.log – Berkas log terbaru untuk komponen Hello World.

  • com.example.HelloWorld_2020_12_15_17_0.log – Berkas log yang lebih lama untuk komponen Hello World. Inti Greengrass menambahkan stempel waktu putar pada file log.

deleteLogFileAfterCloudUpload

(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah log ke CloudWatch Log.

Default: false

multiLineStartPattern

(Opsional) Sebuah ekspresi reguler yang mengidentifikasi ketika pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya.

Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, ia menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti pelacakan tumpukan.

periodicUploadIntervalSec

(Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah.

Default: 300 (5 menit)

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dancom.example.HelloWorldlog komponen CloudWatch Log.

{ "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfiguration": [ { "componentName": "com.example.HelloWorld", "minimumLogLevel": "INFO", "logFileDirectoryPath": "/greengrass/v2/logs", "logFileRegex": "com.example.HelloWorld\\w*.log", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } ] }, "periodicUploadIntervalSec": "300" }

Penggunaan

Komponen manajer log meng-upload ke grup log dan pengaliran log berikut.

2.1.0 and later
Nama grup log
/aws/greengrass/componentType/region/componentName

Nama grup log menggunakan variabel berikut:

  • componentType — Jenis komponen, yang dapat berupa salah satu dari berikut ini:

    • GreengrassSystemComponent — Komponen adalah bagian dari nukleus Greengrass. Grup log ini mencakup log untuk komponen plugin, yang berjalan di JVM yang sama dengan inti Greengrass.

    • UserComponent — Komponen adalah bagian dari nukleus Greengrass. Grup log ini mencakup log untuk komponen generik, komponen Lambda, dan aplikasi lainnya pada perangkat.

    Untuk informasi selengkapnya, lihat Jenis komponen.

  • region — Wilayah AWS yang menggunakan perangkat inti.

  • componentName — Nama komponen. Untuk log sistem, nilai ini adalah System.

Nama pengaliran log
/date/thing/thingName

Nama aliran log menggunakan variabel berikut:

  • date — Tanggal log, seperti 2020/12/15. Komponen manajer log menggunakan format yyyy/MM/dd.

  • thingName - Nama perangkat inti.

catatan

Jika nama objek berisi titik dua (:), manajer log akan menggantikan titik dua dengan tanda tambah (+).

2.0.x
Nama grup log
/aws/greengrass/componentType/region/componentName

Nama grup log menggunakan variabel berikut:

  • componentType — Jenis komponen, yang dapat berupa salah satu dari berikut ini:

    • GreengrassSystemComponent — Komponen adalah bagian dari nukleus Greengrass.

    • UserComponent — Komponen adalah bagian dari nukleus Greengrass. Manajer log menggunakan jenis ini untuk komponen Greengrass dan aplikasi lainnya pada perangkat.

  • region — Wilayah AWS yang menggunakan perangkat inti.

  • componentName — Nama komponen. Untuk log sistem, nilai ini adalah System.

Nama pengaliran log
/date/deploymentTargets/thingName

Nama aliran log menggunakan variabel berikut:

  • date — Tanggal log, seperti 2020/12/15. Komponen manajer log menggunakan format yyyy/MM/dd.

  • deploymentTargets — Objek-objek yang deployment-nya meliputi komponen. Komponen manajer log memisahkan setiap target dengan garis miring. Jika komponen berjalan pada perangkat inti sebagai hasil dari deployment lokal, nilai ini adalah LOCAL_DEPLOYMENT.

    Pertimbangkan contoh di mana Anda memiliki perangkat inti bernama MyGreengrassCore, dan perangkat inti tersebut memiliki dua deployment:

    • Deployment yang menargetkan perangkat inti, MyGreengrassCore.

    • Deployment yang menargetkan grup objek bernama MyGreengrassCoreGroup, yang berisi perangkat inti.

    deploymentTargets untuk perangkat inti ini adalah thing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup.

  • thingName - Nama perangkat inti.

berkas log lokal

Komponen ini menggunakan file log yang sama sepertiInti Greengrasskomponen.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log

Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti/greengrass/v2atauC:\greengrass\v2dengan jalan keAWS IoT Greengrassfolder akar.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

2.6

Versi yang diperbarui untuk rilis inti Greengrass versi 2.7.0.

2.2.5

Versi yang diperbarui untuk rilis inti Greengrass versi 2.6.0.

2.2.4

Perbaikan bug dan peningkatan
  • Meningkatkan stabilitas saat menangani konfigurasi yang tidak valid.

  • Peningkatan dan perbaikan kecil tambahan.

2.2.3

Perbaikan bug dan peningkatan
  • Meningkatkan stabilitas dalam skenario tertentu di mana komponen restart atau menemukan kesalahan.

  • Perbaikan masalah di mana pesan log besar dan file log besar gagal untuk meng-upload dalam skenario tertentu.

  • Memperbaiki masalah dengan bagaimana komponen ini menangani pembaruan pengaturan ulang konfigurasi.

  • Memperbaiki masalah di mananull diskSpaceLimitnilai konfigurasi mencegah komponen dari penyebaran.

2.2.2

Perbaikan bug dan peningkatan
  • Menambahkan dukungan untuk pesan log yang lebih besar dari 256 kilobyte. Komponen pengelola log membagi pesan log besar ini menjadi beberapa pesan dengan cap waktu peristiwa log yang sama.

2.2.1

Versi yang diperbarui untuk rilis inti Greengrass versi 2.5.0.

2.2.0

Fitur baru
  • MenambahkancomponentLogsConfigurationMapparameter konfigurasi untuk mendukung format peta untuk konfigurasi log komponen. MASING-MASINGcomponentNameobjek di peta mendefinisikan konfigurasi log untuk komponen atau aplikasi.

2.1.3

Versi yang diperbarui untuk rilis inti Greengrass versi 2.4.0.

2.1.2

Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.

2.1.1

Perbaikan bug dan peningkatan
  • Memperbaiki masalah saat konfigurasi log sistem tidak diperbarui dalam kasus tertentu.

2.1.0

Perbaikan bug dan peningkatan
  • Gunakan default untuk logFileDirectoryPath dan logFileRegex yang bekerja untuk komponen Greengrass yang mencetak ke output standar (stdout) dan kesalahan standar (stderr).

  • Arahkan lalu lintas dengan benar melalui proksi jaringan yang dikonfigurasi saat mengunggah log ke CloudWatch Log.

  • Benar menangani karakter usus besar (:) dalam nama pengaliran log. CloudWatch Nama pengaliran log log tidak mendukung titik dua.

  • Sederhanakan nama aliran log dengan menghapus nama grup objek dari aliran log.

  • Hapus pesan log kesalahan yang dicetak selama perilaku normal.

2.0.x

Versi awal.