an introduction to librenms - stichting nlnog · pdf filean introduction to librenms neil...
TRANSCRIPT
AnIntroductiontoLibreNMSNeilLathwood
NLNOG-day2017,Sept8th
www.librenms.org
History
ForkofObservium• ActualforkwasOct2013• LastGPLcodeMay2012• 18monthscoderegression
Initialforkwasdoneby:• PaulGear(Projectfounder)(@paulgear1)• TylerChristiansen(@supertylerc)
Auto-discoveringNMS.
• PHP/MySQLbased• DatacollectionisdoneviaSNMP• DatastorageviaRRDTool/InfluxDB/Graphite/OpenTSDB
• NetworkandInventoryinformation• GraphingviaRRDTool-upandtotheright
Like this
But not like this :(
Overview
Communitydrivenproject
Aimtobeinclusivetoeveryone
Open-source(GPLv3)
Githubstatistics
400+Contributors
14kCommits
4k+Pullrequests
2k+Issues
Features
Auto-discovery
CDP,LLDPorFDP
SNMPScan
EvenOSPF,ARPandBGP
Dashboards
Alerting
Simplerule
Notsosimple
Transports
20+Transportsavailable
Email,IRC,Slack,+more
EvenobscureoneslikeSyslogandElasticsearch
Templates
%titleSeverity:%severity{if%state==0}Timeelapsed:%elapsed{/if}Timestamp:%timestampUnique-ID:%uidRule:{if%name}%name{else}%rule{/if}{if%faults}Faults:{foreach%faults}#%key:%value.string{/foreach}{/if}Alertsentto:{foreach%contacts}%value<%key>{/foreach}
Variousauthenticationmethods:
• ActiveDirectory• HTTP• LDAP• Radius• 2FA
Syslog+Graylog2
Oxidized+Rancid
Oxidized+Rancid
API{ "status": "ok", "devices": [ { "device_id": "279", "hostname": "localhost", "sysName": "web01.1.novalocal", "ip": null, "community": “librenms", ….. "icon": "centos.svg", "poller_group": "0", "override_sysLocation": "0", "notes": null, "port_association_mode": "2" } ]}
Distributedpolling
Trafficbilling
CDRorQuotabased
Billingday
Customerandbillingreferences
DataavailableviaAPI
Granulargraphsavailable
Trafficbilling
Automaticupdates
Twoavailableupdatechannels:
Stable(GitHubreleases)
Development(masterbranch)
iPhoneandAndroidApps
MadeavailablecourtesyofPaul@WaveDirect
Installation
Manualinstall:• Masterbranchisdevelopment.• Monthlystablereleasesavailable(v1.31)currently.
Virtualimagesavailableincluding3rdpartydockercontainer.
Usercontributedautomatedscripts• Ansible• Chef
Devicesupport
Detectionforover350vendors
Eachmonth30+neworimprovedvendorsadded
Workingtosimplifyaddingadditionalsupport• Movingtoyamlfordetection• OSDiscoverydone• Health/Sensordiscoverydone
Gettinghelp
IRC–Primarymethod
Communitysite
GitHubforbugs
Gettinginvolved
Code
Docs
Helpothers
Find/reportbugsandaskfordevicesupport
Contact
https://github.com/librenms/librenms
https://community.librenms.org
https://www.twitter.com/librenms
https://www.facebook.com/LibreNMS/
https://www.reddit.com/r/LibreNMS/
##librenmsonfreenode