Ansible-Rolle: Munin-Knoten

Installiert den Munin-Knoten, einen Überwachungssystem-Endpunkt, auf RedHat/CentOS oder Debian/Ubuntu Linux-Servern.

Anforderungen

Wenn Sie RedHat/CentOS verwenden, stellen Sie sicher, dass das EPEL-Repository installiert ist, bevor Sie diese Rolle verwenden (Sie können es mit der Rolle geerlingguy.repo-epel installieren).

Rollenvariablen

Verfügbare Variablen sind unten aufgeführt, zusammen mit den Standardwerten:

munin_node_bind_host: "*"
munin_node_bind_port: "4949"

Der Host und der Port, an den der Munin-Knoten gebunden wird. Häufige Hostoptionen sind 127.0.0.1 (localhost) oder * (bindet an alle IP-Adressen). 4949 ist der Standardport von Munin.

munin_node_host_name: ''

Setzen Sie dies explizit, wenn der Munin-Master den richtigen Hostnamen beim Telnetten zum Munin-Knoten nicht meldet. In den meisten Fällen sollte der Standardwert gut funktionieren.

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

Eine Liste von IP-Adressen, formatiert als regulärer Ausdruck im Python-Stil. Es müssen einfache Anführungszeichen verwendet werden, um das richtige Regex-Entkommen in die Konfigurationsdatei zu ermöglichen. Hosts mit diesen IP-Adressen dürfen sich mit dem Server verbinden und detaillierte Systemstatistiken über den Munin-Knoten abrufen.

munin_node_allowed_cidrs: []

Eine Liste von IP-Netzwerken im CIDR-Format, zum Beispiel 10.0.0.0/8. Hosts mit einer IP-Adresse in einem dieser Netzwerke dürfen sich mit dem Server verbinden und detaillierte Systemstatistiken über den Munin-Knoten abrufen.

munin_node_denied_cidrs: []

Eine Liste von IP-Netzwerken im CIDR-Format, zum Beispiel 10.42.0.0/16. Hosts mit einer IP-Adresse in einem dieser Netzwerke wird der Zugriff auf den Server verweigert. Dies hat Vorrang vor munin_node_allowed_cidrs: Eine IP-Adresse, die mit einem Netzwerk in munin_node_allowed_cidrs und einem Netzwerk in munin_node_denied_cidrs übereinstimmt, wird der Zugriff verweigert.

Munin-Plugin-Konfiguration

Sie können Plugins mit der Liste munin_node_plugins aktivieren, zum Beispiel:

munin_node_plugins:
  - name: uptime

Wenn der Name des resultierenden Plugins nicht mit dem Namen des Munin-Plugins übereinstimmt, aus dem es erstellt wurde (wie im Fall des if_-Plugins), müssen Sie ein Feld plugin zum Listenelement hinzufügen, zum Beispiel:

munin_node_plugins:
  - name: if_eth0
    plugin: if_

Plugin-Einstellungen

Wenn Sie eine Plugin-Konfiguration für Plugins hinzufügen müssen, die Sie über munin_node_plugins hinzugefügt haben, können Sie dies mit einer einfachen Hashmap tun, die den Plugin-Namen enthält (der die [plugin]-Sektion in der resultierenden Konfigurationsdatei sein wird) und eine Liste von Variablennamen und -werten. Zum Beispiel:

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

Diese Konfiguration generiert eine Konfigurationsdatei unter /etc/munin/plugin-conf.d/ansible.conf mit folgendem Inhalt:

[ps_test]
env.regex bash
env.name bash

Externe Plugins installieren

Sie können externe Plugins über munin_node_install_plugins installieren. Diese Plugins können von lokalen Dateien kopiert oder heruntergeladen werden. Zum Beispiel:

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

Abhängigkeiten

Keine.

Beispiel-Playbook

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

Lizenz

MIT / BSD

Autorinformationen

Diese Rolle wurde 2014 von Jeff Geerling erstellt, Autor von Ansible for DevOps.

Die Munin-Plugin-Konfiguration wurde von Rafał Trójniak ansible-galaxy@trojniak.net hinzugefügt.