CloudWatch Log

Ta rola instaluje agenta CloudWatch Logs na maszynie z Ubuntu.

Wymagania

Musisz mieć skonfigurowane dane uwierzytelniające AWS na maszynie. Może to być zrealizowane za pomocą ról IAM lub globalnych danych logowania użytkownika IAM, jak w konfiguracji AWS CLI (zobacz https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).

Zmienne Roli

cw_server_type: <ec2 | onPremise>

Ta zmienna definiuje, czy agent jest instalowany na instancji EC2, czy na serwerze lokalnym. Domyślnie jest to ec2.

aws_region: us-east-1

Ta zmienna definiuje region AWS do użycia, gdy tryb instancji nie jest EC2.

cw_logs_files: []

To najważniejsza zmienna; definiuje konfigurację dla logów, które chcesz zarządzać. Oczekuje listy logów, które agent ma monitorować. Lista ta powinna mieć ten format:

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

Pole name definiuje nazwę wpisu logu, która powinna być unikalna, a pole args powinno zawierać szczegóły konfiguracji logów zgodnie z dokumentacją AWS tutaj: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AgentReference.html

Zależności

Brak

Przykładowy Playbook

- 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

Licencja

GPLv3

Informacje o autorze

Ta rola została stworzona przez Eric Magalhães i Glauber Batista podczas pracy dla JobScore Inc.