Manajer log - AWS IoT Greengrass
VersiTipeSistem operasiPersyaratanDependensiKonfigurasiPenggunaanFile log lokalChangelog

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) mengunggah log dari perangkat AWS 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 CloudWatch log di Log dan pada sistem file lokal, lihatMemantau AWS IoT Greengrass log.

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

  • Penundaan log

    catatan

    Kami menyarankan Anda meningkatkan 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 lunak AWS IoT Greengrass Core memutar file log setiap jam atau setelah 1.024 KB. Akibatnya, komponen pengelola log mengunggah log hanya setelah perangkat lunak AWS IoT Greengrass Core atau komponen Greengrass menulis log senilai lebih dari 1.024 KB. Anda dapat mengonfigurasi batas ukuran file log yang lebih rendah untuk menyebabkan file log diputar lebih sering. Hal ini menyebabkan komponen pengelola log mengunggah CloudWatch log ke 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 pengelola log mengunggah log baru secara berkala. Secara default, komponen pengelola log mengunggah log baru setiap 5 menit. Anda dapat mengonfigurasi interval unggahan yang lebih rendah, sehingga komponen pengelola log mengunggah CloudWatch log ke Log lebih sering dengan mengonfigurasi log. periodicUploadIntervalSec 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.

    catatan

    Jika Anda menggunakan sistem file yang berbeda untuk menulis log, pengelola log kembali ke perilaku di komponen pengelola log versi 2.2.8 dan yang lebih lama. Untuk informasi tentang mengakses log sistem file, lihat Mengakses log sistem file.

  • Jam miring

    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 Log menolak permintaan. Untuk informasi selengkapnya, lihat Proses penandatanganan Versi Tanda Tangan 4 di bagian Referensi Umum AWS.

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

Versi

Komponen ini memiliki versi berikut:

  • 2.3.x

  • 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. Nukleus 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 Memantau AWS IoT Greengrass log.

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, lihat Menggunakan kebijakan berbasis identitas (kebijakan IAM) untuk CloudWatch Log 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.3.5

Tabel berikut mencantumkan dependensi untuk versi 2.3.5 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.12.0 Lunak
2.3.3 – 2.3.4

Tabel berikut mencantumkan dependensi untuk versi 2.3.3 hingga 2.3.4 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.11.0 Lunak
2.2.8 – 2.3.2

Tabel berikut mencantumkan dependensi untuk versi 2.2.8 hingga 2.3.2 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.2.7 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.2.6 dari 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 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.2.1 - 2.2.4 dari 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 dari 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.3.5
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 AWS IoT Greengrass Core, yang mencakup log dari inti Greengrass dan komponen plugin. Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log 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 untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen inti Greengrass untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, JSON tentukan parameter format logging (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 tentukan. diskSpaceLimitUnit Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua.

Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total 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 pengelola log mengunggah CloudWatch log ke Log.

Default: false

componentLogsConfigurationMap

(Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. Setiap componentName objek dalam peta ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log.

penting

Kami sangat menyarankan menggunakan satu kunci konfigurasi per komponen. Anda hanya boleh menargetkan sekelompok file yang hanya memiliki satu file log yang secara aktif ditulis saat menggunakan filelogFileRegex. Tidak mengikuti rekomendasi ini dapat menyebabkan log duplikat diunggah. CloudWatch Jika Anda menargetkan beberapa file log aktif dengan satu regex, kami sarankan Anda meningkatkan ke pengelola log v2.3.1 atau yang lebih baru dan pertimbangkan untuk mengubah konfigurasi Anda menggunakan konfigurasi contoh.

catatan

Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakan componentLogsConfiguration daftar alih-alih. componentLogsConfigurationMap Namun, kami sangat menyarankan Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk memodifikasi konfigurasi untuk komponen tertentu. Untuk informasi tentang componentLogsConfiguration parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini.

componentName

Konfigurasi log untuk componentNamekomponen 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 untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori modul AWS IoT Greengrass logging. 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 file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini.

Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total 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 pengelola log mengunggah CloudWatch log ke Log.

Default: false

multiLineStartPattern

(Opsional) Ekspresi reguler yang mengidentifikasi kapan 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 putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan.

periodicUploadIntervalSec

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

Default: 300 (5 menit)

Minimum: 0.000001 (1 mikrodetik)

deprecatedVersionSupport

Menunjukkan apakah pengelola log harus menggunakan peningkatan kecepatan pencatatan yang diperkenalkan di pengelola log v2.3.5. Tetapkan nilai false untuk menggunakan perbaikan.

Jika Anda menetapkan nilai ini false saat Anda memutakhirkan dari pengelola log v2.3.1 atau entri log duplikat sebelumnya dapat diunggah.

Defaultnya adalah true.

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log com.example.HelloWorld komponen ke 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",
  "deprecatedVersionSupport": "false"
}
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. Konfigurasi contoh ini menentukan file log aktif apa yang ingin Anda unggah. CloudWatch Menggunakan konfigurasi contoh konfigurasi ini juga akan mengunggah file yang diputar yang cocok dengan file. logFileRegex 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.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 lunak AWS IoT Greengrass Core, yang mencakup log dari inti Greengrass dan komponen plugin. Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log 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 untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen inti Greengrass untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, JSON tentukan parameter format logging (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 tentukan. diskSpaceLimitUnit Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua.

Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total 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 pengelola log mengunggah CloudWatch log ke Log.

Default: false

componentLogsConfigurationMap

(Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. Setiap componentName objek dalam peta ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log.

penting

Kami sangat menyarankan menggunakan satu kunci konfigurasi per komponen. Anda hanya boleh menargetkan sekelompok file yang hanya memiliki satu file log yang secara aktif ditulis saat menggunakan filelogFileRegex. Tidak mengikuti rekomendasi ini dapat menyebabkan log duplikat diunggah. CloudWatch Jika Anda menargetkan beberapa file log aktif dengan satu regex, kami sarankan Anda meningkatkan ke pengelola log v2.3.1 dan pertimbangkan untuk mengubah konfigurasi Anda menggunakan konfigurasi contoh.

catatan

Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakan componentLogsConfiguration daftar alih-alih. componentLogsConfigurationMap Namun, kami sangat menyarankan Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk memodifikasi konfigurasi untuk komponen tertentu. Untuk informasi tentang componentLogsConfiguration parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini.

componentName

Konfigurasi log untuk componentNamekomponen 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 untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori modul AWS IoT Greengrass logging. 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 file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini.

Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total 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 pengelola log mengunggah CloudWatch log ke Log.

Default: false

multiLineStartPattern

(Opsional) Ekspresi reguler yang mengidentifikasi kapan 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 putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan.

periodicUploadIntervalSec

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

Default: 300 (5 menit)

Minimum: 0.000001 (1 mikrodetik)

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log com.example.HelloWorld komponen ke 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"
}
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. Konfigurasi contoh ini menentukan file log aktif apa yang ingin Anda unggah. CloudWatch Menggunakan konfigurasi contoh konfigurasi ini juga akan mengunggah file yang diputar yang cocok dengan file. logFileRegex 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 lunak AWS IoT Greengrass Core, yang mencakup log dari inti Greengrass dan komponen plugin. Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log 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 untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen inti Greengrass untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, JSON tentukan parameter format logging (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 tentukan. diskSpaceLimitUnit Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua.

Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total 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 pengelola log mengunggah CloudWatch log ke Log.

Default: false

componentLogsConfigurationMap

(Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. Setiap componentName objek dalam peta ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log.

catatan

Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakan componentLogsConfiguration daftar alih-alih. componentLogsConfigurationMap Namun, kami sangat menyarankan Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk memodifikasi konfigurasi untuk komponen tertentu. Untuk informasi tentang componentLogsConfiguration parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini.

componentName

Konfigurasi log untuk componentNamekomponen 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 untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori modul AWS IoT Greengrass logging. 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 file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini.

Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total 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 pengelola log mengunggah CloudWatch log ke Log.

Default: false

multiLineStartPattern

(Opsional) Ekspresi reguler yang mengidentifikasi kapan 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 putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan.

periodicUploadIntervalSec

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

Default: 300 (5 menit)

Minimum: 0.000001 (1 mikrodetik)

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log com.example.HelloWorld komponen ke 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 untuk log sistem perangkat lunak AWS IoT Greengrass Core, yang mencakup log dari inti Greengrass dan komponen plugin. Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log 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 untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen inti Greengrass untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, JSON tentukan parameter format logging (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 tentukan. diskSpaceLimitUnit Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua.

Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total 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 pengelola log mengunggah CloudWatch log ke 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 pengelola log mengunggah log komponen ini ke CloudWatch Log

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 untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori modul AWS IoT Greengrass logging. 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 file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini.

Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total 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 pengelola log mengunggah CloudWatch log ke Log.

Default: false

multiLineStartPattern

(Opsional) Ekspresi reguler yang mengidentifikasi kapan 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 putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan.

periodicUploadIntervalSec

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

Default: 300 (5 menit)

Minimum: 0.000001 (1 mikrodetik)

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log com.example.HelloWorld komponen ke 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 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 untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen inti Greengrass untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, JSON tentukan parameter format logging (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 tentukan. diskSpaceLimitUnit Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua.

Parameter ini setara dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total 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 pengelola log mengunggah CloudWatch log ke 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 pengelola log mengunggah log komponen ini ke CloudWatch Log

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 untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori modul AWS IoT Greengrass logging. 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 file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini.

Parameter ini terkait dengan parameter batas ukuran log (totalLogsSizeKB) dari komponen inti Greengrass. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total 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 mengunggah log komponen Greengrass, /greengrass/v2/logs tentukan, 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 pengelola log mengunggah CloudWatch log ke Log.

Default: false

multiLineStartPattern

(Opsional) Ekspresi reguler yang mengidentifikasi kapan 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 putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan.

periodicUploadIntervalSec

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

Default: 300 (5 menit)

Minimum: 0.000001 (1 mikrodetik)

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log com.example.HelloWorld komponen ke 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 menyertakan 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 lain di 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 aliran 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 aliran 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.

Format untuk entri log.

Inti Greengrass menulis file log dalam format string atau JSON. Untuk log sistem, Anda mengontrol format dengan mengatur format bidang logging entri. Anda dapat menemukan logging entri di file konfigurasi komponen inti Greengrass. Untuk informasi selengkapnya, lihat konfigurasi nukleus Greengrass.

Format teks adalah bentuk bebas dan menerima string apa pun. Pesan layanan status armada berikut adalah contoh logging berformat string:

2023-03-26T18:18:27.271Z [INFO] (pool-1-thread-2)
com.aws.greengrass.status.FleetStatusService: fss-status-update-published. 
Status update published to FSS. {trigger=CADENCE, serviceName=FleetStatusService, 
currentState=RUNNING}

Anda harus menggunakan format JSON jika Anda ingin melihat log dengan perintah log CLI Greengrass atau berinteraksi dengan log secara terprogram. Contoh berikut menguraikan bentuk JSON:

{
   "loggerName": <string>,
   "level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">,
   "eventType": <string, optional>,
   "cause": <string, optional>,
   "contexts": {},
   "thread": <string>,
   "message": <string>,
   "timestamp": <epoch time> # Needs to be epoch time
}

Untuk mengontrol output log komponen Anda, Anda dapat menggunakan opsi minimumLogLevel konfigurasi. Untuk menggunakan opsi ini, komponen Anda harus menulis entri lognya dalam format JSON. Anda harus menggunakan format yang sama dengan file log sistem.

File log lokal

Komponen ini menggunakan file log yang sama dengan komponen inti Greengrass.

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/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

    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.3.5
Peningkatan

Meningkatkan kecepatan unggah log.

Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis.

2.3.4
Perbaikan bug dan peningkatan

  • Menambahkan dukungan untuk mengatur periodicUploadIntervalSec parameter ke nilai fraksional. Minimal adalah 1 mikrodetik.

  • Memperbaiki masalah di mana pengelola log tidak menghormati CloudWatch putLogEvents batas.

2.3.3

Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis.

2.3.2
Perbaikan bug dan peningkatan

  • Meningkatkan manajemen ruang sehingga file log tidak dihapus sebelum diunggah.

  • Memperbaiki masalah dengan manajemen cache.

  • Peningkatan dan perbaikan kecil tambahan.

2.3.1
Perbaikan bug dan peningkatan

  • Memperbaiki masalah saat konfigurasi yang menargetkan grup file dengan kelipatan file log aktif mengunggah entri duplikat. CloudWatch

  • Peningkatan dan perbaikan kecil tambahan.

2.3.0
catatan

Kami menyarankan Anda meningkatkan ke Greengrass nucleus 2.9.1 saat Anda meningkatkan ke pengelola log 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

  • Meningkatkan dukungan rotasi log saat memutar file dengan nama unik.

  • Peningkatan dan perbaikan kecil tambahan.

2.2.8

 Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis.

2.2.7

 Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis.

2.2.6

Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.

2.2.5

Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis.

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 memulai ulang atau menemukan kesalahan.

  • Memperbaiki masalah di mana pesan log besar dan file log besar gagal diunggah dalam skenario tertentu.

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

  • Memperbaiki masalah di mana nilai null diskSpaceLimit konfigurasi mencegah komponen dari penerapan.

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 stempel waktu peristiwa log yang sama.

2.2.1

Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.

2.2.0
Fitur baru

  • Menambahkan parameter componentLogsConfigurationMap konfigurasi untuk mendukung format peta untuk konfigurasi log komponen. Setiap componentName objek dalam peta mendefinisikan konfigurasi log untuk komponen atau aplikasi.

2.1.3

Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.

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).

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

  • Tangani karakter titik dua (:) dengan benar di nama aliran log. CloudWatch Nama aliran 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.