Merge branch 'collectd-4.2' into collectd-4.3
[collectd.git] / src / types.db.pod
1 =head1 NAME
2
3 types.db - Data-set specifications for the system statistics collection daemon
4 B<collectd>
5
6 =head1 SYNOPSIS
7
8   bitrate    value:GAUGE:0:4294967295
9   counter    value:COUNTER:U:U
10   if_octets  rx:COUNTER:0:4294967295, tx:COUNTER:0:4294967295
11
12 =head1 DESCRIPTION
13
14 The types.db file contains one line for each data-set specification. Each line
15 consists of two fields delimited by spaces and/or horizontal tabs. The first
16 field defines the name of the data-set, while the second field defines a list
17 of data-source specifications, delimited by spaces and, optionally, a comma
18 (",") right after each list-entry.
19
20 The format of the data-source specification has been inspired by RRDtool's
21 data-source specification. Each data-source is defined by a quadruple made up
22 of the data-source name, type, minimal and maximal values, delimited by colons
23 (":"): I<ds-name>:I<ds-type>:I<min>:I<max>. I<ds-type> may be either
24 B<COUNTER> or B<GAUGE>. I<min> and I<max> define the range of valid values for
25 data stored for this data-source. If B<U> is specified for either the min or
26 max value, it will be set to unknown, meaning that no range checks will
27 happen. See L<rrdcreate(1)> for more details.
28
29 =head1 FILES
30
31 The location of the types.db file is defined by the B<TypesDB> configuration
32 option (see L<collectd.conf(5)>). If you want to specify custom data-sets, you
33 should do so by using a custom file specified as an additional argument to the
34 B<TypesDB> option.
35
36 =head1 SEE ALSO
37
38 L<collectd(1)>,
39 L<collectd.conf(5)>,
40 L<rrdcreate(1)>
41
42 =head1 AUTHOR
43
44 B<collectd> has been written by Florian Forster
45 E<lt>octoE<nbsp>atE<nbsp>verplant.orgE<gt>.
46
47 This manpage has been written by Sebastian Harl
48 E<lt>shE<nbsp>atE<nbsp>tokkee.orgE<gt>.
49
50 =cut
51