快速入门:启动时在 EC2 Linux 实例上安装和配置 CloudWatch Logs 代理 - Amazon CloudWatch Logs
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

快速入门:启动时在 EC2 Linux 实例上安装和配置 CloudWatch Logs 代理

提示

本节中讨论的较早 CloudWatch Logs 代理即将弃用。强烈建议您改为使用可收集日志和指标的新统一 CloudWatch 代理 此外,较早的 CloudWatch Logs 代理需要 Python 3.3 或更早版本,默认情况下,新 EC2 实例上未安装这些版本。有关统一 CloudWatch 代理的更多信息,请参阅。安装 CloudWatch 代理.

本节的其余部分将介绍较旧的 CloudWatch Logs 代理的使用。

启动时在 EC2 Linux 实例上安装较旧的 CloudWatch Logs 代理

您可以使用 Amazon EC2 用户数据,这是 Amazon EC2 的一项功能,允许在启动时将参数信息传递给实例,以在该实例上安装和配置 CloudWatch Logs 代理。要将 CloudWatch Logs 代理安装和配置信息传递给 Amazon EC2,您可以提供处于某个网络位置(例如 Amazon S3 存储桶)的配置文件。

不支持配置多个日志源将数据发送到单个日志流。

Prerequisite

创建用于描述所有日志组和日志流的代理配置文件。这是一个文本文件,描述要监控的日志文件以及要将这些文件上传到的日志组和日志流。代理使用此配置文件并开始监控并上传其中描述的所有日志文件。有关代理配置文件中的设置的更多信息,请参阅 CloudWatch Logs (CloudWatch 日志)a绅士reference

以下是适用于 Amazon Linux 2 的一个示例代理配置文件

[general] state_file = /var/lib/awslogs/state/agent-state [/var/log/messages] file = /var/log/messages log_group_name = /var/log/messages log_stream_name = {instance_id} datetime_format = %b %d %H:%M:%S

以下是适用于 Ubuntu 的一个示例代理配置文件

[general] state_file = /var/awslogs/state/agent-state [/var/log/syslog] file = /var/log/syslog log_group_name = /var/log/syslog log_stream_name = {instance_id} datetime_format = %b %d %H:%M:%S

配置您的 IAM 角色

  1. 通过以下网址打开 IAM 控制台:https://console.aws.amazon.com/iam/

  2. 在导航窗格中,选择 PoliciesCreate Policy

  3. 在存储库的创建策略页面, 对于创建您自己的策略中,选择Select. 有关创建自定义策略的更多信息,请参阅适用于 Amazon EC2 的 IAM 策略中的适用于 Linux 实例的 Amazon EC2 用户指南.

  4. Review Policy 页面上,为 Policy Name 键入策略的名称。

  5. 对于 Policy Document,粘贴以下策略:

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams" ], "Resource": [ "arn:aws:logs:*:*:*" ] }, { "Effect": "Allow", "Action": [ "s3:GetObject" ], "Resource": [ "arn:aws:s3:::myawsbucket/*" ] } ] }
  6. 选择创建策略

  7. 在导航窗格中,选择 RolesCreate New Role

  8. Set Role Name 页面上,请键入角色名称,然后选择 Next Step

  9. 在存储库的选择角色类型页面上,选择Select旁边Amazon EC2.

  10. Attach Policy 页面上的表标题中,依次选择 Policy TypeCustomer Managed

  11. 选择您创建的 IAM 策略,然后选择下一步.

  12. 选择 Create Role (创建角色)

    有关 IAM 用户和策略的更多信息,请参阅IAM 用户和组管理 IAM 策略中的IAM 用户指南.

启动新实例并启用 CloudWatch Logs

  1. 通过以下网址打开 Amazon EC2 控制台:https://console.aws.amazon.com/ec2/

  2. 选择 Launch Instance

    有关更多信息,请参阅 。启动实例适用于 Linux 实例的 Amazon EC2 用户指南.

  3. 在存储库的第 1 步:选择一个Amazon 系统映像(AMI)页面上,选择要启动的 Linux 实例类型,然后在步骤 2: 选择一个实例类型页面上,选择后续:配置实例详细信息.

    确保 Amazon 系统映像 (AMI) 中包含了 cloud-init。Amazon Linux AMI 和适用于 Ubuntu 和 RHEL 的 AMI 已包含云初始化,但 CentOS 和其他 AMI Amazon Web Services Marketplace 可能不会。

  4. 在存储库的步骤 3: 配置实例详细信息页面, 对于IAM 角色下,选择您创建的 IAM 角色。

  5. Advanced Details 下,将以下脚本粘贴到 User data 的框中。然后,通过将 -c 选项的值更改为您的代理配置文件的位置来更新该脚本:

    #!/bin/bash curl https://s3.amazonaws.com/aws-cloudwatch/downloads/latest/awslogs-agent-setup.py -O chmod +x ./awslogs-agent-setup.py ./awslogs-agent-setup.py -n -r us-east-1 -c s3://DOC-EXAMPLE-BUCKET1/my-config-file
  6. 对实例进行任何其他更改,检查启动设置,然后选择 Launch

  7. 在代理运行一段时间后,可以在 CloudWatchWatchWatchWatch控制台看到新创建的日志组和日志流。

    有关更多信息,请参阅查看logdatasent 到 CloudWatch Logs