本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 系統日誌轉寄站
<a name="system-log-forwarder-component"></a>

系統日誌轉送器 (`aws.greengrass.SystemLogForwarder`) 會使用 Amazon CloudWatch CloudWatch。

**重要**  
此元件只會轉送執行時間期間產生的 systemd-journald 日誌。如需 systemd-journald 日誌的詳細資訊，請參閱 [systemd-journald](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html) 和 [journalctl](https://www.freedesktop.org/software/systemd/man/latest/journalctl.html#)。

**注意**  
此元件需要特定許可，才能建立和管理 CloudWatch 日誌群組和串流。

**Topics**
+ [版本](#system-log-forwarder-component-versions)
+ [Type](#system-log-forwarder-component-type)
+ [作業系統](#system-log-forwarder-component-os-support)
+ [要求](#system-log-forwarder-component-requirements)
+ [端點和連接埠](#system-log-forwarder-component-endpoints)
+ [相依性](#system-log-forwarder-component-dependencies)
+ [Configuration](#system-log-forwarder-component-configuration)
+ [變更記錄](#system-log-forwarder-component-changelog)

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

此元件具有下列版本：
+ 2.1.x
+ 2.0.x

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

<a name="public-component-type-generic"></a>此<a name="public-component-type-generic-phrase"></a>元件是一般元件 (`aws.greengrass.generic`)。[Greengrass 核](greengrass-nucleus-component.md)會執行元件的生命週期指令碼。

<a name="public-component-type-more-information"></a>如需詳細資訊，請參閱[元件類型](develop-greengrass-components.md#component-types)。

## 作業系統
<a name="system-log-forwarder-component-os-support"></a>

此元件必須安裝在以系統為基礎的 Linux 系統上。

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

此元件有下列需求：

元件需要存取才能在 CloudWatch 中建立日誌和串流群組，以及執行 PutLogEvents HTTP 呼叫的許可。您必須至少將下列政策許可新增至 Greengrass 裝置的角色別名：

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

------

**注意**  
如需詳細資訊，請參閱 System Log Forwarder [Github](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) 頁面。

## 端點和連接埠
<a name="system-log-forwarder-component-endpoints"></a>

除了基本操作所需的端點和連接埠之外，此元件還必須能夠對下列端點和連接埠執行傳出請求。如需詳細資訊，請參閱[允許透過代理或防火牆的裝置流量](allow-device-traffic.md)。


| Endpoint | 站點 | 必要 | Description | 
| --- | --- | --- | --- | 
|  `logs.region.amazonaws.com`  | 443 | 否 |  如果您將日誌寫入 CloudWatch Logs，則為必要項目。  | 

## 相依性
<a name="system-log-forwarder-component-dependencies"></a>

當您部署元件時， AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的要求，才能成功部署元件。本節列出此元件[發行版本的](#system-log-forwarder-component-changelog)相依性，以及為每個相依性定義元件版本的語意版本限制。您也可以在 [AWS IoT Greengrass 主控台](https://console.aws.amazon.com//greengrass)中檢視每個版本元件的相依性。在元件詳細資訊頁面上，尋找**相依性**清單。

------
#### [ 2.1.x ]

下表列出此元件 2.1.x 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [權杖交換服務](token-exchange-service-component.md) | >=2.0.0 | 硬式 | 
| [Greengrass nucleus lite](greengrass-nucleus-lite-component.md) | >=2.3.0 | 軟式 | 

------
#### [ 2.0.x ]

下表列出此元件 2.0.x 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [權杖交換服務](token-exchange-service-component.md) | >=2.0.0 | 硬式 | 

------

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

此元件提供下列組態參數，您可以在部署元件時自訂這些參數。

------
#### [ 2.0.x-2.1.x ]

`maxUploadIntervalSec`  
系統日誌轉送器將嘗試上傳日誌的最長期間。由於日誌轉送器會在記憶體填滿時上傳日誌，因此其上傳頻率可能仍高於設定的最大節奏。

`maxRetriesCount`  
系統日誌轉寄站嘗試重試暫時性 HTTP 錯誤的次數。

`bufferCapacity`  
記憶體內日誌儲存的環形緩衝區大小。

`logGroup`  
CloudWatch 中的日誌路徑。

`logStream`  
CloudWatch logStream。

`filters`  
核心裝置的篩選條件組態映射。    
`services`  
System Log Forwarder 將用於判斷上傳哪些日誌的服務名稱篩選條件清單。只有在源自 的服務符合此清單中的至少一個篩選條件時，才會上傳日誌。此清單中的篩選條件可能是服務名稱必須完全相符的字串，或是結尾為 \$1 的字串，這表示字首必須相符。  
預設：`[ggl.*]`  
只有在源自 的服務符合此清單中的至少一個篩選條件時，才會上傳日誌。
使用值 \$1 將包含所有可用的服務。

**Example 範例組態：**  
以下範例會依 Greengrass Nucleus Lite 中包含的所有服務篩選日誌。  

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

------

## 變更記錄
<a name="system-log-forwarder-component-changelog"></a>

下表說明每個版本元件的變更。


|  **版本**  |  **變更**  | 
| --- | --- | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.0  |  初始版本。  |