接收 - Amazon CloudWatch
要求與限制

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

接收

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

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

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

範例 非 CloudWatch Logs 來源組態
sink:
  cloudwatch_logs:
    log_group: "/aws/my-application/logs"
範例 CloudWatch Logs 來源組態
sink:
  cloudwatch_logs:
    log_group: "@original"
Parameters
log_group (必要)

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

要求與限制

日誌群組存在

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

事件大小

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

日誌群組保留

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

日誌群組和資源政策

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

跨區域支援

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

重要

對於使用cloudwatch_logs來源類型的管道：

  • 您必須使用 @original做為日誌群組值。

  • 事件一律會傳回至其原始日誌群組。

  • 原始日誌群組必須存在於管道的整個生命週期中。

  • 具有處理器的管道會變更原始 CloudWatch 日誌群組中的日誌事件，而原始 CloudWatch 日誌群組會從 AWS 服務中攔截日誌。

注意

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