ansible/roles/snmpd/README.md
2021-08-08 13:26:39 -05:00

3.3 KiB

snmpd

CI Ansible Galaxy

Set up snmp(d) in Debian-like systems.

Requirements

On Debian the non-free repository must be enabled to download the snmp-mibs-downloader package, on Ubuntu this package is in multiverse. See the "Recommended" section below.

Variables

  • snmpd_install [default: [lm-sensors]]: Additional packages to install

  • snmpd_mibs [default: UCD-SNMP-MIB]: MIBs to load

  • snmpd_run [default: true]: Snmpd control (true means start daemon)

  • snmpd_opts [default: '-LS4d -Lf /dev/null -u snmp -g snmp -I -smux -p /var/run/snmpd.pid']: Snmpd options (use syslog, close stdin/out/err)

  • snmpd_trapd_run [default: false]: Snmptrapd control (true means start daemon)

  • snmpd_trapd_opts [default: '-Lsd -p /var/run/snmptrapd.pid']: Snmptrapd options (use syslog)

  • snmpd_snmpd_compat [default: false]: Create symlink on Debian legacy location to official RFC path

  • snmpd_agent_address [default: `['udp:161', 'udp6:[::1]:161']: Agent address

  • snmpd_internal_user: [default: see defaults.yml]: Internal user. Make sure to change!

  • snmpd_users: [default: see defaults.yml]: Additional users. Make sure to change!

  • snmpd_sys_location [default: '']: System location

  • snmpd_sys_contact [default: Root <root@localhost>]: System contact

  • snmpd_sys_description [default: {{ inventory_hostname }}]: System description

  • snmpd_disks_include_all: [default: false]: Include all disks mounted on the system in the SNMP table

  • snmpd_disks_include_all_threshold_minpercent: [default: 10%]: Minimum free space specified as a percentage

  • snmpd_disks: [default: []]: List of disk paths and their corresponding thresholds to be included in the SNMP table

  • snmpd_disks.{n}.path: [required]: The disks mountpoint (e.g. /)

  • snmpd_disks.{n}.threshold: [required]: The disks minimum threshold either be specified in kB (MINSPACE) or as a percentage of the total disk (MINPERCENT% with a '%' character) (e.g. 10%)

  • snmpd_default_monitors [default: true]: Configure the Event MIB tables to monitor the various UCD-SNMP-MIB tables for problems

  • snmpd_link_up_down_notifications [default: true]: Configure the Event MIB tables to monitor the fTable for network interfaces being taken up or down, and triggering a linkUp or linkDown notification as appropriate

  • snmpd_extensions: [default: []]: Extension MIB declaration(s)

  • snmpd_extensions.{n}.name: [required]: An identifying string for the extension

  • snmpd_extensions.{n}.prog: [required]: The program to run

  • snmpd_extensions.{n}.args: [default: []]: The arguments to give the program

Dependencies

None

  • ansible-apt (see, to manage apt repositories (in /etc/apt/sources.list)

Example

---
- hosts: all
  roles:
    - snmpd

License

MIT

Author Information

Mischa ter Smitten

Feedback, bug-reports, requests, ...

Are welcome!