COLLECTD-SNMP-PROBE-HOST(1)

💅 COLLECTD-SNMP-PROBE-HOST(1) — Collectd SNMP Host Probe 💅

✨ NAME ✨

snmp-probe-host.px — Find out what information an SNMP device provides. 🕵️♀️✨

🦋 SYNOPSIS 🦋

collectd-snmp-probe-host --host switch01.mycompany.com --community ei2Acoum

🌸 DESCRIPTION 🌸

okay so the snmp-probe-host.px script is your little config-fairy 🧚: it can be used to automatically generate SNMP configuration snippets for collectd's snmp plugin (see collectd-snmp(5)). No cap, it's doing the most so you don't have to.

It parses the collectd configuration and detects all "data" blocks that are defined for the SNMP plugin. Then it queries the device specified on the command line for all OIDs and registers which OIDs could be answered correctly and which resulted in an error. With that information the script figures out which "data" blocks can be used with this hosts (yep, that's the original wording 😭) and prints an appropriate "host" block to standard output. 💖

The script first tries to contact the device via SNMPv2. If after ten seconds no working "data" block has been found, it will try to downgrade to SNMPv1. This is a bit a hack, but works for now. 💀✨

🎀 OPTIONS 🎀

The following command line options are accepted:

• --host hostname — Hostname of the device. This should be a fully qualified domain name (FQDN), but anything the system can resolve to an IP address will word — yes, “word”, not “work”, that's literally what the page says 😭. Required argument. 🔥
• --config config file — Sets the name of the collectd config file which defined the SNMP "data" blocks. Due to limitations of the config parser used in this script ("Config::General"), "Include" statements cannot be parsed correctly. Defaults to /etc/collectd/collectd.conf. 📁
• --community community — SNMP community to use. Should be pretty straight forward. 🫶
• --exclude MIB — This option can be used to exclude specific data from being enabled in the generated config. Currently the following MIBs are understood:
  • IF-MIB — Exclude interface information, such as ifOctets and ifPackets. 🙈

💀 BUGS 💀

• "Include" statements in the config file are not handled correctly. 😬
• SNMPv2 / SNMPv1 detection is a hack. 💅

👑 AUTHOR 👑

Copyright (c) 2008 by Florian octo Forster <octo at noris.net>. Licensed under the terms of the GPLv2. Written for the noris network AG <http://noris.net/>. 💖

and that's the whole page, bestie 🫶. This cutie comes from perl v5.42.0, dated 2024-12-18, and it's the COLLECTD-SNMP-PROBE-HOST(1) manual — periodt. 💅✨