logAWS IoT Greengrass log - AWS IoT Greengrass

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

logAWS IoT Greengrass log

AWS IoT Greengrass terdiri dari layanan cloud dan AWS IoT Greengrass perangkat lunak core. Perangkat lunakAWS IoT Greengrass inti dapat menulis log ke CloudWatch log Amazon dan ke sistem file lokal perangkat inti. Komponen Greengrass yang berjalan pada perangkat inti juga dapat menulis log ke CloudWatch log dan sistem file lokal. Anda dapat menggunakan log untuk memantau acara dan meyelesaikan masalah. Semua entri log AWS IoT Greengrass termasuk timestamp, tingkat log, dan informasi tentang acara.

Secara default, perangkat lunakAWS IoT Greengrass Core menulis log hanya ke sistem file lokal. Anda dapat melihat log sistem file secara real time, sehingga Anda dapat men-debug komponen Greengrass yang Anda kembangkan dan terapkan. Anda juga dapat mengonfigurasi perangkat inti untuk menulis log ke CloudWatch log, sehingga Anda dapat memecahkan masalah perangkat inti tanpa akses ke sistem file lokal. Untuk informasi selengkapnya, lihat Aktifkan logging ke CloudWatch Log.

Mengakses log sistem file

Perangkat lunakAWS IoT Greengrass Core menyimpan log di/greengrass/v2/logs folder pada perangkat inti, di mana /greengrass/v2 adalah jalur ke folderAWS IoT Greengrass root. Folder log memiliki struktur berikut.

/greengrass/v2 └── logs ├── greengrass.log ├── greengrass_2021_09_14_15_0.log ├── ComponentName.log ├── ComponentName_2021_09_14_15_0.log └── main.log
  • greengrass.log- File log perangkat lunakAWS IoT Greengrass Inti. Gunakan file log ini untuk melihat informasi real-time tentang komponen dan penerapan. File log ini mencakup log untuk inti Greengrass, yang merupakan inti dari perangkat lunakAWS IoT Greengrass Core, dan komponen plugin, seperti pengelola log dan manajer rahasia.

  • ComponentName.log- Greengrass file log komponen. Gunakan file log komponen untuk melihat informasi real-time tentang komponen Greengrass yang berjalan pada perangkat inti. Komponen generik dan komponen Lambda menulis output standar (stderr).

  • main.log- File log untukmain layanan yang menangani siklus hidup komponen. File log ini akan selalu kosong.

Untuk informasi lebih lanjut tentang perbedaan antara komponen plugin, generik, dan Lambda, lihatJenis komponen.

Pertimbangan berikut berlaku saat Anda menggunakan log sistem file:

  • Izin pengguna root

    Anda harus memiliki izin root untuk membacaAWS IoT Greengrass log pada sistem file.

  • Rotasi file log

    Perangkat lunakAWS IoT Greengrass Core memutar file log setiap jam atau ketika mereka melebihi batas ukuran file. File log yang diputar berisi stempel waktu dalam nama file mereka. Misalnya, file log perangkat lunakAWS IoT Greengrass Core yang diputar mungkin diberi namagreengrass_2021_09_14_15_0.log. Batas ukuran file default adalah 1.024 KB (1 MB). Anda dapat mengkonfigurasi batas ukuran file pada komponen inti Greengrass.

  • Penghapusan file log

    Perangkat lunakAWS IoT Greengrass Core membersihkan file log sebelumnya ketika ukuran file log perangkat lunakAWS IoT Greengrass Core atau file log komponen Greengrass, termasuk file log yang diputar, melebihi batas ruang disk. Batas ruang disk default untuk log perangkat lunakAWS IoT Greengrass Core dan setiap log komponen adalah 10.240 KB (10 MB). Anda dapat mengonfigurasi batas ruang disk log perangkat lunakAWS IoT Greengrass inti pada komponen nukleus Greengrass atau komponen pengelola log. Anda dapat mengkonfigurasi batas ruang disk log setiap komponen pada komponen pengelola log.

Untuk melihat file log perangkat lunakAWS IoT Greengrass inti
  • Jalankan perintah berikut untuk melihat file log secara real time. Ganti /greengrass/v2 dengan jalur menuju AWS IoT Greengrass folder asal.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\com.example.HelloWorld.log

    typePerintah menulis isi file ke terminal. Jalankan perintah ini beberapa kali untuk mengamati perubahan dalam file.

    typePerintah menulis isi file ke terminal. Jalankan perintah ini beberapa kali untuk mengamati perubahan dalam file.

    PowerShell
    gc C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
Untuk melihat berkas log untuk komponen
  • Jalankan perintah berikut untuk melihat file log secara real time. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur menuju folderAWS IoT Greengrass root, dan ganti com.example. HelloWorlddengan nama komponen.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
    PowerShell
    gc C:\greengrass\v2\logs\com.example.HelloWorld.log -Tail 10 -Wait

Anda juga dapat menggunakanlogs perintah Greengrass CLI untuk menganalisis log Greengrass pada perangkat inti. Untuk menggunakanlogs perintah, Anda harus mengkonfigurasi inti Greengrass untuk mengeluarkan file log format JSON. Untuk informasi selengkapnya, lihat Antarmuka Baris Perintah Greengrass dan log.

Akses CloudWatch Log

Anda dapat menerapkan komponen pengelola log untuk mengonfigurasi perangkat inti untuk menulis ke CloudWatch Log. Untuk informasi selengkapnya, lihat Aktifkan logging ke CloudWatch Log. Kemudian, Anda dapat melihat log pada halaman Log CloudWatch konsol Amazon atau menggunakan CloudWatch Logs API.

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 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 log 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 (+).

Pertimbangan berikut berlaku saat Anda menggunakan komponen pengelola CloudWatch log:

  • Penundaan log

    catatan

    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 manajer log log versi 2.3.0 log log log 2.3.0 Saat Anda menulis log baru, pengelola log versi 2.3.0 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 log log log log log log 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 lebih lanjut 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 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, CloudWatch log menolak permintaan. Untuk informasi lebih lanjut, lihat Proses Penandatanganan Signature Version 4 di ReferensiAWS Umum.

Akses log layanan sistem

Jika Anda mengkonfigurasi perangkat lunakAWS IoT Greengrass Core sebagai layanan sistem, Anda dapat melihat log layanan sistem untuk memecahkan masalah, seperti perangkat lunak gagal untuk memulai.

Untuk melihat log layanan sistem (CLI)
  1. Jalankan perintah berikut untuk melihat log layanan sistem perangkat lunakAWS IoT Greengrass core

    Linux or Unix (systemd)
    sudo journalctl -u greengrass.service
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\greengrass.wrapper.log
    PowerShell
    gc C:\greengrass\v2\logs\greengrass.wrapper.log
  2. Pada perangkat Windows, perangkat lunakAWS IoT Greengrass inti membuat file log terpisah untuk kesalahan layanan sistem. Jalankan perintah berikut untuk melihat log kesalahan layanan sistem.

    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\greengrass.err.log
    PowerShell
    gc C:\greengrass\v2\logs\greengrass.err.log

Pada perangkat Windows, Anda juga dapat menggunakan aplikasi Event Viewer untuk melihat log layanan sistem.

Untuk melihat log layanan Windows (Penampil Acara)
  1. Buka aplikasi Event Viewer.

  2. Pilih Windows Logs untuk memperluasnya.

  3. Pilih Aplikasi untuk melihat log layanan aplikasi.

  4. Temukan dan buka log peristiwa yang Sumbernya greengrass.

Aktifkan logging ke CloudWatch Log

Anda dapat menyebarkan log log untuk mengonfigurasi log log untuk mengonfigurasi log ke CloudWatch log. Anda dapat mengaktifkan CloudWatch Log untuk log perangkat lunakAWS IoT Greengrass Core, dan Anda dapat mengaktifkan CloudWatch Log untuk komponen Greengrass tertentu.

catatan

Peran pertukaran token perangkat inti Greengrass harus mengizinkan perangkat inti untuk menulis CloudWatch log, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. Jika Anda menginstal perangkat lunakAWS IoT Greengrass Core dengan penyediaan sumber daya otomatis, perangkat inti Anda memiliki izin ini.

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

Untuk mengonfigurasi perangkatAWS IoT Greengrass inti untuk menulis log perangkat lunak inti ke CloudWatch Log, buat penyebaran yang menentukan pembaruan konfigurasi yang ditetapkanuploadToCloudWatchtrue untukaws.greengrass.LogManager komponen. AWS IoT Greengrass Log perangkat lunak inti mencakup log untuk inti Greengrass dan komponen plugin.

{ "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true" } } }

Untuk mengonfigurasi perangkat inti untuk menulis log komponen Greengrass ke CloudWatch Log, buat penyebaran yang menentukan pembaruan konfigurasi yang menambahkan komponen ke daftar konfigurasi pencatatan komponen. Ketika Anda menambahkan komponen ke daftar ini, komponen pengelola log menulis lognya ke CloudWatch Log. Log komponen termasuk log untuk komponen generik dan komponen Lambda.

{ "logsUploaderConfiguration": { "componentLogsConfigurationMap": { "com.example.HelloWorld": { } } } }

Saat Anda menerapkan komponen pengelola log, Anda juga dapat mengonfigurasi batas ruang disk dan apakah perangkat inti menghapus file log setelah menuliskannya ke CloudWatch Log. Untuk informasi selengkapnya, lihat Konfigurasi pencatatan untuk AWS IoT Greengrass.

Konfigurasi pencatatan untuk AWS IoT Greengrass

Anda dapat mengkonfigurasi opsi berikut untuk menyesuaikan logging untuk perangkat inti Greengrass. Untuk mengonfigurasi opsi ini, buat penyebaran yang menentukan pembaruan konfigurasi ke inti Greengrass atau komponen pengelola log.

  • Menulis log untuk CloudWatch Log

    Untuk memecahkan masalah perangkat inti dari jarak jauh, Anda dapat mengonfigurasi perangkat inti untuk menulis perangkat lunakAWS IoT Greengrass Inti dan log komponen ke CloudWatch Log. Untuk melakukannya, gunakan dan konfigurasikan komponen pengelola log. Untuk informasi selengkapnya, lihat Aktifkan logging ke CloudWatch Log.

  • Menghapus file log yang diunggah

    Untuk mengurangi penggunaan ruang disk, Anda dapat mengkonfigurasi perangkat inti untuk menghapus file log setelah menulis file log ke CloudWatch Log. Untuk informasi selengkapnya, lihatdeleteLogFileAfterCloudUpload parameter komponen pengelola log, yang dapat Anda tentukan untuk log perangkat lunakAWS IoT Greengrass inti dan log komponen.

  • Batas ruang disk log

    Untuk membatasi penggunaan ruang disk, Anda dapat mengonfigurasi ruang disk maksimum untuk setiap log, termasuk file log yang diputar, pada perangkat inti. Misalnya, Anda dapat mengkonfigurasi ruang disk gabungan maksimum untukgreengrass.log dangreengrass.log file yang diputar. Untuk informasi selengkapnya, lihat parameter Greengrass nucleus component danlogging.totalLogsSizeKB parameter komponen pengelola log, yang dapat Anda tentukan untuk log perangkat lunakAWS IoT Greengrass Core dan log komponen.diskSpaceLimit

  • Batas ukuran log

    Anda dapat mengonfigurasi ukuran file maksimum untuk setiap file log. Setelah file log melebihi batas ukuran file ini, perangkat lunakAWS IoT Greengrass inti membuat file log baru. Komponen pengelola log hanya menulis file log yang diputar ke CloudWatch Log, sehingga Anda dapat menentukan batas ukuran file yang lebih rendah untuk menulis log ke CloudWatch Log lebih sering. Untuk informasi selengkapnya, lihat parameter batas ukuran file log komponen inti Greengrass (logging.fileSizeKB).

  • Tingkat log minimum

    Anda dapat mengkonfigurasi tingkat log minimum yang ditulis oleh komponen nukleus Greengrass ke log sistem file. Misalnya, Anda dapat menentukan logDEBUG level untuk membantu mengatasi masalah, atau Anda dapat menentukan logERROR level untuk mengurangi jumlah log yang dibuat oleh perangkat inti. Untuk informasi lebih lanjut, lihat parameter log log (logging.level) dari komponen inti Greengrass.

    Anda juga dapat mengkonfigurasi tingkat log minimum yang ditulis oleh komponen pengelola CloudWatch log ke Log. Misalnya, Anda dapat menentukan tingkat log yang lebih tinggi untuk mengurangi biaya logging. Untuk informasi selengkapnya, lihatminimumLogLevel parameter komponen pengelola log, yang dapat Anda tentukan untuk log perangkat lunakAWS IoT Greengrass inti dan log komponen.

  • Interval untuk memeriksa log untuk menulis ke CloudWatch Log

    Untuk menambah atau mengurangi seberapa sering komponen pengelola log menulis log ke CloudWatch Log, Anda dapat mengkonfigurasi interval di mana ia memeriksa file log baru untuk menulis. Misalnya, Anda mungkin menentukan interval yang lebih rendah untuk melihat log di CloudWatch Log lebih cepat daripada yang Anda lakukan dengan interval 5 menit default. Anda mungkin menentukan interval yang lebih tinggi untuk mengurangi biaya, karena komponen pengelola log mengelompokkan file log menjadi lebih sedikit permintaan. Untuk informasi lebih lanjut, lihat parameter log manager log (periodicUploadIntervalSec).

  • Format log

    Anda dapat memilih apakah perangkat lunakAWS IoT Greengrass Core menulis log dalam teks atau format JSON. Pilih format teks jika Anda membaca log, atau pilih format JSON jika Anda menggunakan aplikasi untuk membaca atau mengurai log. Untuk informasi lebih lanjut, lihat parameter log Greengrass nucleus component (logging.format).

  • Folder log sistem file lokal

    Anda dapat mengubah folder log dari/greengrass/v2/logs ke folder lain pada perangkat inti. Untuk informasi lebih lanjut, lihat parameter direktori output Greengrass nucleus (logging.outputDirectory).

Log AWS CloudTrail

AWS IoT Greengrassterintegrasi denganAWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atauLayanan AWSAWS IoT Greengrass masuk Untuk informasi selengkapnya, lihat Catat panggilan API AWS IoT Greengrass V2 dengan AWS CloudTrail.