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

# 使用動作日誌監控 Amazon ECS 操作
<a name="action-logs"></a>

## Amazon ECS 動作日誌概觀
<a name="action-logs-overview"></a>

透過 Amazon ECS 動作日誌，您可以監控 Amazon ECS 在容器生命週期操作期間代表您執行的所有動作。Action Logs 會擷取叢集內每個資源操作、狀態轉換和服務起始 API 呼叫的時間戳記記錄。

動作日誌會記錄先前不可見的操作，例如容器映像下載、負載平衡器註冊和安全群組組態。如果沒有動作日誌，您只能觀察資源的開始和結束狀態。使用動作日誌，您可以看到 Amazon ECS 在這些狀態之間採取的每個中繼步驟。

當您啟用動作日誌時， AWS 管理主控台中的 Amazon Q 可以存取這些日誌，以協助您直接從主控台偵錯部署失敗和協助程式問題。

## 動作日誌的優點
<a name="action-logs-benefits"></a>

動作日誌提供下列管理 Amazon ECS 工作負載的優點：
+ **服務動作的可見性** – 檢視 Amazon ECS 在狀態轉換之間執行的先前不可見動作，包括基礎設施佈建、網路組態和資源註冊。
+ **改善故障**診斷 – 診斷部署失敗和基礎設施問題，無需聯絡 AWS Support。動作日誌支援一組不斷增長的失敗原因。
+ **延長失敗中繼資料** – 將失敗任務的中繼資料保留超過標準 1 小時保留期。您可以按照自己的步調檢閱詳細的失敗資訊。
+ **自助式偵錯** – 透過檢閱導致失敗的完整動作序列，獨立調查和解決問題。

## 記錄的內容
<a name="action-logs-what-gets-logged"></a>

動作日誌會擷取下列 Amazon ECS 操作的動作：
+ **服務部署** – 狀態轉換、轉返和生命週期掛鉤執行。
+ **受管協助程式生命週期** – 建立、更新、刪除和執行個體耗盡受管協助程式的操作。

## 動作日誌的運作方式
<a name="action-logs-how-it-works"></a>

您選擇在叢集層級加入動作日誌。您可以透過 Amazon ECS 主控台或使用 Amazon CloudWatch APIs (`PutDeliverySource`、 `PutDeliveryDestination`和 ) 啟用動作日誌`CreateDelivery`。

啟用動作日誌之後，Amazon ECS 會透過 CloudWatch Ingestion Hub 發出結構化 JSON 日誌。Amazon ECS 會將日誌傳送至您選擇的目的地：CloudWatch Logs、Amazon S3 或 Amazon Data Firehose。

動作日誌使用fire-and-forget發佈。日誌發佈絕不會封鎖或降低 Amazon ECS 資源操作。如果發生暫時性交付失敗，Amazon ECS 會繼續處理工作負載，而不會中斷。

## 日誌結構描述概觀
<a name="action-logs-schema"></a>

每個動作日誌項目都包含下列欄位：
+ `timestamp` – 事件發生時的 Unix 毫秒。
+ `logLevel` – 嚴重性等級：`INFO`、 `WARN`或 `ERROR`。
+ `account` – AWS 帳戶 ID。
+ `region` – 事件發生 AWS 的區域。
+ `resourceArn` – 代表選擇加入範圍的叢集 ARN。
+ `actionSourceId` – 子資源識別符，例如服務 ARN 或協助程式 ARN。
+ `eventName` – 動作識別符，例如 `DAEMON_DEPLOYMENT_IN_PROGRESS`。
+ `detail` – 事件特定的 JSON 承載，其中包含有關 動作的其他內容。

## 日誌目的地和組織
<a name="action-logs-destinations"></a>

您可以將動作日誌交付至下列目的地：
+ **CloudWatch Logs** – CloudWatch Logs 會將日誌存放在名為 的日誌群組中`/aws/vendedlogs/ecs/action-logs/{resourceId}`。Amazon ECS 會使用 `{actionSourceId}` 作為日誌串流名稱，為每個子資源建立個別的日誌串流。
+ **Amazon S3** – 依帳戶、區域和 5 分鐘時段的 Amazon S3 分割區日誌。Amazon S3 使用 gzip 壓縮檔案，以實現高效儲存。
+ **Amazon Data Firehose** – Amazon Data Firehose 會以近乎即時的換行分隔 JSON 記錄的形式交付日誌。

## 定價
<a name="action-logs-pricing"></a>

動作日誌是一種付費功能，使用標準 CloudWatch 提供的日誌定價。您需根據叢集產生的日誌量，支付日誌擷取和儲存的費用。您可以透過目的地設定來設定保留。當您透過 Amazon ECS 主控台啟用動作日誌時，CloudWatch Logs 會使用預設的 7 天保留期。

**Topics**
+ [Amazon ECS 動作日誌概觀](#action-logs-overview)
+ [動作日誌的優點](#action-logs-benefits)
+ [記錄的內容](#action-logs-what-gets-logged)
+ [動作日誌的運作方式](#action-logs-how-it-works)
+ [日誌結構描述概觀](#action-logs-schema)
+ [日誌目的地和組織](#action-logs-destinations)
+ [定價](#action-logs-pricing)
+ [Amazon ECS 動作日誌入門](action-logs-getting-started.md)
+ [使用 Amazon ECS 動作日誌進行故障診斷](action-logs-troubleshooting.md)