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"

作者信息

关于项目

Role to connect a local rsyslog service with Monasca's log API.

安装
ansible-galaxy install stackhpc.monasca-rsyslog
许可证
apache-2.0
下载
541
拥有者
StackHPC develops OpenStack capabilities for research computing use cases. Through extensive experience, we understand HPC and cloud.