{"id":106,"date":"2017-01-26T05:55:33","date_gmt":"2017-01-26T05:55:33","guid":{"rendered":"http:\/\/blog.lns.com\/?p=106"},"modified":"2020-01-21T20:09:03","modified_gmt":"2020-01-21T20:09:03","slug":"librenms-api","status":"publish","type":"post","link":"https:\/\/blog.lns.com\/?p=106","title":{"rendered":"Librenms’ API"},"content":{"rendered":"

Librenms<\/a> is a very flexible network and server monitoring and alerting system. \u00a0I have it deployed at a number of companies based on the ease of installation, the fact that it auto discovers devices, it is updated frequently (typically multiple times a week<\/a>) and supports pretty much every network device you can think of.<\/p>\n

On top of that, the alerting can be tuned to match very specific cases as the back end is MySQL so you alerting conditions can match almost anything you can write a SQL query for. \u00a0A good example would be to only alert on certain interfaces that have a specific description in them such as “TRANSIT” where the device has a hostname of “edge” and is only a 10Gbs connection (the interface name is ‘xe’). \u00a0Because you can group things by description or part of a hostname, you can just say anything with the string “edge” in the hostname should be considered a “edge router” so a group “ER” can be created for these devices. \u00a0With autodiscovery, as soon as you add a device, it will get automatically be put into the group that the rule\/regular expression matches it.<\/p>\n

One of the more interesting features is Libre’s API<\/a>. \u00a0You can get pretty much any detail you want out of what Libre has collected and stored in the DB. \u00a0It will also create graphs for you on the fly. \u00a0One case I have had in the past is to create daily and weekly total bandwidth graphs for a set of specific ports on a group of switches. \u00a0The switch ports have a particular unique string I can match on so I was able to create a “group” called “peering” that included these ports over all of the switches.<\/p>\n

I wrote this simple script called create_public_graphs.sh<\/a>\u00a0that asked for a graph for daily and weekly time frames. \u00a0I also added various options to the request such as don’t show the legend of interfaces and make the in and out directions all one color. \u00a0The other option is to make different colors for each interface. \u00a0We wanted a clean look so we went for a solid color. \u00a0The API doesn’t do everything you may want such as titling the graph. \u00a0This is where I use the “convert” program from\u00a0imagemagick<\/a> to overlay some text at the top of the graph. \u00a0You can see the final result at the SFMIX site<\/a>.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Librenms is a very flexible network and server monitoring and alerting system. \u00a0I have it deployed at a number of companies based on the ease of installation, the fact that it auto discovers devices, it is updated frequently (typically multiple times a week) and supports pretty much every network device you can think of. On … Continue reading “Librenms’ API”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10,13],"tags":[],"_links":{"self":[{"href":"https:\/\/blog.lns.com\/index.php?rest_route=\/wp\/v2\/posts\/106"}],"collection":[{"href":"https:\/\/blog.lns.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.lns.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.lns.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.lns.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=106"}],"version-history":[{"count":3,"href":"https:\/\/blog.lns.com\/index.php?rest_route=\/wp\/v2\/posts\/106\/revisions"}],"predecessor-version":[{"id":176,"href":"https:\/\/blog.lns.com\/index.php?rest_route=\/wp\/v2\/posts\/106\/revisions\/176"}],"wp:attachment":[{"href":"https:\/\/blog.lns.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=106"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.lns.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=106"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.lns.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=106"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}