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

# Forwarder log sistem
<a name="system-log-forwarder-component"></a>

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

**penting**  
Komponen ini hanya akan meneruskan log systemd-journald yang dihasilkan selama runtime. [Untuk informasi selengkapnya tentang log systemd-journald, lihat [systemd-journald](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html) dan journalctl.](https://www.freedesktop.org/software/systemd/man/latest/journalctl.html#)

**catatan**  
Komponen ini memerlukan izin khusus untuk membuat dan mengelola grup dan aliran CloudWatch log.

**Topics**
+ [Versi](#system-log-forwarder-component-versions)
+ [Jenis](#system-log-forwarder-component-type)
+ [Sistem operasi](#system-log-forwarder-component-os-support)
+ [Persyaratan](#system-log-forwarder-component-requirements)
+ [Titik akhir dan port](#system-log-forwarder-component-endpoints)
+ [Dependensi](#system-log-forwarder-component-dependencies)
+ [Konfigurasi](#system-log-forwarder-component-configuration)
+ [Changelog](#system-log-forwarder-component-changelog)

## Versi
<a name="system-log-forwarder-component-versions"></a>

Komponen ini memiliki versi berikut:
+ 2.1.x
+ 2.0.x

## Jenis
<a name="system-log-forwarder-component-type"></a>

<a name="public-component-type-generic"></a><a name="public-component-type-generic-phrase"></a>Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen.

<a name="public-component-type-more-information"></a>Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types).

## Sistem operasi
<a name="system-log-forwarder-component-os-support"></a>

Komponen ini harus diinstal pada sistem Linux berbasis sistem.

## Persyaratan
<a name="system-log-forwarder-component-requirements"></a>

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}"
    }
  ]
}
```

------

**catatan**  
Untuk informasi selengkapnya, lihat halaman [Github](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) System Log Forwarder.

## Titik akhir dan port
<a name="system-log-forwarder-component-endpoints"></a>

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](allow-device-traffic.md).


| Titik akhir | Port | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
|  `logs.region.amazonaws.com`  | 443 | Tidak |  Diperlukan jika Anda menulis log ke CloudWatch Log.  | 

## Dependensi
<a name="system-log-forwarder-component-dependencies"></a>

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](#system-log-forwarder-component-changelog) 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](https://console.aws.amazon.com//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](token-exchange-service-component.md) | >=2.0.0 | Keras | 
| [Greengrass nucleus lite](greengrass-nucleus-lite-component.md) | >=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](token-exchange-service-component.md) | >=2.0.0 | Keras | 

------

## Konfigurasi
<a name="system-log-forwarder-component-configuration"></a>

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 \$1, yang berarti awalan harus cocok.  
Default: `[ggl.*]`  
Log hanya akan diunggah jika layanan asalnya cocok dengan setidaknya salah satu filter dalam daftar ini.
Menggunakan nilai\$1 akan mencakup semua layanan yang tersedia.

**Example 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
<a name="system-log-forwarder-component-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.


|  **Versi**  |  **Perubahan**  | 
| --- | --- | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.0  |  Versi awal.  |