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

# 接收
<a name="pipeline-sinks"></a>

接收器定義傳送已處理日誌資料的目的地。每個管道必須只有一個接收器。目前僅支援 CloudWatch Logs 接收器。


**依來源類型的接收器行為**  

| 來源類型 | 日誌群組組態 | Behavior (行為) | 
| --- | --- | --- | 
| CloudWatch Logs | 必須使用 @original | 事件會傳回至其原始日誌群組 | 
| S3 | 自訂日誌群組路徑 | 事件會傳送至指定的日誌群組 | 
| 第三方 APIs | 自訂日誌群組路徑 | 事件會傳送至指定的日誌群組 | 

**Configuration**  
使用下列參數設定接收器：

**Example 非 CloudWatch Logs 來源組態**  

```
sink:
  cloudwatch_logs:
    log_group: "/aws/my-application/logs"
```

**Example CloudWatch Logs 來源組態**  

```
sink:
  cloudwatch_logs:
    log_group: "@original"
```Parameters

`log_group` (必要)  
傳送已處理事件的 CloudWatch Logs 日誌群組名稱。對於具有非`cloudwatch_logs` 來源的管道，這必須是現有的日誌群組名稱。對於使用`cloudwatch_logs`來源的管道， ONLY 允許的值為 `@original`。

`include_original` (選用)  
出現時， 會先儲存每個原始日誌事件的副本，再進行任何轉換。這會保留原始資料以供稽核或合規之用。將 指定為空白物件 (`{}`)。僅適用於具有`cloudwatch_logs`來源的管道。啟用此選項時，至少必須設定一個處理器。

**Example 具有原始日誌保留的 CloudWatch Logs 接收器**  

```
sink:
  - cloudwatch_logs:
      log_group: "@original"
      include_original: {}
```

## 要求與限制
<a name="sink-requirements"></a>

日誌群組存在  
如果使用 建立 AWS 管理主控台，且在使用非 CloudWatch 日誌來源時不存在，CloudWatch 將嘗試建立指定的日誌群組和適當的資源政策。否則，在建立管道之前，指定的日誌群組必須存在。

事件大小  
每個日誌事件在處理後的大小不得超過 256 KB。

日誌群組保留  
管道會使用在目的地日誌群組上設定的保留設定。

日誌群組和資源政策  
寫入日誌群組的管道需要 CloudWatch Logs 資源政策，但使用`cloudwatch_logs`來源的管道除外。當您使用 AWS 管理主控台 設定管道時，CloudWatch 會視需要嘗試新增資源政策。如果您使用 AWS CLI 或 API 建立管道，則必須手動建立政策，並使用 `logs:PutResourcePolicy`請求新增政策。如需詳細資訊，請參閱[資源政策](pipeline-iam-reference.md#resource-policies)。

跨區域支援  
目的地日誌群組必須與管道位於相同的區域。

**重要**  
對於使用 `cloudwatch_logs` 來源類型的管道：  
您必須使用 `@original`做為日誌群組值。
事件一律會傳回至其原始日誌群組。
原始日誌群組必須存在於管道的整個生命週期中。
具有處理器的管道會變更原始 CloudWatch 日誌群組中的日誌事件，而原始 CloudWatch 日誌群組會從 AWS 服務中攔截日誌。若要保留原始資料，請在接收器組態`include_original`中啟用 。

**注意**  
日誌事件受 CloudWatch Logs 配額和限制約束。