本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 查看 CodeDeploy EC2/On-Premises 部署的日志数据
<a name="deployments-view-logs"></a>

您可以通过将 Amazon CloudWatch 代理设置为在 CloudWatch 控制台中查看聚合数据或登录单个实例查看日志文件来查看 CodeDeploy 部署创建的日志数据。

**注意**  
 AWS Lambda 或 Amazon ECS 部署不支持日志。它们只能为 EC2/On-Premises 部署创建。

**Topics**
+ [在 Amazon CloudWatch 控制台中查看日志文件数据](#deployments-view-logs-cloudwatch)
+ [查看实例上的日志文件](#deployments-view-logs-instance)

## 在 Amazon CloudWatch 控制台中查看日志文件数据
<a name="deployments-view-logs-cloudwatch"></a>

在实例上安装 Amazon CloudWatch 代理后，该实例的所有部署数据都可以在 CloudWatch 控制台中查看。为简单起见，我们建议 CloudWatch 使用集中监控日志文件，而不是逐个实例查看它们。有关更多信息，请参阅 [将 CodeDeploy 代理日志发送到 CloudWatch](codedeploy-agent-operations-cloudwatch-agent.md)。

## 查看实例上的日志文件
<a name="deployments-view-logs-instance"></a>

要查看单个实例的部署日志数据，您可以登录实例并浏览有关错误或其他部署事件的信息。

**Topics**
+ [查看 Amazon Linux、RHEL 和 Ubuntu Server 实例上的部署日志文件](#deployments-view-logs-instance-unix)
+ [查看 Windows Server 实例上的部署日志文件](#deployments-view-logs-instance-windows)

### 查看 Amazon Linux、RHEL 和 Ubuntu Server 实例上的部署日志文件
<a name="deployments-view-logs-instance-unix"></a>

在 Amazon Linux、RHEL 和 Ubuntu Server 实例上，部署日志存储在以下位置：

 `/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log`

要查看或分析 Amazon Linux、RHEL 和 Ubuntu 服务器实例上的部署日志，请登录该实例，然后键入以下命令以打开 CodeDeploy 代理日志文件：

```
less /var/log/aws/codedeploy-agent/codedeploy-agent.log
```

对于 2.0.x 及更高版本，代理日志每天或当文件达到 64 MB（可配置）时轮换。轮换的档案会被命名`codedeploy-agent.YYYYMMDD.log`（当天轮换时使用数字后缀），并在七天后进行修剪。脚本日志 (`scripts.log`) 的大小轮换为 64 MB，最多可包含 8 个存档文件（可配置）。

键入以下命令浏览日志文件以查看错误消息：


<table>
<thead>
  <tr><th>命令</th><th>结果</th></tr>
</thead>
<tbody>
  <tr><td><b>&amp; ERROR </b></td><td>仅显示日志文件中的错误消息。在 <b>ERROR</b> 一词的前后使用一个空格。</td></tr>
  <tr><td><b>/ ERROR </b></td><td>搜索下一条错误消息。¹ </td></tr>
  <tr><td><b>? ERROR </b></td><td>搜索之前的错误消息。² 在单词 <b>ERROR</b> 前后使用一个空格。</td></tr>
  <tr><td><b>G</b></td><td>转到日志文件的末尾。</td></tr>
  <tr><td><b>g</b></td><td>转到日志文件的开头。</td></tr>
  <tr><td><b>q</b></td><td>退出日志文件。</td></tr>
  <tr><td><b>h</b></td><td>了解其他命令。</td></tr>
  <tr><td colspan="2">¹ 键入 <b>/ ERROR </b> 后，为下一条错误消息键入 <b>n</b>。为上一条错误消息键入 <b>N</b>。<br />² 键入 <b>n</b> 后，为下一条错误消息键入 <b>? ERROR </b>，或为上一条错误消息键入 <b>N</b>。</td></tr>
</tbody>
</table>


您也可以键入以下命令来打开 CodeDeploy 脚本日志文件：

```
less /opt/codedeploy-agent/deployment-root/{{deployment-group-ID}}/{{deployment-ID}}/logs/scripts.log
```

键入以下命令浏览日志文件以查看错误消息：


<table>
<thead>
  <tr><th>命令</th><th>结果</th></tr>
</thead>
<tbody>
  <tr><td><b>&amp;stderr</b></td><td>仅显示日志文件中的错误消息。</td></tr>
  <tr><td><b>/stderr</b></td><td>搜索下一条错误消息。¹</td></tr>
  <tr><td><b>?stderr</b></td><td>搜索上一条错误消息。²</td></tr>
  <tr><td><b>G</b></td><td>转到日志文件的末尾。</td></tr>
  <tr><td><b>g</b></td><td>转到日志文件的开头。</td></tr>
  <tr><td><b>q</b></td><td>退出日志文件。</td></tr>
  <tr><td><b>h</b></td><td>了解其他命令。</td></tr>
  <tr><td colspan="2">¹ 键入 <b>/stderr</b> 后，为下一条错误消息键入 <b>n</b>。为上一条错误消息键入 <b>N</b>。<br />² 键入 <b>?stderr</b> 后，为上一条错误消息键入 <b>n</b>。为上一条错误消息键入 <b>N</b>。</td></tr>
</tbody>
</table>


### 查看 Windows Server 实例上的部署日志文件
<a name="deployments-view-logs-instance-windows"></a>

**CodeDeploy 代理日志文件**：在 Windows Server 实例上， CodeDeploy 代理日志文件存储在以下位置：

对于 2.0.x 及更高版本：

`C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent.log`

对于 1.8.x 及更早版本：

`C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt`

要查看或分析 Windows Server 实例上的 CodeDeploy 代理日志文件，请登录该实例，然后键入以下命令打开该文件：

对于 2.0.x 及更高版本：

```
notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent.log
```

对于 1.8.x 及更早版本：

```
notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt
```

要浏览日志文件以查看错误消息，请按 CTRL\+F，键入 **ERROR**，然后按 Enter 以查找第一个错误。

**CodeDeploy 脚本日志文件**：在 Windows 服务器实例上，部署日志存储在以下位置：

`C:\ProgramData\Amazon\CodeDeploy\{{deployment-group-id}}\{{deployment-id}}\logs\scripts.log`

其中：
+ {{deployment-group-id}}是一个字符串，例如 `examplebf3a9c7a-7c19-4657-8684-b0c68d0cd3c4`
+ {{deployment-id}}是一个标识符，例如 `d-12EXAMPLE`

键入以下命令打开 CodeDeploy 脚本日志文件：

```
notepad C:\ProgramData\Amazon\CodeDeploy\{{deployment-group-ID}}\{{deployment-ID}}\logs\scripts.log
```

对于 2.0.x 及更高版本，代理日志每天或当文件达到 64 MB（可配置）时轮换。脚本日志的大小轮换为 64 MB，最多包含 8 个存档文件（可配置）。

要浏览日志文件以查看错误消息，请按 CTRL\+F，键入 **stderr**，然后按 Enter 以查找第一个错误。