使用 awslogs 日志驱动程序

您可在任务中配置容器以将日志信息发送到 CloudWatch Logs。如果您对任务使用 Fargate 启动类型，则可以查看容器中的日志。如果您使用 EC2 启动类型，则可以在一个方便的位置查看容器中的不同日志，并防止您的容器日志占用您容器实例上的磁盘空间。本主题将详细介绍如何在任务定义中开始使用 awslogs 日志驱动程序。

要将系统日志从 Amazon ECS 容器实例发送到 CloudWatch Logs，请参阅 监控您的容器实例。有关 CloudWatch Logs 的更多信息，请参阅 Amazon CloudWatch Logs 用户指南中的监控日志文件和 CloudWatch Logs 配额。

启用容器的 awslogs 日志驱动程序

如果您对任务使用 Fargate 启动类型，您需要将所需的 logConfiguration 参数添加到您的任务定义才能打开 awslogs 日志驱动程序。有关更多信息，请参阅在任务定义中指定日志配置。

如果您对任务使用 EC2 启动类型，并且想要打开 awslogs 日志驱动程序，您的 Amazon ECS 容器实例至少需要容器代理的 1.9.0 版本。有关如何检查您的代理版本并更新到最新版本的信息，请参阅更新 Amazon ECS 容器代理。

ECS_AVAILABLE_LOGGING_DRIVERS='["json-file","awslogs"]'

Amazon ECS 容器实例还需要针对您用于启动容器实例的 IAM 角色的 logs:CreateLogStream 和 logs:PutLogEvents 权限。如果在 Amazon ECS 中启用 awslogs 日志驱动程序支持之前创建了 Amazon ECS 容器实例，可能需要添加此权限。ecsTaskExecutionRole 在将其分配给任务时使用，并且可能包含正确的权限。有关检查任务执行角色的信息，请参阅 在 IAM 控制台中检查任务执行（ecsTaskExecutionRole）角色。如果您的容器实例使用容器实例的托管 IAM policy，您的容器实例可能具有正确的权限。有关如何检查 Amazon ECS 容器实例角色并为容器实例附加托管 IAM policy 的信息，请参阅 在 IAM 控制台中检查容器实例（ecsInstanceRole）。

创建日志组

awslogs 日志驱动程序可以将日志流发送到 CloudWatch Logs 中的现有日志组，也可以代表您创建新的日志组。Amazon Web Services Management Console 提供了一个自动配置选项，该选项将使用具有 ecs 的任务定义系列名称作为前缀代表您创建日志组。或者，您可以手动指定日志配置选项，并使用 true 值指定 awslogs-create-group 选项，该选项将代表您创建日志组。

以下代码演示如何设置 awslogs-create-group 选项。

{
    "containerDefinitions": [
        {
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                    "awslogs-group": "firelens-container",
                    "awslogs-region": "us-west-2",
                    "awslogs-create-group": "true",
                    "awslogs-stream-prefix": "firelens"
                }
            }
}

使用自动配置功能创建日志组

在 Amazon ECS 控制台中注册任务定义时，您可以选择允许 Amazon ECS 自动配置 CloudWatch Logs。执行此操作可以通过使用具有 ecs 的任务定义系列名称作为前缀代表您创建日志组。

可用的 awslogs 日志驱动程序选项

awslogs 日志驱动程序支持 Amazon ECS 任务定义中的下列选项。有关更多信息，请参阅 CloudWatch Logs 登入驱动程序。

在任务定义中指定日志配置

必须先在任务定义中为容器指定 awslogs 日志驱动程序，容器才能将日志发送到 CloudWatch。此部分描述了为使用 awslogs 日志驱动程序而进行的容器日志配置。有关更多信息，请参阅使用控制台创建任务定义。

下面的任务定义 JSON 有一个为每个容器指定的 logConfiguration 对象。一个是用于将日志发送到名为 awslogs-wordpress 的日志组的 WordPress 容器。另一个是用于将日志发送到名为 awslogs-mysql 的日志组的 MySQL 容器。两个容器都使用 awslogs-example 日志流前缀。

{
    "containerDefinitions": [
        {
            "name": "wordpress",
            "links": [
                "mysql"
            ],
            "image": "wordpress",
            "essential": true,
            "portMappings": [
                {
                    "containerPort": 80,
                    "hostPort": 80
                }
            ],
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                    "awslogs-create-group": "true",
                    "awslogs-group": "awslogs-wordpress",
                    "awslogs-region": "us-west-2",
                    "awslogs-stream-prefix": "awslogs-example"
                }
            },
            "memory": 500,
            "cpu": 10
        },
        {
            "environment": [
                {
                    "name": "MYSQL_ROOT_PASSWORD",
                    "value": "password"
                }
            ],
            "name": "mysql",
            "image": "mysql",
            "cpu": 10,
            "memory": 500,
            "essential": true,
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                    "awslogs-create-group": "true",
                    "awslogs-group": "awslogs-mysql",
                    "awslogs-region": "us-west-2",
                    "awslogs-stream-prefix": "awslogs-example"
                }
            }
        }
    ],
    "family": "awslogs-example"
}

在容器定义日志配置中向 awslogs 日志驱动程序注册任务定义之后，可运行任务或使用此任务定义创建服务以开始将日志发送到 CloudWatch Logs。有关更多信息，请参阅 在经典 Amazon ECS 控制台中运行独立任务 和 在经典控制台中创建 Amazon ECS 服务。

在 CloudWatch Logs 中查看 awslog 容器日志

对于使用 EC2 启动类型的任务，在容器实例角色有适当的权限将日志发送到 、容器代理最低更新到版本 1.9.0 且您已配置并启动包含使用 awslogs 日志驱动程序的容器的任务之后，您配置的容器应会将其日志数据发送到 CloudWatch Logs。您可在控制台中查看和搜索这些日志。