

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

# 搭配 使用 CloudWatch Logs AWS Batch
<a name="using_cloudwatch_logs"></a>

您可以在 EC2 資源上設定 AWS Batch 任務，將詳細的日誌資訊和指標傳送至 CloudWatch Logs。這樣做，您可以在一個方便的位置檢視與任務不同的日誌。如需 CloudWatch Logs 的詳細資訊，請參閱《[Amazon CloudWatch 使用者指南》中的什麼是 Amazon CloudWatch Logs？](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html)。 *Amazon CloudWatch *

**注意**  
根據預設， AWS Fargate 容器的 CloudWatch Logs 會開啟。

若要開啟並自訂 CloudWatch Logs 記錄，請檢閱下列一次性組態任務：
+ 對於以 EC2 資源為基礎的 AWS Batch 運算環境，請將 IAM 政策新增至`ecsInstanceRole`角色。如需詳細資訊，請參閱[教學課程：新增 CloudWatch Logs IAM 政策](cwl_iam_policy.md)。
+ 建立包含詳細 CloudWatch 監控的 Amazon EC2 啟動範本，然後在建立 AWS Batch 運算環境時指定範本。您也可以在現有映像上安裝 CloudWatch 代理程式，然後在 AWS Batch 初次執行精靈中指定映像。
+ （選用） 設定 awslogs 驅動程式。您可以新增參數，以變更 EC2 和 Fargate 資源的預設行為。如需詳細資訊，請參閱[使用 awslogs 日誌驅動程式](using_awslogs.md)。

**Topics**
+ [教學課程：新增 CloudWatch Logs IAM 政策](cwl_iam_policy.md)
+ [安裝及設定 CloudWatch 代理程式](installing_cwl_agent.md)
+ [教學課程：檢視 CloudWatch Logs](viewing_cwlogs.md)

# 教學課程：新增 CloudWatch Logs IAM 政策
<a name="cwl_iam_policy"></a>

您必須先建立使用 CloudWatch Logs APIs IAM 政策，才能將日誌資料和詳細指標傳送至 CloudWatch Logs。建立 IAM 政策後，將其連接到`ecsInstanceRole`角色。

**注意**  
如果`ECS-CloudWatchLogs`政策未連接至`ecsInstanceRole`角色，仍可將基本指標傳送至 CloudWatch Logs。不過，基本指標不包含日誌資料或詳細指標，例如可用磁碟空間。

AWS Batch 運算環境使用 Amazon EC2 資源。當您使用 AWS Batch 初次執行精靈建立運算環境時， 會 AWS Batch 建立角色並使用該`ecsInstanceRole`角色設定環境。

如果您未使用初次執行精靈，您可以在 AWS Command Line Interface 或 AWS Batch API 中建立運算環境時指定 `ecsInstanceRole`角色。如需詳細資訊，請參閱 [AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/)或 [AWS Batch API 參考](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html)。

**若要建立 `ECS-CloudWatchLogs` IAM 政策**

1. 前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。

1. 在導覽窗格中，選擇**政策**。

1. 選擇 **Create policy** (建立政策)。

1. 選擇 **JSON**，然後輸入下列政策：

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "logs:CreateLogGroup",
                   "logs:CreateLogStream",
                   "logs:PutLogEvents",
                   "logs:DescribeLogStreams"
               ],
               "Resource": [
                   "arn:aws:logs:*:*:*"
               ]
           }
       ]
   }
   ```

------

1. 選擇下**一步：標籤**。

1. （選用） 對於**新增標籤**，選擇**新增標籤**以將標籤新增至政策。

1. 選擇下**一步：檢閱**。

1. 在**檢閱政策**頁面上，針對**名稱**輸入 **ECS-CloudWatchLogs**，然後輸入選用的**描述**。

1. 選擇**建立政策**。

**將 `ECS-CloudWatchLogs` 政策連接至 `ecsInstanceRole`**

1. 在以下網址開啟 IAM 主控台：[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。

1. 在導覽窗格中，選擇**角色**。

1. 選擇 `ecsInstanceRole`。如果角色不存在，請遵循 中的程序[Amazon ECS 執行個體角色](instance_IAM_role.md)來建立角色。

1. 選擇**新增許可**，然後選擇**連接政策**。

1. 選擇 **ECS-CloudWatchLogs** 政策，然後選擇**連接政策**。

# 安裝及設定 CloudWatch 代理程式
<a name="installing_cwl_agent"></a>

您可以建立包含 CloudWatch 監控的 Amazon EC2 啟動範本。如需詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的[從啟動範本啟動執行個體](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#lt-initiate-launch-template)和[進階詳細資訊](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#lt-advanced-details)。

您也可以在現有的 Amazon EC2 AMI 上安裝 CloudWatch 代理程式，然後在 AWS Batch 初次執行精靈中指定映像。如需詳細資訊，請參閱[安裝 CloudWatch 代理程式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html)和 [AWS Batch 教學課程入門](Batch_GetStarted.md)。

**注意**  
 AWS Fargate 資源不支援啟動範本。

# 教學課程：檢視 CloudWatch Logs
<a name="viewing_cwlogs"></a>

您可以在 中檢視和搜尋 CloudWatch Logs 日誌 AWS 管理主控台。

**注意**  
資料可能需要幾分鐘的時間才會顯示在 CloudWatch Logs 中。

**若要檢視您的 CloudWatch Logs 資料**

1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在左側導覽窗格中，選擇**日誌**，然後選擇**日誌群組**。  
![\[CloudWatch 主控台日誌群組\]](http://docs.aws.amazon.com/zh_tw/batch/latest/userguide/images/cwl-log-groups.png)

1. 選擇要檢視的日誌群組。  
![\[CloudWatch 主控台日誌串流\]](http://docs.aws.amazon.com/zh_tw/batch/latest/userguide/images/cw_log_stream.png)

1. 選擇要檢視的日誌串流。根據預設，串流會以任務名稱的前 200 個字元和 Amazon ECS 任務 ID 來識別。
**提示**  
若要下載日誌串流資料，請選擇**動作**。  
![\[CloudWatch 主控台日誌事件\]](http://docs.aws.amazon.com/zh_tw/batch/latest/userguide/images/cw_log_events.png)