Rôle Ansible: AWSLogsEC2

Ce rôle installe et configure l'agent des logs AWS CloudWatch.

Exigences

Ce rôle nécessite uniquement Ansible version 2.4+ et le module EC2_FACTS.

Variables du Rôle

awslogs_logs:
  - file:  /var/log/messages          # Le chemin vers le fichier de log que vous souhaitez envoyer (obligatoire)
    format: "%b %d %H:%M:%S"          # Le format de date et d'heure du fichier de log
    time_zone: "LOCAL"                # Fuseau horaire, peut être LOCAL ou UTC
    initial_position: "start_of_file" # À partir de quel endroit l'envoi des logs doit commencer
    group_name: /var/log/messages     # Le nom du groupe de logs CloudWatch (obligatoire)
    stream_name: "{instance_id}"      # Vous pouvez utiliser une chaîne littérale et/ou des variables prédéfinies ({instance_id}, {hostname}, {ip_address})

De plus, il y a trois variables qui ne sont pas utilisées par défaut :

awslogs_region: eu-west-1            # Remplace la région locale pour l'envoi des logs

Si votre instance est derrière un proxy HTTP ou HTTPS, vous pouvez le configurer avec les variables suivantes :

awslogs_enable_proxy: true
awslogs_http_proxy: http://your.proxy:80/
awslogs_https_proxy: http://your.https.proxy:80/
awslogs_noproxy: 169.254.169.254

Cette configuration est détaillée dans la Documentation des Logs Amazon CloudWatch.

Dépendances

Aucune

Exemple de Playbook

---

- hosts: all

  vars:
    awslogs_region: eu-west-1
    awslogs_logs:
    - file: /var/log/messages
      format: "%b %d %H:%M:%S"
      time_zone: "LOCAL"
      initial_position: "start_of_file"
      group_name: /var/log/messages
      stream_name: "{instance_id}"

  roles:
    - naoyayamamoto.awslogs_ec2

Licence

MIT / BSD