Skip to content

Billing Module

The billing module creates a bill with a quota and a set of ports. It then tracks the use of these ports. It shows the use and the overage in the bill. Accounting works by total transferred data and by 95th percentile.

To enable and use the billing module, do these steps:

system/billing

lnms config:set enable_billing true

Edit /etc/cron.d/librenms and add this line: 

*/5 * * * * librenms /opt/librenms/poll-billing.php >> /dev/null 2>&1
01  * * * * librenms /opt/librenms/billing-calculate.php >> /dev/null 2>&1

Go to Settings -> Poller -> Settings Then select Billing Enabled for each poller.

Adding a bill

To create a new bill, from the LibreNMS menu select Ports -> Traffic Bills and select + Create Bill.

Enter the details in the form. Select at least one device and one port.

95th Percentile Calculation

For 95th percentile billing, LibreNMS uses the higher of the input calculation and the output calculation by default.

To use the total of the input and the output for the 95th percentile, set 95th Calculation to "Aggregate". This setting applies to one bill.

system/billing

lnms config:set billing.95th_default_agg true

This configuration setting is cosmetic. It only changes the default option of a new bill.