log - AWS IoT Greengrass
memperolehlist-keywordslist-log-files

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

log

Gunakan perintah logs untuk menganalisis log Greengrass pada perangkat inti Anda.

Subperintah

memperoleh

Kumpulkan, filter, dan visualisasikan file log Greengrass. Perintah ini hanya mendukung file log berformat JSON. Anda dapat menentukan format logging dalam konfigurasi nukleus.

Sinopsis
greengrass-cli logs get
    [--log-dir path/to/a/log/folder]
    [--log-file path/to/a/log/file]
    [--follow true | false ]
    [--filter <filter> ]
    [--time-window <start-time>,<end-time> ]
    [--verbose ]
    [--no-color ]
    [--before <value> ]
    [--after <value> ]
    [--syslog ]
    [--max-long-queue-size <value> ]
Argumen

  • --log-dir,-ld. Jalur ke direktori untuk memeriksa file log, seperti/greengrass/v2/logs. Jangan gunakan dengan --syslog. Gunakan argumen terpisah untuk setiap direktori tambahan yang akan ditentukan. Anda harus menggunakan setidaknya salah satu dari --log-dir atau --log-file. Anda juga dapat menggunakan kedua argumen dalam satu perintah.

  • --log-file, -lf. Jalur ke direktori log yang ingin Anda gunakan. Gunakan argumen terpisah untuk setiap direktori tambahan yang akan ditentukan. Anda harus menggunakan setidaknya salah satu dari --log-dir atau --log-file. Anda juga dapat menggunakan kedua argumen dalam satu perintah.

  • --follow, -fol. Tampilkan pembaruan log saat terjadi. Greengrass CLI terus berjalan dan membaca dari log tertentu. Jika Anda menentukan jendela waktu, Greengrass CLI berhenti memantau log setelah semua jendela waktu berakhir.

  • --filter, -f. Kata kunci, ekspresi reguler, atau pasangan kunci-nilai untuk digunakan sebagai filter. Berikan nilai ini sebagai string, ekspresi reguler, atau sebagai pasangan kunci-nilai. Gunakan argumen terpisah untuk setiap filter tambahan yang akan ditentukan.

    Ketika dievaluasi, beberapa filter yang ditentukan dalam argumen tunggal dipisahkan oleh operator OR, dan filter yang ditentukan dalam argumen tambahan digabungkan dengan operator AND. Misalnya, jika perintah Anda mencakup --filter "installed" --filter "name=alpha,name=beta", maka Greengrass CLI akan memfilter dan menampilkan pesan log yang berisi baik kata kunci installed maupun kunci name yang memiliki nilai alpha atau beta.

  • --time-window, -t. Jendela waktu untuk menampilkan informasi log. Anda dapat menggunakan kedua stempel waktu yang tepat dan offset relatif. Anda harus memberikan informasi ini dalam format <begin-time>,<end-time>. Jika Anda tidak menentukan baik waktu mulai maupun waktu akhir, nilai untuk opsi default ke tanggal dan waktu sistem saat ini. Gunakan argumen terpisah untuk setiap jendela waktu tambahan yang akan ditentukan.

    Greengrass CLI mendukung format berikut untuk stempel waktu:

    • yyyy-MM-DD, misalnya, 2020-06-30. Waktu default adalah 00:00:00 ketika Anda menggunakan format ini.

      yyyyMMDD, misalnya, 20200630. Waktu default adalah 00:00:00 ketika Anda menggunakan format ini.

      HH:mm:ss, misalnya, 15:30:45. Tanggal default adalah tanggal sistem saat ini ketika Anda menggunakan format ini.

      HH:mm:ssSSS, misalnya, 15:30:45. Tanggal default adalah tanggal sistem saat ini ketika Anda menggunakan format ini.

      YYYY-MM-DD'T'HH:mm:ss'Z', misalnya, 2020-06-30T15:30:45Z.

      YYYY-MM-DD'T'HH:mm:ss, misalnya, 2020-06-30T15:30:45.

      yyyy-MM-dd'T'HH:mm:ss.SSS, misalnya, 2020-06-30T15:30:45.250.

    Offset relatif menentukan jangka waktu offset dari waktu sistem saat ini. Greengrass CLI mendukung format berikut untuk offset relatif: +|-[<value>h|hr|hours][valuem|min|minutes][value]s|sec|seconds.

    Misalnya, argumen berikut untuk menentukan jendela waktu antara 1 jam dan 2 jam 15 menit sebelum waktu saat ini adalah --time-window -2h15min,-1hr.

  • --verbose. Tampilkan semua kolom dari pesan log. Jangan gunakan dengan --syslog.

  • --no-color, -nc. Hapus kode warna. Default pengkodean warna untuk pesan log menggunakan teks merah tebal. Mendukung hanya terminal seperti UNIX karena menggunakan ANSI escape sequence.

  • --before, -b. Jumlah baris yang akan ditunjukkan mendahului entri log yang cocok. Default-nya adalah 0.

  • --after, -a. Jumlah baris yang akan ditunjukkan mengikuti entri log yang cocok. Default-nya adalah 0.

  • --syslog. Proses semua file log menggunakan protokol syslog yang ditentukan oleh RFC3164. Jangan gunakan dengan --log-dir dan --verbose. Protokol syslog menggunakan format berikut: "<$Priority>$Timestamp $Host $Logger ($Class): $Message". Jika Anda tidak menentukan berkas log, Greengrass CLI akan membaca pesan log dari lokasi-lokasi berikut: /var/log/messages, /var/log/syslog, atau /var/log/system.log.

    AWS IoT Greengrasssaat ini tidak mendukung fitur ini di perangkat inti Windows.

  • --max-log-queue-size, -m. Jumlah maksimum entri log yang akan dialokasikan ke memori. Gunakan opsi ini untuk mengoptimalkan penggunaan memori. Default adalah 100.

Keluaran

Contoh berikut menunjukkan output yang dihasilkan ketika Anda menjalankan perintah ini.

$ sudo greengrass-cli logs get --verbose \
    --log-file /greengrass/v2/logs/greengrass.log \
    --filter deployment,serviceName=DeploymentService \
    --filter level=INFO \
    --time-window 2020-12-08T01:11:17,2020-12-08T01:11:22

2020-12-08T01:11:17.615Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.DeploymentService: Current deployment finished. {DeploymentId=44d89f46-1a29-4044-ad89-5151213dfcbc, serviceName=DeploymentService, currentState=RUNNING}
2020-12-08T01:11:17.675Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.IotJobsHelper: Updating status of persisted deployment. {Status=SUCCEEDED, StatusDetails={detailed-deployment-status=SUCCESSFUL}, ThingName=MyThing, JobId=22d89f46-1a29-4044-ad89-5151213dfcbc

list-keywords

Tampilkan kata kunci yang disarankan yang dapat Anda gunakan untuk memfilter berkas log.

Sinopsis
greengrass-cli logs list-keywords [arguments]
Argumen

Tidak ada

Keluaran

Contoh berikut menunjukkan output yang dihasilkan ketika Anda menjalankan perintah ini.

$ sudo greengrass-cli logs list-keywords

Here is a list of suggested keywords for Greengrass log:
level=$str
thread=$str
loggerName=$str
eventType=$str
serviceName=$str
error=$str
$ sudo greengrass-cli logs list-keywords --syslog

Here is a list of suggested keywords for syslog:
priority=$int
host=$str
logger=$str
class=$str

list-log-files

Tampilkan file log yang terletak di direktori tertentu.

Sinopsis
greengrass-cli logs list-log-files [arguments]
Argumen

--log-dir, -ld. Jalur ke direktori untuk memeriksa file log.

Keluaran

Contoh berikut menunjukkan output yang dihasilkan ketika Anda menjalankan perintah ini.

$ sudo greengrass-cli logs list-log-files -ld /greengrass/v2/logs/

/greengrass/v2/logs/aws.greengrass.Nucleus.log
/greengrass/v2/logs/main.log
/greengrass/v2/logs/greengrass.log
Total 3 files found.