CloudWatch 日志

该角色在 Ubuntu 机器上安装 CloudWatch 日志代理。

要求

您需要在机器上预先配置 AWS 凭证，可以使用 IAM 角色或全局 IAM 用户凭证，例如 AWS CLI 配置中的凭证（请参见 https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html）。

角色变量

cw_server_type: <ec2 | onPremise>

此变量定义代理是安装在 EC2 实例还是本地服务器上。默认值为 ec2。

aws_region: us-east-1

此变量定义在实例模式不是 EC2 时使用的 AWS 区域。

cw_logs_files: []

这是最重要的变量，它定义您想要管理的日志的配置。它期望一个代理需要监视的日志列表。列表格式如下：

cw_logs_files:
  - log_group_name: /var/log/syslog
    log_stream_name: '{hostname}-{instance_id}'
    timestamp_format: '%b %d %H:%M:%S'
    file_path: /var/log/syslog
    encoding: utf-8
  - log_group_name: /var/log/auth.log
    log_stream_name: '{hostname}-{instance_id}'
    timestamp_format: '%b %d %H:%M:%S'
    file_path: /var/log/auth.log
    encoding: utf-8

字段 name 定义日志条目的名称，应唯一，而字段 args 应包含根据 AWS 文档的日志配置细节，文档见：https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AgentReference.html。

依赖关系

无

示例剧本

- hosts: all
  roles:
    - role: jobscore.cloudwatch-logs
      cw_server_type: onPremise
      aws_region: us-east-1
      cw_logs_files:
        - log_group_name: /var/log/syslog
          log_stream_name: '{hostname}-{instance_id}'
          timestamp_format: '%b %d %H:%M:%S'
          file_path: /var/log/syslog
          encoding: utf-8
        - log_group_name: /var/log/auth.log
          log_stream_name: '{hostname}-{instance_id}'
          timestamp_format: '%b %d %H:%M:%S'
          file_path: /var/log/auth.log
          encoding: utf-8

许可证

GPLv3

作者信息

该角色由 Eric Magalhães 和 Glauber Batista 创建，他们在 JobScore Inc 工作时完成了这个角色。