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

Forwarder log sistem

System log forwarder (aws.greengrass.SystemLogForwarder) mengunggah log sistem aktif langsung ke Amazon CloudWatch menggunakan HTTPS API. CloudWatch

Versi

Komponen ini memiliki versi berikut:

Tipe

Komponen ini adalah komponen generik (aws.greengrass.generic). Inti Greengrass menjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini harus diinstal pada sistem Linux berbasis sistem.

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

Komponen ini memerlukan akses untuk membuat log dan grup streaming CloudWatch serta izin untuk melakukan panggilan PutLogEvents HTTP. Anda harus, setidaknya, menambahkan izin kebijakan berikut ke alias peran perangkat Greengrass Anda:

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogGroup"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:*"
    },
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogStream", "logs:PutLogEvents"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:log-stream:${credentials-iot:ThingName}"
    }
  ]
}

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.

Dependensi

Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga 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.1.x

Tabel berikut mencantumkan dependensi untuk versi 2.1.x dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Layanan penukaran Token	>=2.0.0	Keras
Greengrass nucleus lite	>=2.3.0	Lunak

2.0.x

Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Layanan penukaran Token	>=2.0.0	Keras

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

2.0.x-2.1.x

maxUploadIntervalSec

Periode maksimum di mana pengirim log sistem akan mencoba mengunggah log. Karena log forwarder akan mengunggah log ketika memori terisi, mungkin masih mengunggah lebih sering daripada irama maksimum yang dikonfigurasi.

maxRetriesCount

Berapa kali sistem log forwarder akan mencoba untuk mencoba lagi kesalahan HTTP sementara.

bufferCapacity

Ukuran buffer cincin untuk penyimpanan log dalam memori.

logGroup

Jalur log masuk CloudWatch.

logStream

CloudWatch LogStream.

filters

Peta konfigurasi filter untuk perangkat inti.

services

Daftar filter nama layanan yang akan digunakan oleh System Log Forwarder untuk menentukan log mana yang akan diunggah. Log hanya akan diunggah jika layanan asalnya cocok dengan setidaknya salah satu filter dalam daftar ini. Filter dalam daftar ini dapat berupa string yang nama layanan harus sepenuhnya cocok, atau string yang diakhiri dengan *, yang berarti awalan harus cocok.

Default: [ggl.*]

penting

Log hanya akan diunggah jika layanan asalnya cocok dengan setidaknya salah satu filter dalam daftar ini.

catatan

Menggunakan nilai* akan mencakup semua layanan yang tersedia.

contoh Contoh konfigurasi:

Contoh di bawah ini akan memfilter log berdasarkan semua layanan yang disertakan dalam Greengrass Nucleus Lite.

{
    "maxUploadIntervalSec": 300,
    "maxRetriesCount": 3,
    "bufferCapacity": 1048576,
    "logGroup": "greengrass/systemLogs",
    "logStream": "deviceName",
    "filters": {
        "services": ["ggl.*"]
    }
}

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.