CloudWatch Log

Эта роль устанавливает агент CloudWatch Logs на машине Ubuntu.

Требования

У вас должны быть настроены учетные данные 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

Эта переменная определяет регион AWS, который следует использовать, если режим экземпляра не EC2.

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

Информация о авторе

Эта роль была создана Эриком Магальясом и Глаубером Батистой во время работы в JobScore Inc.