buluma.rsyslog

Ansibleロール rsyslog

システムにrsyslogをインストールして設定します。

GitHub バージョン 問題 プルリクエスト ダウンロード
github Version Issues PullRequests Ansible Role

例のプレイブック

この例は molecule/default/converge.yml から取られ、各プッシュ、プルリクエスト、リリースでテストされています。

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: buluma.rsyslog
      vars:
        rsyslog_traditional_file_format: false
        rsyslog_omit_local_logging: false

マシンを準備する必要があります。CIでは molecule/default/prepare.yml を使用して行います:

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: buluma.bootstrap

これらのロールの使用方法についての 詳細な説明と例 もご覧ください。

ロール変数

変数のデフォルト値は defaults/main.yml に設定されています:

---
# rsyslogのデフォルトファイル

# ログを受信するサーバーを設定するには、rsyslog_receiverをtrueに設定します。
rsyslog_receiver: false

# ログを別のサーバーに転送するには、rsyslog_remoteを受信側のrsyslogサーバーのホスト名または
# IPアドレスに設定します。
# この変数を設定しないとログは転送されません。
# rsyslog_remote: server1.example.com

# rsyslog_remoteが設定されている場合、リモートサーバーに送信するメッセージを決定するための
# "セレクター"パターンを設定します。デフォルトは"*.*"で、すべてを送信します。
# 詳細は`man rsyslog.conf`を参照してください。
rsyslog_remote_selector: "*.*"

# rsyslog_remoteが設定されている場合、真の場合はTCP、偽の場合はUDPを使用します。
rsyslog_remote_tcp: true

# rsyslog_remoteが設定されている場合、使用する宛先ポート。
rsyslog_remote_port: 514

# 新しいディレクトリのモードを設定します; これはレガシーテンプレートでのみ使用可能です。
rsyslog_dircreatemode: "0700"

# 新しいファイルのモードを設定します; これはレガシーテンプレートでのみ使用可能です。
rsyslog_filecreatemode: "0644"

# 有効なモジュールを設定
rsyslog_mods:
  - imuxsock
  - imjournal

# rsyslogを最小限に設定します(カスタム設定ファイルと競合する可能性があります)
rsyslog_deploy_default_config: true

# デフォルトのrsyslogdルール
rsyslog_default_rules:
  - { rule: '*.info;mail.none;authpriv.none;cron.none', logpath: '/var/log/messages' }
  - { rule: 'authpriv.*', logpath: '/var/log/secure' }
  - { rule: 'mail.*', logpath: '-/var/log/maillog' }
  - { rule: 'cron.*', logpath: '/var/log/cron' }
  - { rule: '*.emerg', logpath: ':omusrmsg:*' }
  - { rule: 'uucp,news.crit', logpath: '/var/log/spooler' }
  - { rule: 'local7.*', logpath: '/var/log/boot.log' }

# 古いlegacy file formatを使用するか、より
# 現代的なv6以上の'advanced'設定ファイルフォーマットを使用するかを選択します。デフォルトは
# 既存ユーザーの設定ファイルを不意に変更しないために'legacy'形式を使用します。
# 詳細はrsyslogのウェブサイトで確認できます:
# https://www.rsyslog.com/doc/v8-stable/configuration/conf_formats.html
rsyslog_config_file_format: legacy

# /etc/rsyslog.d/に追加するためのルールの名前
# rsyslog_forward_rule_name: <記入>

# rsyslogパッケージを`present`として設定するか、最新バージョンをインストールするために`latest`に設定します。
rsyslog_package_state: present

# falseに設定すると(sysklogdと互換性を持つためのレガシーのデフォルト)、受信システムと同じドメインに
# ある名前のドメイン部分が削除されます。オンに設定すると、フルネームが常に使用されます。
rsyslog_preservefqdn: false

# /etc/rsyslog.dに追加の設定ファイルを設定する
# 例:
# rsyslog_rsyslog_d_files:
#   000-splunk:
#     content: |
#       auth,authpriv.* action(type="omfwd"
#                              target="splunk"
#                              port="514"
#                              protocol="tcp")
rsyslog_rsyslog_d_files: []

# logrotateによるsd_journal_get_cursor() failed: Cannot assign requested addressメッセージを回避します
rsyslog_workaroundjournalbug: false

# ローカルログソケット経由でのメッセージ受信をオフにします
rsyslog_imuxsock_syssock: false

# 追加のrsyslogパッケージをインストールします
# 例:rsyslog-elasticsearchをインストールするための例:
# rsyslog_features:
#   - gnutls
#   - elastisearch
rsyslog_features: []

# rsyslog設定ファイルのデフォルトの宛先
rsyslog_dest_conf_file: "/etc/rsyslog.conf"

# オプションOmitLocalLoggingを有効/無効にします
rsyslog_omit_local_logging: true

# 伝統的なファイルフォーマットを使用できるようにします。
rsyslog_traditional_file_format: true

要件

使用されるロールの状態

システムを準備するために次のロールが使用されます。他の方法でシステムを準備することもできます。

要件 GitHub バージョン
buluma.bootstrap Ansible Molecule Version

コンテキスト

このロールは多くの互換性のあるロールの一部です。さらなる情報は これらのロールのドキュメント をご覧ください。

関連ロールの概要は次のとおりです:

dependencies

互換性

このロールは次の コンテナイメージ でテストされています:

コンテナ タグ
Alpine 全て
Amazon 候補
EL 8, 9
Debian 全て
Fedora 全て
opensuse 全て
Ubuntu 全て

必要な最小Ansibleバージョンは2.12で、以下のテストが行われています:

  • 前のバージョン。
  • 現在のバージョン。
  • 開発バージョン。

問題を見つけた場合は、GitHub に登録してください。

変更履歴

ロールの履歴

ライセンス

Apache-2.0

著者情報

Shadow Walker

プロジェクトについて

Install and configure rsyslog on your system.

インストール
ansible-galaxy install buluma.rsyslog
ライセンス
apache-2.0
ダウンロード
39.5k
所有者
DevOps Engineer