Rola Ansible: Munin Node

Instaluje munin-node, punkt końcowy systemu monitorowania, na serwerach Linux RedHat/CentOS lub Debian/Ubuntu.

Wymagania

Jeśli korzystasz z RedHat/CentOS, upewnij się, że masz zainstalowane repozytorium EPEL przed użyciem tej roli (możesz je zainstalować za pomocą roli geerlingguy.repo-epel).

Zmienne roli

Dostępne zmienne są wymienione poniżej, wraz z wartościami domyślnymi:

munin_node_bind_host: "*"
munin_node_bind_port: "4949"

Adres hosta i port, do którego munin-node będzie się przywiązywać. Typowe opcje hosta to 127.0.0.1 (localhost) lub * (przywiąż się do wszystkich adresów IP). 4949 to domyślny port Munin.

munin_node_host_name: ''

Ustaw to jawnie, jeśli munin master nie zgłasza poprawnej nazwy hosta podczas łączenia się z munin-node. W większości przypadków domyślne ustawienie powinno działać poprawnie.

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

Lista adresów IP sformatowanych jako wyrażenie regularne w stylu Pythona. Musisz używać pojedynczych cudzysłowów, aby umożliwić prawidłowe przekazywanie schematów regex do pliku konfiguracyjnego. Hosty z tymi adresami IP będą miały zezwolenie na połączenie się z serwerem i uzyskanie szczegółowych statystyk systemowych za pośrednictwem munin-node.

munin_node_allowed_cidrs: []

Lista sieci IP w formacie CIDR, na przykład 10.0.0.0/8. Hosty z adresem IP w jednej z tych sieci będą miały zezwolenie na połączenie się z serwerem i uzyskanie szczegółowych statystyk systemowych za pośrednictwem munin-node.

munin_node_denied_cidrs: []

Lista sieci IP w formacie CIDR, na przykład 10.42.0.0/16. Hosty z adresem IP w jednej z tych sieci będą miały zabroniony dostęp do serwera. To ustawienie ma pierwszeństwo nad munin_node_allowed_cidrs: adres IP, który pasuje zarówno do sieci w munin_node_allowed_cidrs, jak i do sieci w munin_node_denied_cidrs, będzie miał zabroniony dostęp.

Konfiguracja wtyczek Munin

Możesz włączyć wtyczki za pomocą listy munin_node_plugins, jak poniżej:

munin_node_plugins:
  - name: uptime

Jeśli nazwa wynikowej wtyczki nie pasuje do nazwy wtyczki munin, z której jest generowana (jak ma to miejsce na przykład w przypadku wtyczki if_), musisz dodać pole plugin do elementu listy, jak poniżej:

munin_node_plugins:
  - name: if_eth0
    plugin: if_

Ustawienia wtyczek

Jeśli musisz dodać konfigurację wtyczek do wtyczek, które dodałeś za pośrednictwem munin_node_plugins, możesz to zrobić za pomocą prostej mapy, która ma nazwę wtyczki (która będzie sekcją [plugin] w wynikowym pliku konfiguracyjnym), oraz listą nazw i wartości zmiennych. Na przykład:

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

Ta konfiguracja wygeneruje plik konfiguracyjny w /etc/munin/plugin-conf.d/ansible.conf z następującą zawartością:

[ps_test]
env.regex bash
env.name bash

Instalacja zewnętrznych wtyczek

Możesz zainstalować zewnętrzne wtyczki za pomocą munin_node_install_plugins. Te wtyczki mogą być kopiowane z lokalnych plików lub pobierane. Na przykład:

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

Zależności

Brak.

Przykład playbooka

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

Licencja

MIT / BSD

Informacje o autorze

Ta rola została stworzona w 2014 roku przez Jeffa Geerlinga, autora Ansible for DevOps.

Konfiguracja wtyczek Munin została dodana przez Rafała Trójniaka ansible-galaxy@trojniak.net.