Ansibleロール: Muninノード

RedHat/CentOSまたはDebian/Ubuntu Linuxサーバーに、監視システムのエンドポイントであるmunin-nodeをインストールします。

必要条件

RedHat/CentOSを使用する場合は、このロールを使用する前にEPELリポジトリがインストールされていることを確認してください（geerlingguy.repo-epelロールを使用してインストールできます）。

ロール変数

使用可能な変数は以下の通りで、デフォルト値も示しています：

munin_node_bind_host: "*"
munin_node_bind_port: "4949"

munin-nodeがバインドするホストとポートです。一般的なホストのオプションは127.0.0.1（ローカルホスト）または*（すべてのIPアドレスにバインド）です。4949はデフォルトのMuninポートです。

munin_node_host_name: ''

muninマスターがtelnetでmunin-nodeに接続したときに正しいホスト名を報告しない場合は、これを明示的に設定してください。ほとんどの場合、デフォルトで問題ありません。

munin_node_allowed_ips:
  - '^127\.0\.0\.1$'
  - '^::1$'

Pythonスタイルの正規表現としてフォーマットされたIPアドレスのリストです。設定ファイルに正しい正規表現エスケープを通すために、シングルクォートを使用する必要があります。これらのIPアドレスを持つホストはサーバーに接続し、munin-nodeを介して詳細なシステム統計を取得できます。

munin_node_allowed_cidrs: []

CIDR形式のIPネットワークのリストです。例えば、10.0.0.0/8です。これらのネットワーク内にIPアドレスがあるホストは、サーバーに接続し、munin-nodeを介して詳細なシステム統計を取得できます。

munin_node_denied_cidrs: []

CIDR形式のIPネットワークのリストです。例えば、10.42.0.0/16です。これらのネットワーク内にIPアドレスがあるホストは、サーバーへのアクセスを拒否されます。これはmunin_node_allowed_cidrsよりも優先されます：munin_node_allowed_cidrsのネットワークとmunin_node_denied_cidrsのネットワークの両方に一致するIPアドレスはアクセスが拒否されます。

Muninプラグイン設定

以下のようにして、munin_node_pluginsリストを用いてプラグインを有効にできます：

munin_node_plugins:
  - name: uptime

結果として生成されるプラグインの名前が元のmuninプラグインの名前と一致しない場合（例えば、if_プラグインの場合）、リスト項目にpluginフィールドを追加する必要があります：

munin_node_plugins:
  - name: if_eth0
    plugin: if_

プラグイン設定

munin_node_pluginsから追加したプラグインの設定を追加する必要がある場合は、プラグイン名（結果の設定ファイルの[plugin]セクションになります）と変数名および値のリストを持つシンプルなハッシュマップを使用できます。例えば：

munin_node_config: {
  "ps_test": {
    "env.regex": "bash",
    "env.name": "bash"
  }
}

この設定は、/etc/munin/plugin-conf.d/ansible.confに以下の内容の設定ファイルを生成します：

[ps_test]
env.regex bash
env.name bash

外部プラグインのインストール

munin_node_install_pluginsを介して外部プラグインをインストールできます。 これらのプラグインは、ローカルファイルからコピーしたり、ダウンロードしたりできます。例えば：

munin_node_install_plugins: []
  - src: files/munin/redis_
  - remote_src: https://raw.githubusercontent.com/ohitz/phpfpm-multi-munin-plugin/master/phpfpm-multi

依存関係

なし。

サンプルプレイブック

- hosts: servers
  roles:
    - { role: geerlingguy.munin-node }

ライセンス

MIT / BSD

作者情報

このロールは2014年にJeff Geerlingによって作成され、Ansible for DevOpsの著者です。

Muninプラグインの設定はRafał Trójniak ansible-galaxy@trojniak.netによって追加されました。