stackhpc.monasca-rsyslog
Monasca Rsyslog 连接器
这个角色将本地部署的 rsyslog 连接到 Monasca 日志 API。
要求
目标主机应可以访问 Monasca 日志 API。Monasca 日志的客户端凭据应作为剧本参数提供。这些凭据会写入 clouds.yaml
文件中。
角色变量
monasca_rsyslog_venv
:Monasca rsyslog 连接器的虚拟环境安装路径。默认为 /usr/libexec/monasca-rsyslog
。
monasca_rsyslog_api_endpoint
:Monasca 日志 API 端点,格式为 http://monasca-log-api:5607/v3.0
。
monasca_rsyslog_api_auth
:OpenStack 认证凭据。例如,可以是如下格式的字典:
auth_url
:OpenStack Keystone 端点,例如 http://keystone:5000/project
:OpenStack 租户/项目。username
:OpenStack 用户名。password
:OpenStack 密码。
该字典可以还包括以下可选变量:
project_domain_name
:OpenStack 项目域名。默认为 "Default"。region_name
:OpenStack 区域名称。默认为 "RegionOne"。user_domain_name
:OpenStack 用户域名。默认为 "Default"。service_type
:OpenStack 监控服务类型。默认为 "monitoring"。endpoint_type
:OpenStack 监控端点类型。默认为 "public"。
monasca_rsyslog_packages_install
:标志,定义是否应在主机操作系统中安装创建 python 虚拟环境所需的包依赖。默认为 True
。
monasca_rsyslog_rhel_packages
:支持虚拟环境的依赖包名称列表,并允许在虚拟环境中通过 pip 构建适合启用 EPEL 的 CentOS 发行版的一些依赖项。
monasca_rsyslog_debian_packages
:支持虚拟环境的依赖包名称列表,并允许在虚拟环境中通过 pip 构建适合 Debian 发行版的一些依赖项。
monasca_rsyslog_custom_template_folder
:相对于运行该角色的剧本的文件夹,包含自定义 rsyslog 模板。例如,这可以用来接收未由 rsyslog 管理的系统日志。
依赖项
该角色安装由 Steve Simpson 开发的 monasca-rsyslog
输出驱动,来源于 https://github.com/stackhpc/monasca-rsyslog 。
示例剧本
以下剧本将 rsyslog 部署连接到 Monasca 的输出插件:
---
- name: 部署 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"
作者信息
- Stig Telfer (stig@stackhpc.com)
Role to connect a local rsyslog service with Monasca's log API.
ansible-galaxy install stackhpc.monasca-rsyslog