gabops.papertrail

Descripción general Versiones Perspectivas

gabops.papertrail

Instala y configura Papertrail (remote_syslog2).

Requisitos

Ninguno.

Variables del Rol

Variable	Valor	Descripción
papertrail_version	"0.20"	Versión a instalar. 0.20 es la más reciente en este momento.
papertrail_config_file_path	/etc/papertrail_conf.yml	Nombre del archivo de configuración para remote_syslog.
papertrail_service_enabled	true	Configura remote_syslog para que se inicie al arrancar el sistema.
papertrail_service_state	started	Define el estado del servicio.
papertrail_check_download_certs	true	Configura si se deben verificar los certificados del servidor donde se descarga el paquete. Esta opción se ha agregado para cubrir algunos casos específicos y siempre debe dejarse en true.
papertrail_managed_conf_file	true	Si es false, no se aplicará ninguna configuración (todas las variables a continuación se ignorarán). Solo se realizará la instalación y nada más.
papertrail_custom_hostname	""	Por defecto, remote_syslog2 usa el nombre del nodo. Esto se puede sobrescribir aquí.
papertrail_destination_host	""	Define el host de destino de Papertrail para enviar los registros. Revisa tu cuenta de Papertrail para ello.
papertrail_destination_port	""	Define el puerto de destino de Papertrail para conectarse al host de destino. Revisa tu cuenta de Papertrail para ello.
papertrail_destination_protocol	tls	Este valor puede ser tls (cifrado) o tcp (no cifrado).
papertrail_log_facility	""	La facilidad de Syslog a usar. Ver https://es.wikipedia.org/wiki/Syslog#Facility
papertrail_log_severity	""	La severidad de Syslog a usar. Ver https://es.wikipedia.org/wiki/Syslog#Severity_level
papertrail_new_file_check_interval	""	Si se usa un patrón glob para los archivos de registro, este parámetro controla la frecuencia de búsqueda de nuevos archivos de registro en el directorio.
papertrail_files_to_log	[]	Los archivos o patrones a leer.
papertrail_files_to_exclude	[]	Archivos a excluir en un directorio.
papertrail_exclude_patterns	[]	El patrón en el archivo de registro que deseas ignorar.

Para más información detallada sobre la configuración de remote_syslog2, visita la documentación de remote_syslog2 en Github.

Para más información detallada sobre Papertrail, visita la documentación oficial

Dependencias

Ninguna.

Ejemplo de Playbook

- hosts: webserver-01
  vars:
    papertrail_version: "0.19"
    papertrail_destination_host: logs.papertrailapp.com
    papertrail_destination_port: 12345
    papertrail_destination_protocol: tls
    papertrail_log_facility: local7
    papertrail_log_severity: warn
    papertrail_custom_hostname: "servidor-principal-01"
    papertrail_files_to_log:
      - path: /var/log/messages
        tag: messages
      - /var/log/dmesg
      - /var/log/httpd/access_log
    papertrail_exclude_patterns:
      - ^password.*
    papertrail_exclude_files:
      - .tar.gz
      - "*.old"
  roles:
      - role: papertrail