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

# 开启 Container Insights
<a name="cloudwatch-container-insights-working"></a>

完成以下步骤，为 Amazon Batch 计算环境启用 “容器见解”。

------
#### [ Amazon Web Services 管理控制台 ]

1. 打开 [Amazon Batch 控制台](https://console.amazonaws.cn/batch/home)。

1. 选择**环境**。

1. 选择所需的计算环境。

1. 在 **Container Insights** 选项卡中，为计算环境开启 **Container Insights**。
**提示**  
可以选择一个默认时间间隔来汇总指标，也可以创建一个自定义时间间隔。

------
#### [ Amazon CLI ]

**创建计算环境时启用容器洞察 **

使用`--ecs-settings`参数和`create-compute-environment`可在新的计算环境中启用容器见解。

```
$ aws batch create-compute-environment \
    --compute-environment-name {{my-compute-env}} \
    --type MANAGED \
    --state ENABLED \
    --ecs-settings containerInsights=ENHANCED \
    --compute-resources type=FARGATE,maxvCpus=256,subnets={{subnet-a123456b}},securityGroupIds={{sg-a12b3456}}
```

`containerInsights` 的有效值为 `ENABLED`、`ENHANCED` 和 `DISABLED`。

**在现有计算环境上启用容器洞察 **

`update-compute-environment`用于在现有计算环境上启用或更改容器见解。

```
$ aws batch update-compute-environment \
    --compute-environment {{my-compute-env}} \
    --ecs-settings containerInsights=ENHANCED
```

**验证容器见解设置 **

`describe-compute-environments`用于验证当前设置。

```
$ aws batch describe-compute-environments \
    --compute-environments {{my-compute-env}} \
    --query "computeEnvironments[0].ecsSettings"
```

以下显示了启用容器见解时的输出。

```
{
    "containerInsights": "ENHANCED"
}
```

**注意**  
如果从未在计算环境上设置过容器见解，则响应中不存在该`ecsSettings`字段。

------
#### [ API ]

在您的[CreateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_CreateComputeEnvironment.html)或[UpdateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_UpdateComputeEnvironment.html)请求中使用`ecsSettings`参数。

**使用容器见解创建计算环境 **

`ecsSettings`在请求正文中包含：

```
{
    "computeEnvironmentName": "{{my-compute-env}}",
    "type": "MANAGED",
    "state": "ENABLED",
    "ecsSettings": {
        "containerInsights": "ENHANCED"
    },
    "computeResources": {
        "type": "FARGATE",
        "maxvCpus": 256,
        "subnets": ["{{subnet-a123456b}}"],
        "securityGroupIds": ["{{sg-a12b3456}}"]
    }
}
```

**在现有计算环境上更新容器见解 **

```
{
    "computeEnvironment": "{{my-compute-env}}",
    "ecsSettings": {
        "containerInsights": "ENHANCED"
    }
}
```

有关更多信息，请参阅《*Amazon Batch API 参考*》中的[CreateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_CreateComputeEnvironment.html)和[UpdateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_UpdateComputeEnvironment.html)。

------

**重要**  
在计算环境上设置容器见解值后，您将无法恢复到默认（未设置）行为，即容器见解设置在外部进行管理。 Amazon Batch要更改容器见解模式，必须使用新值`UpdateComputeEnvironment`进行调用。  
这也意味着，如果您在 Amazon CloudFormation 模板中设置此属性，堆栈回滚将无法将设置恢复到其先前的未设置状态。