日誌 Amazon EventBridge 管道 - Amazon EventBridge
管道記錄的運作方式指定日誌層級在日誌中包含執行資料記錄檔日誌中的錯誤報告

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

日誌 Amazon EventBridge 管道

EventBridge 管道記錄可讓「管 EventBridge 道」將詳細管道效能的記錄傳送至支援的 AWS 服務。使用日誌來深入瞭解管道的執行效能，並協助進行疑難排解和偵錯。

您可以選取下列 AWS 服務作為 P EventBridge ipes 傳送記錄的記錄目標：

  • CloudWatch 日誌

    EventBridge 會將記錄 CloudWatch 檔記錄傳送至指定的記錄檔記錄群組。

    使用 CloudWatch Logs 將您使用的所有系統、應用程式和 AWS 服務的記錄集中在單一、可高度擴充的服務中。如需詳細資訊，請參閱 Amazon CloudWatch 日誌使用者指南中的使用日誌群組和日誌串流。

  • Firehose 流原木

    EventBridge 將日誌記錄傳送到 Firehose 交付流。

    Amazon Data Firehose 是一項全受管服務，可將即時串流資料傳送至特定服 AWS 務等目的地，以及支援的第三方服務供應商擁有的任何自訂 HTTP 端點或 HTTP 端點。如需詳細資訊，請參閱 Amazon 資料 Firehose 使用者指南中的建立 Amazon 資料 Firehose 交付串流。

  • Amazon S3 日誌

    EventBridge 以 Amazon S3 物件的形式將日誌記錄傳送到指定的儲存貯體。

    Amazon S3 是一項物件儲存服務，提供領先業界的可擴展性、資料可用性、安全性和效能。如需詳細資訊，請參閱《Amazon Simple Storage Service 使用者指南》中的 Amazon S3 中的上傳、下載和使用 Amazon S3 中的物件。

Amazon EventBridge 管道日誌如何工作

管道接收到的每個事件或一批事件，而該事件傳遞到一個擴充和/或目標都被視為管道執行。如果啟用，則 EventBridge 會在處理事件批次時為其執行的每個執行步驟產生記錄。記錄中包含的資訊會套用至事件批次，無論是單一事件還是最多 10,000 個事件。

您可以在管道來源和目標上設定事件批次的大小。如需詳細資訊，請參閱 Amazon EventBridge 管道批處理和並發。

傳送至每個日誌目的地的記錄資料相同。

如果已設定 Amazon CloudWatch 日誌目的地，傳送到所有目的地的日誌記錄的限制為 256kb。欄位將視需要截斷。

您可以使用下列方式自訂 EventBridge 傳送至所選記錄目的地的記錄：

  • 您可以指定記錄層級，以決定 EventBridge 將記錄傳送至所選記錄目的地的執行步驟。如需詳細資訊，請參閱 指定 EventBridge 管道記錄層級。

  • 您可以指定 P EventBridge ipes 是否在相關執行步驟的記錄中包含執行資料。此資料包括：

    • 事件批次的裝載

    • 傳送至 AWS 擴充功能或目標服務的要求

    • AWS 擴充或目標服務傳回的回應

    如需詳細資訊，請參閱 在 EventBridge 管道記錄中包含執行資料。

指定 EventBridge 管道記錄層級

您可以指定 EventBridge 將記錄傳送至所選記錄目的地的執行步驟類型。

請從下列詳細層次中選擇要包含在日誌記錄中的細節層次。日誌層級會套用至為管道指定的所有日誌目的地。每個日誌層級都包含先前日誌層級的執行步驟。

  • 關閉 — EventBridge 不傳送任何記錄到任何指定的記錄目的地。這是預設設定。

  • ERROR — EventBridge 將與管道執行期間產生的錯誤相關的任何記錄傳送至指定的記錄目的地。

  • INFO — EventBridge 傳送與錯誤相關的任何記錄，以及選取管道執行期間執行的其他步驟至指定的記錄目的地。

  • TRACE — EventBridge 將在管道執行任何步驟期間產生的任何記錄傳送至指定的記錄目的地。

在 EventBridge 主控台中，預設會選取 CloudWatch 記錄檔做為記錄目的地，與記ERROR錄層級一樣。因此，依預設，P EventBridge ipes 會建立新的記 CloudWatch 錄群組，將包含詳細資料ERROR層級的記錄檔記錄傳送至該群組。以程式設計方式設定日誌記錄檔時，不會選取預設值。

下表列出了每個日誌層級中包含的執行步驟。

步驟 TRACE INFO ERROR OFF

執行已失敗

 x x x

部分執行失敗

 x x x

執行已開始

 x x

執行已成功

 x x

限制執行

 x x x

執行逾時

 x x x

擴展調用失敗

 x x x

已跳過的擴充調用

 x x

擴充調用已開始

 x

擴充調用已成功

 x

已進入擴充階段

 x x

擴充階段失敗

 x x x

擴充階段成功

 x x

擴充轉換失敗

 x x x

擴充轉換開始

 x

擴充轉換成功

 x

目標調用失敗

 x x x

目標調用部分失敗

 x x x

目標調用已跳過

 x

目標調用已開始

 x

目標調用成功

 x

已進入目標階段

 x x

目標階段失敗

 x x x

目標階段部分失敗

 x x x

跳過的目標階段

 x

目標階段成功

 x x

目標轉換失敗

 x x x

目標轉換已開始

 x

目標轉換成功

 x

在 EventBridge 管道記錄中包含執行資料

您可以指定為 EventBridge 將執行資料包含在其產生的記錄中。執行資料包括代表事件批次裝載的欄位，以及傳送至的要求以及來自擴充和目標的回應的欄位。

執行資料對於疑難排解和偵錯很有用。該 payload 欄位包含批次中包含的每個事件的實際內容，可讓您將個別事件與特定管路執行相關聯。

如果您選擇包括執行資料，則會針對管道指定的所有日誌目的地加入該資料。

重要

這些欄位可能包含敏感資訊。 EventBridge 不會嘗試在記錄期間編輯這些欄位的內容。

當包含執行資料時，會 EventBridge 將下列欄位新增至相關記錄：

  • payload

    表示管道正在處理的事件批次的內容。

    EventBridge 在可能已更新事件批次內容的步驟所產生的記錄中包含payload欄位。這包括以下步驟︰

    • EXECUTION_STARTED

    • ENRICHMENT_TRANSFORMATION_SUCCEEDED

    • ENRICHMENT_STAGE_SUCCEEDED

    • TARGET_TRANSFORMATION_SUCCEEDED

    • TARGET_STAGE_SUCCEEDED

  • awsRequest

    代表傳送至擴充或目標做為 JSON 字串傳送的請求。對於傳送至 API 目的地的要求，這代表傳送至該端點的 HTTP 要求。

    EventBridge 在擴充和鎖定目標的最後步驟所產生的記錄中包含awsRequest欄位； EventBridge 亦即，在針對指定的擴充或目標服務執行要求之後，或嘗試執行要求之後。這包括以下步驟︰

    • ENRICHMENT_INVOCATION_FAILED

    • ENRICHMENT_INVOCATION_SUCCEEDED

    • TARGET_INVOCATION_FAILED

    • TARGET_INVOCATION_PARTIALLY_FAILED

    • TARGET_INVOCATION_SUCCEEDED

  • awsResponse

    以 JSON 格式表示擴充或目標傳回的回應。對於傳送至 API 目的地的要求，這代表傳送至該端點的 HTTP 要求。

    如同awsRequest，在擴充和鎖定目標的最後步驟所產生的記錄中 EventBridge 包含awsResponse欄位； EventBridge 亦即，在針對指定的擴充或目標服務執行要求之後，或嘗試執行要求之後，並收到回應。這包括以下步驟︰

    • ENRICHMENT_INVOCATION_FAILED

    • ENRICHMENT_INVOCATION_SUCCEEDED

    • TARGET_INVOCATION_FAILED

    • TARGET_INVOCATION_PARTIALLY_FAILED

    • TARGET_INVOCATION_SUCCEEDED

如需管道執行步驟的討論，請參閱 EventBridge 管道執行步驟。

截斷 EventBridge管道記錄中的執行資料

如果您選擇在管道的記錄檔記錄中 EventBridge 包含執行資料，則記錄可能超過 256 KB 的大小限制。若要避免這種情況發生，請依照下列順序 EventBridge自動截斷執行資料欄位。 EventBridge 在進行截斷下一個欄位之前，會完全截斷每個欄位。 EventBridge 只要移除資料字串結尾的字元，就會截斷欄位資料；不會嘗試根據資料重要性進行截斷，而截斷會使 JSON 格式無效。

  • payload

  • awsRequest

  • awsResponse

如果 EventBridge 不截斷事件中的欄位，則truncatedFields欄位會包含截斷資料欄位的清單。

EventBridge 管道記錄中的錯誤報告

EventBridge 也會在代表失敗狀態的管道執行步驟中包含錯誤資料 (如果有的話)。這些步驟包括：

  • ExecutionThrottled

  • ExecutionTimeout

  • ExecutionFailed

  • ExecutionPartiallyFailed

  • EnrichmentTransformationFailed

  • EnrichmentInvocationFailed

  • EnrichmentStageFailed

  • TargetTransformationFailed

  • TargetInvocationFailed

  • TargetInvocationPartiallyFailed

  • TargetStageFailed

  • TargetStagePartiallyFailed