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 仮想環境を作成するためのパッケージ依存関係をホスト OS にインストールするかどうかを定義するフラグ。デフォルトは True
です。
monasca_rsyslog_rhel_packages
: 仮想環境サポートを有効にし、EPEL 対応の CentOS ディストリビューションに適した pip によって仮想環境内でのいくつかの依存関係のビルドを有効にする依存パッケージ名のリストです。
monasca_rsyslog_debian_packages
: 仮想環境サポートを有効にし、Debian ディストリビューションに適した pip によって仮想環境内でのいくつかの依存関係のビルドを有効にする依存パッケージ名のリストです。
monasca_rsyslog_custom_template_folder
: このロールを実行するプレイブックに対してのカスタム rsyslog テンプレートを含むフォルダーです。例えば、rsyslog によって管理されていないシステムログを取り込むために使用することができます。
依存関係
このロールは、https://github.com/stackhpc/monasca-rsyslog から Steve Simpson によって開発された monasca-rsyslog
出力ドライバーをインストールします。
例プレイブック
以下のプレイブックは、Monasca 用の出力プラグインで rsyslog デプロイメントを接続します:
---
- 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