Skip to content

Releases: somethingwithproof/snmp-bind9-statistics

v1.0.0 - Initial Stable Release

04 Oct 08:38

Choose a tag to compare

🎉 SNMP BIND9 Statistics v1.0.0

First stable release of the SNMP monitoring agent for BIND9 DNS servers.

✨ Key Features

  • 📊 Comprehensive Statistics Collection

    • Query types (A, AAAA, MX, PTR, TXT, SOA, CNAME, NS)
    • Response codes and error rates
    • Cache hit/miss ratios
    • Zone transfer statistics
    • Resolver performance metrics
  • 🔄 Intelligent Monitoring

    • Configurable polling intervals
    • Built-in caching to reduce load
    • Force refresh capability
    • Automatic error recovery
  • 🛠️ Enterprise Ready

    • SNMP v2c support
    • Custom OID mapping
    • Comprehensive error handling
    • Detailed logging with Log4perl
    • Signal handling for graceful shutdown

📦 Installation

# Clone and install
git clone https://github.com/thomasvincent/snmp-bind9-statistics.git
cd snmp-bind9-statistics

# Install dependencies
cpanm Config::IniFiles Net::SNMP File::Slurp Log::Log4perl

# Run the agent
./bin/snmp_bind9_stats.pl --config=config.ini

🔧 Quick Configuration

[general]
stats_file = /var/cache/bind/named.stats
rndc_command = rndc stats
log_level = INFO
poll_interval = 300

[snmp]
community = public
port = 161
agent_addr = 0.0.0.0

📊 SNMP OID Structure

  • Query Statistics: 1.3.6.1.4.1.99999.1.1.*
  • Name Server Stats: 1.3.6.1.4.1.99999.1.2.*
  • Resolver Stats: 1.3.6.1.4.1.99999.1.3.*

🔍 Monitoring Integration

Works seamlessly with:

  • Nagios/Icinga
  • Zabbix
  • PRTG Network Monitor
  • Any SNMP-compatible monitoring system

📚 Documentation

🤝 Contributing

Contributions are welcome! Please check our Contributing Guidelines.

📄 License

MIT License - see LICENSE


Full Changelog: https://github.com/thomasvincent/snmp-bind9-statistics/commits/v1.0.0