CloudWatch Log

Diese Rolle installiert den CloudWatch Logs-Agenten auf einer Ubuntu-Maschine.

Anforderungen

Sie sollten Ihre AWS-Anmeldeinformationen bereits auf der Maschine konfiguriert haben. Es funktioniert sowohl mit IAM-Rollen als auch mit globalen IAM-Benutzeranmeldeinformationen, wie sie in der AWS CLI-Konfiguration zu finden sind (siehe https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).

Rollenvariablen

cw_server_type: <ec2 | onPremise>

Diese Variable definiert, ob der Agent innerhalb einer EC2-Instanz oder auf einem lokalen Server installiert wird. Der Standardwert ist ec2.

aws_region: us-east-1

Diese Variable legt die AWS-Region fest, die verwendet werden soll, wenn der Betriebsmodus nicht EC2 ist.

cw_logs_files: []

Diese Variable ist die wichtigste. Sie definiert die Konfiguration für die Protokolle, die Sie verwalten möchten. Sie erwartet eine Liste von Protokollen, die der Agent überwachen soll. Die Liste folgt diesem 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

Das Feld name definiert den Namen des Logeintrags, der eindeutig sein sollte. Das Feld args sollte die Spezifikationen der Protokollkonfiguration gemäß den AWS-Dokumenten enthalten, die hier zu finden sind: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AgentReference.html.

Abhängigkeiten

Keine

Beispiel 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

Lizenz

GPLv3

Autoreninformation

Diese Rolle wurde von Eric Magalhães und Glauber Batista während ihrer Arbeit bei JobScore Inc erstellt.