Amazon ECS 任务元数据端点版本 4 - Amazon Elastic Container Service

Amazon ECS 任务元数据端点版本 4

Amazon ECS 容器代理会向每个容器注入一个环境变量,称为任务元数据端点,它提供了各种任务元数据和 Docker 统计信息添加到容器中。

任务元数据和联网速率统计数据将发送到 CloudWatch 容器洞察,并可在 AWS Management Console 中查看。有关更多信息,请参阅 使用 Container Insights 监控 Amazon ECS 容器

注意

Amazon ECS 提供较早版本的任务元数据端点。为避免将来需要创建新的任务元数据终端节点版本,可能会将其他元数据添加到版本 4 输出中。我们不会删除任何现有元数据或更改元数据字段名称。

原定设置情况下,环境变量会注入到运行至少版本的 Amazon EC2 Linux 实例上启动的 Amazon ECS 任务的容器中 1.39.0 的 Amazon ECS 容器代理。对于使用 awsvpc 网络模式的 Amazon EC2 Windows 实例,Amazon ECS 容器代理的版本必须至少为 1.54.0。有关更多信息,请参阅 Linux 容器实例管理

注意

通过将代理更新为最新版本,您可以使用较旧版本的 Amazon ECS 容器代理在 Amazon EC2 实例上添加对此功能的支持。有关更多信息,请参阅 更新 Amazon ECS 容器代理

任务元数据端点版本 4 路径

以下任务元数据端点路径可用于容器:

${ECS_CONTAINER_METADATA_URI_V4}

此路径返回容器的元数据。

${ECS_CONTAINER_METADATA_URI_V4}/task

此路径返回任务的元数据,包括与任务相关的所有容器的 ID 和名称列表。有关此终端节点响应的更多信息,请参阅Amazon ECS 任务元数据 V4 JSON 响应

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

除了可以使用 ListTagsForResource API 检索的任务和容器实例标记外,此路径还返回 /task 端点中包含的任务的元数据。检索标记元数据时收到的任何错误都将包含在 Errors 字段中的值。

注意

Errors 字段仅位于运行至少一个版本 1.50.0 的容器代理的 Amazon EC2 Linux 实例上托管的任务的响应中。对于使用 awsvpc 网络模式的 Amazon EC2 Windows 实例,Amazon ECS 容器代理必须至少为版本 1.54.0

这端点需要 ecs.ListTagsForResource 权限。

${ECS_CONTAINER_METADATA_URI_V4}/stats

此路径返回特定容器的 Docker 统计信息。有关每个返回的统计信息的更多信息,请参阅 Docker API 文档中的 ContainerStats

对于使用 awsvpcbridge 版本托管在运行至少版本 1.43.0 的容器代理的Amazon EC2 Linux 实例上的或网络模式的Amazon ECS任务,响应中将包含其他网络速率统计信息。对于所有其他任务,响应将仅包含累积网络统计信息。

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

此路径返回与任务相关的所有容器的 Docker 统计数据 。附加容器可以使用此路径提取网络指标。有关每个返回的统计信息的更多信息,请参阅 Docker API 文档中的 ContainerStats

对于使用 awsvpcbridge 版本托管在运行至少版本 1.43.0 的容器代理的Amazon EC2 Linux 实例上的或网络模式的Amazon ECS任务,响应中将包含其他网络速率统计信息。对于所有其他任务,响应将仅包含累积网络统计信息。