Conector Rsyslog de Monasca

Este rol conecta una implementación local de rsyslog a una API de registro de Monasca.

Requisitos

Las API de registros de Monasca deben ser accesibles desde el host de destino. Se deben proporcionar las credenciales del cliente para el registro de Monasca como parámetros del playbook. Estos se escriben en un archivo clouds.yaml.

Variables del rol

monasca_rsyslog_venv: Ruta a una instalación de virtualenv del conector rsyslog de Monasca. Por defecto es /usr/libexec/monasca-rsyslog.

monasca_rsyslog_api_endpoint: Endpoint de la API de registros de Monasca, en la forma http://monasca-log-api:5607/v3.0.

monasca_rsyslog_api_auth: Credenciales de autenticación de OpenStack. Por ejemplo, un diccionario de la forma:

• auth_url: Endpoint de OpenStack Keystone, por ejemplo http://keystone:5000/.
• project: Proyecto/tenant de OpenStack.
• username: Nombre de usuario de OpenStack.
• password: Contraseña de OpenStack.

El diccionario puede incluir también las siguientes variables opcionales:

• project_domain_name: Nombre del dominio del proyecto de OpenStack. Por defecto es "Default".
• region_name: Nombre de la región de OpenStack. Por defecto es "RegionOne".
• user_domain_name: Nombre del dominio del usuario de OpenStack. Por defecto es "Default".
• service_type: Tipo de servicio de monitoreo de OpenStack. Por defecto es "monitoring".
• endpoint_type: Tipo de endpoint de monitoreo de OpenStack. Por defecto es "public".

monasca_rsyslog_packages_install: Bandera para definir si las dependencias de paquetes para crear un virtualenv de Python deben ser instaladas en el sistema operativo del host. Por defecto es True.

monasca_rsyslog_rhel_packages: Lista de nombres de paquetes de dependencia para habilitar el soporte de virtualenv y permitir la construcción de algunas dependencias dentro de un virtualenv por pip, adecuado para una distribución CentOS con EPEL habilitado.

monasca_rsyslog_debian_packages: Lista de nombres de paquetes de dependencia para habilitar el soporte de virtualenv y permitir la construcción de algunas dependencias dentro de un virtualenv por pip, adecuado para una distribución Debian.

monasca_rsyslog_custom_template_folder: Carpeta, relativa al playbook que ejecuta este rol, que contiene plantillas rsyslog personalizadas. Por ejemplo, esto puede usarse para ingerir registros del sistema que no están gestionados por rsyslog.

Dependencias

Este rol instala el controlador de salida monasca-rsyslog desarrollado por Steve Simpson de https://github.com/stackhpc/monasca-rsyslog.

Ejemplo de Playbook

El siguiente playbook conecta una implementación de rsyslog con un plugin de salida para Monasca:

---
- name: Desplegar controlador para Monasca-rsyslog
  hosts: all
  roles:
    - role: stackhpc.monasca-rsyslog
      monasca_rsyslog_api_auth:
        auth_url: "http://openstack-keystone:5000"
        project: "monasca"
        username: "monasca-agent"
        password: "{{ vault_encypted_monasca_agent_password }}"
      monasca_rsyslog_venv: "/usr/libexec/monasca-rsyslog"

Información del autor

• Stig Telfer (stig@stackhpc.com)