Cacti (home)ForumsDocumentation

Differences

This shows you the differences between two versions of the page.

manual:087:3_templates.1_data_template [2009/02/22 11:41]
gandalf created
manual:087:3_templates.1_data_template [2019/10/29 15:16] (current)
Line 1: Line 1:
-===== Creating a Data Template =====+===== Data Templates =====
  
 To create a new data template, select Data Templates under the Templates heading and click Add. To create a new data template, select Data Templates under the Templates heading and click Add.
Line 25: Line 25:
 === Data Source Items === === Data Source Items ===
  
-Like a graph, a data source can have more than one items. This is useful in situations where a script returns more than piece of data at one time. This also applies to data queries, so you can have a single data template that contains both inbound and outbound traffic, rather than having to create a separate data template for each.+Like a graph, a data source can have more than one item. This is useful in situations where a script returns more than piece of data at one time. This also applies to data queries, so you can have a single data template that contains both inbound and outbound traffic, rather than having to create a separate data template for each.
  
 **Table 11-5. Field Description: Data Source Items** **Table 11-5. Field Description: Data Source Items**
Line 36: Line 36:
 | Heartbeat | If rrd's are not updated within Heartbeat's seconds, the needed data point is assumed to be **NaN** ("**N**ot **a** **N**umber = no valid data).\\ As defined by RRDTool: "The maximum amount of time that can pass before data is entered as "unknown". This field is usually '600' or 2 data gathering intervals".\\ **Note:** When using **1 min** polling, //Heartbeat// has to be adjusted, e.g. to a value of //120//.| | Heartbeat | If rrd's are not updated within Heartbeat's seconds, the needed data point is assumed to be **NaN** ("**N**ot **a** **N**umber = no valid data).\\ As defined by RRDTool: "The maximum amount of time that can pass before data is entered as "unknown". This field is usually '600' or 2 data gathering intervals".\\ **Note:** When using **1 min** polling, //Heartbeat// has to be adjusted, e.g. to a value of //120//.|
 |**OID**|Numerical representation of the OID that will be used for querying the target to retrieve data| |**OID**|Numerical representation of the OID that will be used for querying the target to retrieve data|
 +
 +**CAVEAT!**
 +Adding a new data source item will affect new data sources (rrd files) only! Existing data sources (rrd files) that are related to the modified Data Template will **NOT** be modified. This restriction is due to the fact, that rrdtool does not provide a command to add a new data source item to an existing data source (rrd file).
 +In such a case, you will have to re-create the whole data source (rrd file), e.g. by deleting this very file, loosing all historical data. Cacti will then re-create the rrd file based on the modified definition during the next polling cycle.
  
 === Custom Data === === Custom Data ===





Personal Tools