Ansible Role: LibreNMS Agent

Version: 1.0.3

Development of this project is managed in a private repository then pushed out to GitLab and GitHub when we have a new version for you. If you have any issues please contact sparknsh

Role Variables

librenms_agent_snmp_ip: 127.0.0.1
librenms_agent_snmp_port: 161

librenms_agent_snmp_community: public

librenms_agent_snmp_user:
librenms_agent_snmp_auth_type: # md5 or sha
librenms_agent_snmp_password:
librenms_agent_snmp_encryption_type: # aes or des
librenms_agent_snmp_encryption:

librenms_agent_snmp_location:
librenms_agent_snmp_contact:

Here are the most common settings for SNMP monitoring.

librenms_agent_snmp_no_logging: False

Not everyone likes logging everything so this variable allows you to no log the snmp information.

librenms_agent_snmp_mysql_hostname:
librenms_agent_snmp_mysql_username:
librenms_agent_snmp_mysql_password:
librenms_agent_snmp_mysql_port:

To monitor MySQL database performance you need to connect to the databse server with the following variables. Be sure to enable mysql under the Check_MK Scripts or SMTP Scripts section

librenms_agent_scripts_update: False

This variable allows you to always fetch the scrip from the github repo.

librenms_agent_check_mk: False

By default Check_MK is not installed without enabled scripts below. If you want to install it without any scripts change this variable to True.

Check_MK Scripts

librenms_agent_check_mk_scripts:
  - apache
  - bind
  - ceph
  - dmi
  - dpkg
  - drbd
  - freeswitch
  - gpsd
  - hddtemp
  - memcached
  - munin
  - mysql
  - nfsstats
  - nginx
  - powerdns
  - powerdns-recursor
  - proxmox
  - rocks
  - rpm
  - rrdcached
  - temperature
  - tinydns
  - unbound

SNMP Scripts

librenms_agent_snmp_scripts:
  - apache-stats
  - asterisk
  - bind
  - chip
  - dhcp-status
  - distro
  - entropy
  - exim-stats
  - fail2ban
  - fbsdnfsclient
  - fbsdnfsserver
  - freeradius
  - mysql
  - mysql-stats
  - nfs-stats
  - nginx
  - ntp-client
  - ntp-server
  - nvidia
  - osupdate
  - phpfpmsp
  - pi-hole
  - postfix-queues
  - postfixdetailed
  - postgres
  - powerdns-dnsdist
  - powerdns-recursor
  - raspberry
  - sdfsinfo
  - smart
  - squid
  - unbound
  - ups-apcups
  - ups-nut
  - zfs-freebsd
  - zfs-linux

Example

librenms_agent_snmp_ip: 0.0.0.0
librenms_agent_snmp_port: 161

librenms_agent_snmp_community: public

librenms_agent_snmp_location: Nashville, TN, US
librenms_agent_snmp_contact: IT Admin

librenms_agent_snmp_no_logging: True

librenms_agent_snmp_scripts:
  - distro
  - ntp-client
  - os-updates

Example Playbook

- hosts: all
  vars_files:
    - vars/main.yml
  roles:
     - { role: sparknsh.librenms_agent }

License

MIT

Author Information

This role was created in 2018 by sparknsh at Rebel Media, Inc.

DerDanilo/ansible-role-librenms-agent