Rol de Ansible: AWSLogsEC2

Este rol instala y configura el Agente de Logs de AWS CloudWatch.

Requisitos

Este rol solo requiere la versión 2.4+ de Ansible y el módulo EC2_FACTS.

Variables del Rol

awslogs_logs:
  - file:  /var/log/messages          # La ruta al archivo de log que deseas enviar (requerido)
    format: "%b %d %H:%M:%S"          # El formato de fecha y hora del archivo de log
    time_zone: "LOCAL"                # Zona horaria, puede ser LOCAL o UTC
    initial_position: "start_of_file" # Desde dónde debe iniciar el envío de logs
    group_name: /var/log/messages     # El nombre del grupo de Logs en CloudWatch (requerido)
    stream_name: "{instance_id}"      # Puedes usar una cadena literal y/o variables predefinidas ({instance_id}, {hostname}, {ip_address})

Además, hay tres variables que no se utilizan por defecto:

awslogs_region: eu-west-1            # Sobrescribe la región local para el envío de logs

Si tu instancia está detrás de un proxy HTTP o HTTPS, puedes configurarlo con las siguientes variables:

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

Esta configuración se amplía en la Documentación de Amazon CloudWatch Logs.

Dependencias

Ninguna

Ejemplo 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

Licencia

MIT / BSD