Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Manajer log
Komponen manajer log (aws.greengrass.LogManager) mengunggah log dari perangkatAWS IoT Greengrass inti ke Amazon CloudWatch Logs. 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 memantau log di CloudWatch Log dan pada sistem file lokal, lihatMemantauAWS IoT Greengrass log.
Pertimbangan berikut berlaku saat Anda menggunakan komponen manajer log untuk menulis ke CloudWatch Logs:
-
Penundaan log
Sebaiknya tingkatkan ke pengelola log versi 2.3.0 yang mengurangi penundaan log untuk file log yang diputar dan aktif. Saat Anda meningkatkan ke pengelola log 2.3.0, kami sarankan Anda juga meningkatkan ke Greengrass nucleus 2.9.1.
Komponen pengelola log versi 2.2.8 (dan sebelumnya) memproses dan mengunggah log hanya dari file log yang diputar. Secara default, perangkat lunakAWS IoT Greengrass Core memutar file log setiap jam atau setelah mereka 1.024 KB. Akibatnya, komponen pengelola log mengunggah log hanya setelah perangkat lunakAWS IoT Greengrass Core atau komponen Greengrass menulis log senilai lebih dari 1.024 KB. 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 versi 2.3.0 (dan yang lebih baru) memproses dan mengunggah semua log. Saat Anda menulis log baru, pengelola log versi 2.3.0 (dan yang lebih baru) memproses dan langsung mengunggah file log aktif itu alih-alih menunggu untuk diputar. Ini berarti Anda dapat melihat log baru dalam 5 menit atau kurang.
Komponen manajer log mengunggah log baru secara berkala. Secara default, komponen pengelola log mengunggah log baru setiap 5 menit. Anda dapat mengkonfigurasi interval upload yang lebih rendah, sehingga komponen pengelola log upload CloudWatch log ke Log lebih sering dengan mengkonfigurasiperiodicUploadIntervalSec. Untuk informasi selengkapnya tentang cara mengonfigurasi interval periodik ini, lihat Konfigurasi.
Log dapat diunggah dalam waktu dekat dari sistem file Greengrass yang sama. Jika Anda perlu mengamati log secara real time, pertimbangkan untuk menggunakan log sistem file.
Jika Anda menggunakan sistem file yang berbeda untuk menulis log, pengelola log kembali ke perilaku dalam komponen pengelola log versi 2.2.8 dan sebelumnya. Untuk informasi tentang mengakses log sistem file, lihat Mengakses log sistem file.
-
Jam condong
Komponen pengelola log menggunakan proses penandatanganan Signature Version 4 standar untuk membuat permintaan API ke CloudWatch Log. Jika waktu sistem pada perangkat inti tidak sinkron lebih dari 15 menit, maka CloudWatch Logs menolak permintaan tersebut. Untuk informasi lebih lanjut, lihat Proses penandatanganan Signature Versi 4 di ReferensiAWS Umum.
Untuk informasi tentang grup log dan pengaliran log yang padanya komponen ini meng-upload log, lihat Penggunaan.
Versi
Komponen ini memiliki versi berikut:
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 MemantauAWS IoT Greengrass log.
Untuk informasi selengkapnya, lihat Jenis komponen.
Sistem operasi
Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:
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:*:*:*"
}
]
}
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 lebih lanjut, lihat Menggunakan kebijakan berbasis identitas (Kebijakan IAM) untuk CloudWatch Logs di Panduan Pengguna Amazon CloudWatch Logs.
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.8 – 2.3.1
-
Tabel berikut mencantumkan dependensi untuk versi 2.2.8 hingga 2.3.1 komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
> = 2.1.0 <3.0.0 |
Lunak |
- 2.2.7
-
Tabel berikut mencantumkan dependensi untuk versi 2.2.7 komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
> = 2.1.0 |
Lunak |
- 2.2.6
-
Tabel berikut mencantumkan dependensi untuk versi 2.2.6 komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
> = 2.1.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 |
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 |
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 |
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.3.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 lunakAWS IoT Greengrass Core, yang mencakup log dari inti Greengrass dan komponen 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 Logs.
Default: false
minimumLogLevel-
(Opsional) Tingkat minimum pesan log yang akan diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen nukleus Greengrass untuk menampilkan log format JSON. Untuk mengaktifkan log format JSON, tentukanJSON parameter format logging (logging.format).
Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:
Default: INFO
diskSpaceLimit-
(Opsional) Ukuran total maksimum Greengrass sistem, di unit yang Anda tentukan didiskSpaceLimitUnit. Setelah ukuran total semua file log melebihi ukuran total maksimum ini, perangkat lunakAWS IoT Greengrass inti menghapus Greengrass terlama.
Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunakAWS IoT Greengrass inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran total Greengrass sistem log 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 CloudWatch log ke Logs.
Default: false
-
componentLogsConfigurationMap
-
(Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. SetiapcomponentName objek di peta ini mendefinisikan konfigurasi log sistem untuk komponen atau aplikasi. Komponen manajer log mengunggah log komponen ini ke CloudWatch Logs.
Kami sangat menyarankan untuk menggunakan kunci konfigurasi tunggal per komponen. Anda hanya harus menargetkan sekelompok file yang hanya memiliki satu file log yang sedang ditulis secara aktif saat menggunakan filelogFileRegex. Tidak mengikuti rekomendasi ini dapat menyebabkan duplikat log diunggah CloudWatch. Jika Anda menargetkan beberapa file log aktif dengan satu regex, kami sarankan Anda meningkatkan ke pengelola log v2.3.1 dan mempertimbangkan untuk mengubah konfigurasi Anda menggunakan konfigurasi contoh.
Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakancomponentLogsConfiguration daftar sebagai ganticomponentLogsConfigurationMap. Namun, kami sangat menyarankan agar Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk mengubah konfigurasi untuk komponen tertentu. Untuk informasi tentangcomponentLogsConfiguration parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini.
componentName-
Konfigurasi log untuk componentName
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 di repositori modulAWS IoT Greengrass logging aktif GitHub.
Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:
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, perangkat lunakAWS IoT Greengrass inti menghapus file log terlama ini.
Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunakAWS IoT Greengrass 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:
Default: componentName\\w*.logcomponentName adalah nama komponen untuk konfigurasi log ini.
deleteLogFileAfterCloudUpload-
(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah CloudWatch log ke Logs.
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)
Minimal:1 (1 detik)
contoh Contoh: Pembaruan gabungan konfigurasi
Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan logcom.example.HelloWorld komponen ke CloudWatch Logs.
{
"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"
}
contoh Contoh: Konfigurasi untuk mengunggah beberapa file log aktif menggunakan pengelola log v2.3.1
Contoh konfigurasi berikut adalah contoh yang disarankan jika Anda ingin menargetkan beberapa file log aktif. Contoh konfigurasi ini menentukan apa file log aktif Anda ingin meng-upload ke CloudWatch. Menggunakan konfigurasi contoh konfigurasi ini juga akan meng-upload file diputar yang cocok denganlogFileRegex. Contoh konfigurasi ini didukung pada pengelola log v2.3.1.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.2.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 lunakAWS IoT Greengrass Core, yang mencakup log dari inti Greengrass dan komponen 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 Logs.
Default: false
minimumLogLevel-
(Opsional) Tingkat minimum pesan log yang akan diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen nukleus Greengrass untuk menampilkan log format JSON. Untuk mengaktifkan log format JSON, tentukanJSON parameter format logging (logging.format).
Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:
Default: INFO
diskSpaceLimit-
(Opsional) Ukuran total maksimum Greengrass sistem, di unit yang Anda tentukan didiskSpaceLimitUnit. Setelah ukuran total semua file log melebihi ukuran total maksimum ini, perangkat lunakAWS IoT Greengrass inti menghapus Greengrass terlama.
Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunakAWS IoT Greengrass inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran total Greengrass sistem log 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 CloudWatch log ke Logs.
Default: false
-
componentLogsConfigurationMap
-
(Opsional) Peta konfigurasi log sistem untuk komponen pada perangkat inti. SetiapcomponentName objek di peta ini mendefinisikan konfigurasi log sistem untuk komponen atau aplikasi. Komponen manajer log mengunggah log komponen ini ke CloudWatch Logs.
Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakancomponentLogsConfiguration daftar sebagai ganticomponentLogsConfigurationMap. Namun, kami sangat menyarankan agar Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk mengubah konfigurasi untuk komponen tertentu. Untuk informasi tentangcomponentLogsConfiguration parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini.
componentName-
Konfigurasi log untuk componentName
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 di repositori modulAWS IoT Greengrass logging aktif GitHub.
Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:
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, perangkat lunakAWS IoT Greengrass inti menghapus file log terlama ini.
Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunakAWS IoT Greengrass 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:
Default: componentName\\w*.logcomponentName adalah nama komponen untuk konfigurasi log ini.
deleteLogFileAfterCloudUpload-
(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah CloudWatch log ke Logs.
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)
Minimal:1 (1 detik)
contoh Contoh: Pembaruan gabungan konfigurasi
Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan logcom.example.HelloWorld komponen ke CloudWatch Logs.
{
"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 untuk log sistem perangkat lunakAWS IoT Greengrass Core, yang mencakup log dari inti Greengrass dan komponen 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 Logs.
Default: false
minimumLogLevel-
(Opsional) Tingkat minimum pesan log yang akan diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen nukleus Greengrass untuk menampilkan log format JSON. Untuk mengaktifkan log format JSON, tentukanJSON parameter format logging (logging.format).
Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:
Default: INFO
diskSpaceLimit-
(Opsional) Ukuran total maksimum Greengrass sistem, di unit yang Anda tentukan didiskSpaceLimitUnit. Setelah ukuran total semua file log melebihi ukuran total maksimum ini, perangkat lunakAWS IoT Greengrass inti menghapus Greengrass terlama.
Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunakAWS IoT Greengrass inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran total Greengrass sistem log 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 CloudWatch log ke Logs.
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 ke CloudWatch Logs
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 di repositori modulAWS IoT Greengrass logging aktif GitHub.
Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:
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, perangkat lunakAWS IoT Greengrass inti menghapus file log terlama ini.
Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunakAWS IoT Greengrass 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:
Default: componentName\\w*.logcomponentName adalah nama komponen untuk konfigurasi log ini.
deleteLogFileAfterCloudUpload-
(Opsional) Anda dapat menghapus file log setelah komponen manajer log mengunggah CloudWatch log ke Logs.
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)
Minimal:1 (1 detik)
contoh Contoh: Pembaruan gabungan konfigurasi
Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan logcom.example.HelloWorld komponen ke CloudWatch Logs.
{
"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 Logs.
Default: false
minimumLogLevel-
(Opsional) Tingkat minimum pesan log yang akan diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen nukleus Greengrass untuk menampilkan log format JSON. Untuk mengaktifkan log format JSON, tentukanJSON parameter format logging (logging.format).
Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:
Default: INFO
diskSpaceLimit-
(Opsional) Ukuran total maksimum Greengrass sistem, di unit yang Anda tentukan didiskSpaceLimitUnit. Setelah ukuran total semua file log melebihi ukuran total maksimum ini, perangkat lunakAWS IoT Greengrass inti menghapus Greengrass terlama.
Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunakAWS IoT Greengrass inti akan menggunakan minimum dari dua nilai tersebut sebagai ukuran total Greengrass sistem log 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 CloudWatch log ke Logs.
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 ke CloudWatch Logs
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 di repositori modulAWS IoT Greengrass logging aktif GitHub.
Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:
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, perangkat lunakAWS IoT Greengrass inti menghapus file log terlama ini.
Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunakAWS IoT Greengrass 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/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 CloudWatch log ke Logs.
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)
Minimal:1 (1 detik)
contoh Contoh: Pembaruan gabungan konfigurasi
Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan logcom.example.HelloWorld komponen ke CloudWatch Logs.
{
"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
-
- Log nama grup
-
/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 menyertakan 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.
Jika nama objek berisi titik dua (:), manajer log akan menggantikan titik dua dengan tanda tambah (+).
- 2.0.x
-
- Log nama grup
-
/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.
File log lokal
Komponen ini menggunakan file log yang sama seperti komponen inti Greengrass.
- Linux
-
/greengrass/v2/logs/greengrass.log
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Untuk melihat log komponen ini
Changelog
Tabel berikut menjelaskan perubahan dalam setiap versi komponen.
|
Versi
|
Perubahan
|
|
2.3.1
|
- Perbaikan bug dan peningkatan
-
|
|
2.3.0
|
Kami menyarankan Anda meng-upgrade ke Greengrass nucleus 2.9.1 ketika Anda meng-upgrade ke log manager 2.3.0.
- Fitur baru
-
Mengurangi penundaan log dengan memproses dan langsung mengunggah file log aktif alih-alih menunggu file baru diputar.
- Perbaikan bug dan peningkatan
-
|
|
2.8
|
Versi yang diperbarui untuk rilis inti Greengrass versi 2.9.0. |
|
2.7
|
Versi yang diperbarui untuk rilis inti Greengrass versi 2.8.0. |
|
2.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
-
|
|
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 mana nilainulldiskSpaceLimit konfigurasi mencegah komponen dari penyebaran.
|
|
2.2.2
|
- Perbaikan bug dan peningkatan
-
|
|
2.2.1
|
Versi yang diperbarui untuk rilis inti Greengrass versi 2.5.0.
|
|
2.2.0
|
|
|
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
-
|
|
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 CloudWatch log ke Logs.
-
Dengan tepat tangani karakter titik dua (:) dalam nama pengaliran log. CloudWatch Nama pengaliran 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.
|
