Chapter 15. Variables

15.1.4. Bandwidth Summation

|sum:([0 9]|auto):(current|total):([0 9]):([0 9]+|auto)|

Bandwidth summation is useful for summing up all values in an RRD file for a given time range. This is typically

useful on traffic graphs where you can see a total of all traffic that has gone through an interface in a given time

period.

In Cacti, bandwidth summation works just like any other graph variable. To use this variable you must give it three

arguments:

Table 15 2. Bandwidth Summation Argument Description

Name

Description

([0 9]|auto)

This field determines the power of 10 divisor that will be applied to your number.

Enter '0' to leave the number alone, '3' for kilo or '6' for mega, etc. You can also enter

'auto' for this field to have Cacti automatically scale the number and insert the

appropriate label.

(current|total)

You can choose to calculate the summation based on the current data source or a total

of all data sources used on the graph. The only valid values for this field are 'current'

and 'total'.

[0 9]

Enter the number of digits to use for floating point precision when printing out the

final number. The default value for this field is two decimal places.

([0 9]+|auto)

Enter the number of seconds in the past to perform the summation calculation for. For

instance '86400' for 24 hours, '172800' for 48 hours, etc. You can also enter 'auto' for

this field to have Cacti use the graph timespan.

Example 15 4. Output in the following format: 36.47 GB

|sum:auto:current:2:auto|

15.2. Host Variables

Host variables represent host data and can be placed in graph or data source titles. The following table describes

which host variables can be used and which host fields the correspond to.

Table 15 3. Host Variables

Variable Name

Description

|host_description|

Description

|host_hostname|

Hostname

|host_snmp_community|

SNMP Community

|host_snmp_version|

SNMP Version

|host_snmp_username|

SNMP Username (v3)

|host_snmp_password|

SNMP Password (v3)

39