AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

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

Pemantauan dengan AWS IoT Greengrass log

AWS IoT Greengrass terdiri dari layanan cloud dan AWS IoT Greengrass perangkat lunak core. Perangkat lunak AWS IoT Greengrass Core dapat menulis log ke Amazon CloudWatch dan ke sistem file lokal perangkat inti Anda. Fungsi dan konektor Lambda yang berjalan pada inti juga dapat menulis CloudWatch log ke 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. Perubahan pada pengaturan pencatatan berlaku setelah Anda men-deploy grup.

Pencatatan dikonfigurasi pada tingkat grup. Untuk langkah-langkah yang menunjukkan cara mengonfigurasi pencatatan untuk grup Greengrass, lihat Konfigurasi pencatatan untuk AWS IoT Greengrass.

Mengakses Log CloudWatch

Jika Anda mengonfigurasi CloudWatch logging, Anda dapat melihat log di halaman Log di CloudWatch konsol Amazon. Grup log untuk log AWS IoT Greengrass menggunakan konvensi penamaan berikut:

/aws/greengrass/GreengrassSystem/greengrass-system-component-name
/aws/greengrass/Lambda/aws-region/account-id/lambda-function-name

Setiap grup log berisi aliran log yang menggunakan Konvensi penamaan berikut:

date/account-id/greengrass-group-id/name-of-core-that-generated-log

Pertimbangan berikut berlaku saat Anda menggunakan CloudWatch Log:

Mengakses log sistem file

Jika Anda mengonfigurasi pencatatan sistem file, file log disimpan di bawah greengrass-root/ggc/var/log pada perangkat core. Berikut ini adalah struktur direktori tingkat tinggi:

greengrass-root/ggc/var/log
    - crash.log
    - system
        - log files for each Greengrass system component
    - user
        - region
            - account-id
                - log files generated by each user-defined Lambda function
            - aws
                - log files generated by each connector

Pertimbangan berikut berlaku saat Anda menggunakan log sistem file:

Konfigurasi pencatatan default

Jika pengaturan pencatatan tidak dikonfigurasi secara eksplisit, AWS IoT Greengrass akan menggunakan konfigurasi pencatatan default berikut setelah deployment grup pertama.

Konfigurasi pencatatan untuk AWS IoT Greengrass

Anda dapat menggunakan konsol AWS IoT tersebut atau AWS IoT Greengrass API untuk mengonfigurasi AWS IoT Greengrass pencatatan.

Konfigurasi pencatatan (konsol)

Anda dapat mengonfigurasi pencatatan di grup halaman Pengaturan ini.

Konfigurasi pencatatan (API)

Anda dapat menggunakan pencatat AWS IoT Greengrass API untuk mengonfigurasi pencatatan pemrograman. Misalnya, gunakan tindakan CreateLoggerDefinition untuk membuat definisi pencatat berdasarkan muatan LoggerDefinitionVersion ini, yang menggunakan sintaks berikut:

{
  "Loggers": [
    {
      "Id": "string",
      "Type": "FileSystem|AWSCloudWatch",
      "Component": "GreengrassSystem|Lambda",
      "Level": "DEBUG|INFO|WARN|ERROR|FATAL",
      "Space": "integer"
    },
    {
      "Id": "string",
      ...
    }
  ]
}

LoggerDefinitionVersion adalah array dari satu atau lebih objek Logger yang memiliki properti berikut:

Contoh konfigurasI

Contoh LoggerDefinitionVersion berikut menentukan konfigurasi pencatatan yang:

{
  "Name": "LoggingExample",
  "InitialVersion": {
    "Loggers": [
      {
        "Id": "1",
        "Component": "GreengrassSystem",
        "Level": "ERROR",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "2",
        "Component": "Lambda",
        "Level": "INFO",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "3",
        "Component": "Lambda",
        "Level": "INFO",
        "Type": "AWSCloudWatch"
      }
    ]
  }
}

Setelah Anda membuat versi definisi pencatat, Anda dapat menggunakan versi ARN untuk membuat versi grup sebelum men-deploy grup.

Batasan pencatatan

AWS IoT Greengrass memiliki batasan pencatatan berikut.

Transaksi per detik (TPS)

Saat login ke CloudWatch diaktifkan, komponen logging akan mengumpulkan peristiwa log secara lokal sebelum mengirimnya CloudWatch, sehingga Anda dapat masuk dengan kecepatan lebih tinggi dari lima permintaan per detik per aliran log.

Memori

Jika AWS IoT Greengrass dikonfigurasi untuk mengirim log ke CloudWatch dan fungsi Lambda mencatat lebih dari 5 MB/detik untuk jangka waktu yang lama, pipeline pemrosesan internal akhirnya terisi. Kasus terburuk teoritis adalah 6 MB per fungsi Lambda.

Clock skew

Saat login ke CloudWatch diaktifkan, komponen logging menandatangani permintaan untuk CloudWatch menggunakan proses penandatanganan Signature Version 4 normal. Jika waktu sistem pada perangkat AWS IoT Greengrass core tidak sinkron lebih dari 15 menit, maka permintaan ditolak.

Penggunaan disk

Gunakan rumus berikut untuk menghitung jumlah maksimum total penggunaan disk dalam pencatatan.

greengrass-system-component-space * 8    // 7 if automatic IP detection is disabled
  + 128KB                                // the internal log for the local logging component
  + lambda-space * lambda-count          // different versions of a Lambda function are treated as one

Di mana:

Kehilangan log

Jika perangkat AWS IoT Greengrass inti Anda dikonfigurasi untuk masuk hanya ke CloudWatch dan tidak ada konektivitas internet, Anda tidak memiliki cara untuk mengambil log yang saat ini ada di memori.

Ketika fungsi Lambda dihentikan (misalnya, selama penerapan), log selama beberapa detik tidak ditulis. CloudWatch

CloudTrail log

AWS IoT Greengrass berjalan dengan AWS CloudTrail, layanan yang menyediakan log tindakan yang diambil oleh pengguna, peran, atau layanan AWS di AWS IoT Greengrass. Lihat informasi yang lebih lengkap di Mencatat log panggilan API AWS IoT Greengrass dengan AWS CloudTrail.