Code

collectd.git
17 years agocontrib/collection.cgi: Improved some more graphs.
Florian Forster [Sat, 19 May 2007 10:06:35 +0000 (12:06 +0200)]
contrib/collection.cgi: Improved some more graphs.

17 years agocontrib/collection.cgi: Include `back'-links and more vertical labels.
Florian Forster [Sat, 19 May 2007 09:49:12 +0000 (11:49 +0200)]
contrib/collection.cgi: Include `back'-links and more vertical labels.

17 years agocontrib/collection.cgi: Print proper HTML-header.
Florian Forster [Sat, 19 May 2007 08:57:55 +0000 (10:57 +0200)]
contrib/collection.cgi: Print proper HTML-header.

17 years agocontrib/collection.cgi: Included a completely new version with hardly any functionality.
Florian Forster [Sat, 19 May 2007 08:04:25 +0000 (10:04 +0200)]
contrib/collection.cgi: Included a completely new version with hardly any functionality.

17 years agocontrib/migrate-3-4.px: Create (sub)directories for the disk plugin.
Florian Forster [Sat, 19 May 2007 08:03:02 +0000 (10:03 +0200)]
contrib/migrate-3-4.px: Create (sub)directories for the disk plugin.

17 years agocontrib/{extractDS,migrate-3-4}.px: Don't use XML::Simple and don't check for the...
Florian Forster [Fri, 18 May 2007 17:34:43 +0000 (19:34 +0200)]
contrib/{extractDS,migrate-3-4}.px: Don't use XML::Simple and don't check for the output directory.

17 years agorrdtool plugin: Assure that values, that are older then the newest value in the cache...
Florian Forster [Fri, 18 May 2007 15:11:30 +0000 (17:11 +0200)]
rrdtool plugin: Assure that values, that are older then the newest value in the cache, are rejected.

Otherwise there might be gaps in the graphs.

17 years agodns plugin: Only submit dns-traffic if either counter is non-zero.
Florian Forster [Fri, 18 May 2007 15:10:35 +0000 (17:10 +0200)]
dns plugin: Only submit dns-traffic if either counter is non-zero.

17 years agoemail plugin: Only submit `spam_score' if any mails have been processed.
Florian Forster [Fri, 18 May 2007 15:08:19 +0000 (17:08 +0200)]
email plugin: Only submit `spam_score' if any mails have been processed.

17 years agodisk plugin: Remove slashed from disk-names.
Florian Forster [Thu, 17 May 2007 21:00:18 +0000 (23:00 +0200)]
disk plugin: Remove slashed from disk-names.

17 years agocontrib/extractDS.px: Create RRD file instead of writing to STDOUT.
Florian Forster [Thu, 17 May 2007 20:59:51 +0000 (22:59 +0200)]
contrib/extractDS.px: Create RRD file instead of writing to STDOUT.

This was changed in order to debug new code and then forgotten..

17 years agocontrib/migrate-3-4.px: Handle `disk' and `partition' files correctly.
Florian Forster [Thu, 17 May 2007 20:59:04 +0000 (22:59 +0200)]
contrib/migrate-3-4.px: Handle `disk' and `partition' files correctly.

17 years agocontrib/extractDS.px: Allow extration of multiple DSes into one file with multiple...
Florian Forster [Thu, 17 May 2007 13:11:17 +0000 (15:11 +0200)]
contrib/extractDS.px: Allow extration of multiple DSes into one file with multiple DSes.

This is needed to migrate the old disk-RRD-files.

17 years agocollectd(1): Changed plugin information for v4.
Florian Forster [Thu, 17 May 2007 12:08:43 +0000 (14:08 +0200)]
collectd(1): Changed plugin information for v4.

Also removed information about the `modes' and RRD-file definitions.

17 years agoInclude `config.h' from all files.
Florian Forster [Thu, 17 May 2007 11:09:08 +0000 (13:09 +0200)]
Include `config.h' from all files.

Either directly or indirectly via `collectd.h'.

17 years agoMerge branch 'pull/collectd-4' into collectd-4
Florian Forster [Thu, 17 May 2007 10:36:12 +0000 (12:36 +0200)]
Merge branch 'pull/collectd-4' into collectd-4

17 years agoMerge branch 'master' into collectd-4
Florian Forster [Tue, 15 May 2007 17:27:31 +0000 (19:27 +0200)]
Merge branch 'master' into collectd-4

Conflicts:

src/multimeter.c
src/network.c
src/utils_debug.c

17 years agoMerge branch 'collectd-3.11'
Florian Forster [Tue, 15 May 2007 17:22:25 +0000 (19:22 +0200)]
Merge branch 'collectd-3.11'

17 years agoInclude "config.h" rather than <config.h>.
Florian Forster [Tue, 15 May 2007 17:20:27 +0000 (19:20 +0200)]
Include "config.h" rather than <config.h>.

17 years ago[PATCH] Added large file support ("backported" to collectd-3).
Sebastian Harl [Mon, 14 May 2007 18:57:03 +0000 (20:57 +0200)]
[PATCH] Added large file support ("backported" to collectd-3).

This adds large file support to collectd by using the AC_SYS_LARGEFILE macro
in configure.in. In order to apply any necessary options to all parts of
collectd, we have to make sure config.h is included in all source files
(either directly or by including collectd.h) and before any other header files
are included.

This should fix http://bugs.debian.org/422212.

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agosrc/plugin.c: assert (ds->ds_num == vl->values_len); when debug is enabled.
Florian Forster [Tue, 15 May 2007 13:30:42 +0000 (15:30 +0200)]
src/plugin.c: assert (ds->ds_num == vl->values_len); when debug is enabled.

17 years agoconfigure.in: Don't check for grp.h twice.
Florian Forster [Sun, 13 May 2007 16:20:57 +0000 (18:20 +0200)]
configure.in: Don't check for grp.h twice.

17 years agoperl plugin: Work around a redefinition of DEBUG in perl.h.
Sebastian Harl [Sat, 12 May 2007 11:47:19 +0000 (13:47 +0200)]
perl plugin: Work around a redefinition of DEBUG in perl.h.

Some versions of Perl define their own verion of DEBUG in perl.h overwriting
the definition found in plugin.h. This works around this issue.

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agounixsock plugin: Don't assert that `ds->ds_num == vl->values_num' when not built...
Florian Forster [Sat, 12 May 2007 18:00:16 +0000 (20:00 +0200)]
unixsock plugin: Don't assert that `ds->ds_num == vl->values_num' when not built with debugging enabled.

17 years agodisk plugin: Correct the collection of {read,write}-time.
Florian Forster [Fri, 11 May 2007 19:16:14 +0000 (21:16 +0200)]
disk plugin: Correct the collection of {read,write}-time.

It's actually `average time an IO-operation needs'.

17 years agoMerge branch 'pull/collectd-4' into collectd-4
Florian Forster [Thu, 10 May 2007 07:51:04 +0000 (09:51 +0200)]
Merge branch 'pull/collectd-4' into collectd-4

17 years agounixsock plugin: Don't include <sys/poll.h> since it's not used.
Florian Forster [Thu, 10 May 2007 07:50:50 +0000 (09:50 +0200)]
unixsock plugin: Don't include <sys/poll.h> since it's not used.

17 years agoemail plugin: Include <sys/un.h> rather than <linux/un.h>.
Florian Forster [Thu, 10 May 2007 07:50:32 +0000 (09:50 +0200)]
email plugin: Include <sys/un.h> rather than <linux/un.h>.

17 years agoapple_sensors plugin: Fix the `module_register' function.
Florian Forster [Wed, 9 May 2007 06:45:33 +0000 (08:45 +0200)]
apple_sensors plugin: Fix the `module_register' function.

17 years agoconfigure.in: Bumped version to 4.0.0-rc9 collectd-4.0.0-rc9
Florian Forster [Tue, 8 May 2007 21:07:23 +0000 (23:07 +0200)]
configure.in: Bumped version to 4.0.0-rc9

17 years agounixsock plugin: Remove the socket-file after closing the socket.
Florian Forster [Tue, 8 May 2007 21:06:44 +0000 (23:06 +0200)]
unixsock plugin: Remove the socket-file after closing the socket.

17 years agoiptables plugin: Fix a segfault in the shutdown code.
Florian Forster [Tue, 8 May 2007 21:06:20 +0000 (23:06 +0200)]
iptables plugin: Fix a segfault in the shutdown code.

That's the problem with macros: `for (...) sfree (ptr);' doesn't work.

17 years agosrc/types_list.c: Strip newlines from the end of the line.
Florian Forster [Tue, 8 May 2007 20:44:51 +0000 (22:44 +0200)]
src/types_list.c: Strip newlines from the end of the line.

17 years agomemory plugin: Bugfix: values_len is one now, not four.
Florian Forster [Tue, 8 May 2007 20:09:37 +0000 (22:09 +0200)]
memory plugin: Bugfix: values_len is one now, not four.

17 years agomemory plugin: Fix the Linux-code: It submitted the same value for all RRD-files.
Marius Rieder [Sun, 6 May 2007 14:43:26 +0000 (16:43 +0200)]
memory plugin: Fix the Linux-code: It submitted the same value for all RRD-files.

17 years agosrc/plugin.c: Check `list_data_set' to be non-NULL before querying it.
Marius Rieder [Sun, 6 May 2007 14:41:45 +0000 (16:41 +0200)]
src/plugin.c: Check `list_data_set' to be non-NULL before querying it.

17 years agoconfigure.in: Bumped version to 4.0.0-rc8 collectd-4.0.0-rc8
Florian Forster [Sat, 5 May 2007 06:19:31 +0000 (08:19 +0200)]
configure.in: Bumped version to 4.0.0-rc8

17 years agosrc/Makefile.am: Include `types.db' in the tarballs.
Florian Forster [Sat, 5 May 2007 06:18:41 +0000 (08:18 +0200)]
src/Makefile.am: Include `types.db' in the tarballs.

17 years agotypes.db: Reverse the order of the `df'-DSes.
Marius Rieder [Sat, 5 May 2007 06:00:55 +0000 (08:00 +0200)]
types.db: Reverse the order of the `df'-DSes.

17 years agomemory plugin: Fix the `sysctl'-code which submitted the same values for all instances.
Marius Rieder [Sat, 5 May 2007 05:58:47 +0000 (07:58 +0200)]
memory plugin: Fix the `sysctl'-code which submitted the same values for all instances.

17 years agosrc/plugin.c: Copy the data-sets before inserting them in the list.
Florian Forster [Fri, 4 May 2007 07:24:07 +0000 (09:24 +0200)]
src/plugin.c: Copy the data-sets before inserting them in the list.

Thus memory management is done by `plugin.c' and overwritten DSes can be freed.

17 years agoconfigure.in: Bumped version to 4.0.0-rc7 collectd-4.0.0-rc7
Florian Forster [Thu, 3 May 2007 19:42:10 +0000 (21:42 +0200)]
configure.in: Bumped version to 4.0.0-rc7

17 years agoMerge branch 'ff/types' into collectd-4
Florian Forster [Thu, 3 May 2007 19:38:55 +0000 (21:38 +0200)]
Merge branch 'ff/types' into collectd-4

17 years agosrc/configfile.c: s/TypesDS/TypesDB/;
Florian Forster [Thu, 3 May 2007 19:38:39 +0000 (21:38 +0200)]
src/configfile.c: s/TypesDS/TypesDB/;

17 years agoRemoved the config-option `LoadDS' and the passing of the `modreg_e' enum to `module_...
Florian Forster [Thu, 3 May 2007 16:31:49 +0000 (18:31 +0200)]
Removed the config-option `LoadDS' and the passing of the `modreg_e' enum to `module_register' again.

17 years agotypes_list: Do not free `ds' and `dsrc' because it's not copied in `plugin_register_d...
Florian Forster [Thu, 3 May 2007 09:16:29 +0000 (11:16 +0200)]
types_list: Do not free `ds' and `dsrc' because it's not copied in `plugin_register_data_set'.

This is a TODO.

17 years agotypes_list: More error-messages when something cannot be parsed.
Florian Forster [Thu, 3 May 2007 09:09:02 +0000 (11:09 +0200)]
types_list: More error-messages when something cannot be parsed.

17 years agotypes_list: Added `types.db'.
Florian Forster [Thu, 3 May 2007 09:08:24 +0000 (11:08 +0200)]
types_list: Added `types.db'.

17 years agosrc/types_list.c: Added a function to parse a generic list of `types'.
Florian Forster [Thu, 3 May 2007 08:49:16 +0000 (10:49 +0200)]
src/types_list.c: Added a function to parse a generic list of `types'.

It's not yet tested, but it compiles ;)

17 years agoliboconfig/Makefile.am: Don't remove `parser.[ch]' and `scanner.c' when making `clean'.
Florian Forster [Sun, 29 Apr 2007 07:59:44 +0000 (09:59 +0200)]
liboconfig/Makefile.am: Don't remove `parser.[ch]' and `scanner.c' when making `clean'.

17 years agoFixed Shebang line in contrib/iptables/accounting.sh.
Sebastian Harl [Tue, 24 Apr 2007 08:13:42 +0000 (10:13 +0200)]
Fixed Shebang line in contrib/iptables/accounting.sh.

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agoconfigure.in: Check for `libgen.h'.
Florian Forster [Sun, 29 Apr 2007 07:54:58 +0000 (09:54 +0200)]
configure.in: Check for `libgen.h'.

17 years agorrdtool plugin: Updated copyright notice.
Florian Forster [Mon, 23 Apr 2007 18:22:39 +0000 (20:22 +0200)]
rrdtool plugin: Updated copyright notice.

17 years agoconfigure.in: Bumped version to 4.0.0-rc6 collectd-4.0.0-rc6
Florian Forster [Mon, 23 Apr 2007 14:00:22 +0000 (16:00 +0200)]
configure.in: Bumped version to 4.0.0-rc6

17 years agoliboconfig, liboping: Set version information.
Florian Forster [Mon, 23 Apr 2007 13:56:12 +0000 (15:56 +0200)]
liboconfig, liboping: Set version information.

17 years agoLink against liboconfig statically or use external shared library.
Sebastian Harl [Sun, 22 Apr 2007 13:48:20 +0000 (15:48 +0200)]
Link against liboconfig statically or use external shared library.

There is no point in linking against liboconfig dynamically if it is only used
in one place.

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agoperl plugin: Added the "IncludeDir" config option.
Sebastian Harl [Sun, 22 Apr 2007 20:57:43 +0000 (22:57 +0200)]
perl plugin: Added the "IncludeDir" config option.

"IncludeDir <Dir>" adds <Dir> to the @INC array.

A segfault when parsing unknown config options has been fixed and documentation
about the perl plugin has been added to collectd.conf.pod.

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agoperl plugin: Respect the modreg flags in module_register ().
Sebastian Harl [Sun, 22 Apr 2007 13:47:38 +0000 (15:47 +0200)]
perl plugin: Respect the modreg flags in module_register ().

TODO: Pass on MR_DATASETS to perl plugins.

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agosrc/Makefile.am: Define `PREFIX' for the unixsock plugin.
Florian Forster [Mon, 23 Apr 2007 05:43:07 +0000 (07:43 +0200)]
src/Makefile.am: Define `PREFIX' for the unixsock plugin.

17 years agomigrate-3-4.px: Split up the memory.rrd file.
Florian Forster [Sun, 22 Apr 2007 08:24:37 +0000 (10:24 +0200)]
migrate-3-4.px: Split up the memory.rrd file.

17 years agomemory plugin: Split up the memory data-sources into several data-sets.
Florian Forster [Sun, 22 Apr 2007 08:18:22 +0000 (10:18 +0200)]
memory plugin: Split up the memory data-sources into several data-sets.

17 years agosrc/liboconfig: Imported liboconfig 0.1.2.
Florian Forster [Sat, 21 Apr 2007 09:55:20 +0000 (11:55 +0200)]
src/liboconfig: Imported liboconfig 0.1.2.

17 years agoMerge branch 'pull/collectd-4' into collectd-4
Florian Forster [Sat, 21 Apr 2007 09:39:33 +0000 (11:39 +0200)]
Merge branch 'pull/collectd-4' into collectd-4

17 years agoemail plugin: Fix a segfault in the shutdown routine.
Florian Forster [Sat, 21 Apr 2007 09:38:29 +0000 (11:38 +0200)]
email plugin: Fix a segfault in the shutdown routine.

It was only caused when run in DS-only-mode.

17 years agoemail plugin: Only kill threads/close sockets that exist/are opened.
Florian Forster [Sat, 21 Apr 2007 09:17:56 +0000 (11:17 +0200)]
email plugin: Only kill threads/close sockets that exist/are opened.

17 years agocollectd.conf.in: Added the `Hostname' option to the sample config file.
Florian Forster [Sat, 21 Apr 2007 09:17:28 +0000 (11:17 +0200)]
collectd.conf.in: Added the `Hostname' option to the sample config file.

17 years agoMerge branch 'pull/collectd-4' into collectd-4
Florian Forster [Fri, 20 Apr 2007 14:16:27 +0000 (16:16 +0200)]
Merge branch 'pull/collectd-4' into collectd-4

17 years agocontrib: Collectd::Unixsock: Added inline-documentation.
Florian Forster [Fri, 20 Apr 2007 13:41:39 +0000 (15:41 +0200)]
contrib: Collectd::Unixsock: Added inline-documentation.

17 years agounixsock plugin: Don't add values to the cache that are older or as old as the values...
Florian Forster [Fri, 20 Apr 2007 07:09:48 +0000 (09:09 +0200)]
unixsock plugin: Don't add values to the cache that are older or as old as the values in the cache.

17 years agoperl plugin: Use `Perl_newSVpv' rather than `newSVpv'
Florian Forster [Fri, 20 Apr 2007 06:33:52 +0000 (08:33 +0200)]
perl plugin: Use `Perl_newSVpv' rather than `newSVpv'

..cause Sebastian said to do so ;)

17 years agorrdtool plugin: config: Copy `value' before modifying it.
Florian Forster [Fri, 20 Apr 2007 06:33:07 +0000 (08:33 +0200)]
rrdtool plugin: config: Copy `value' before modifying it.

17 years agoMerge branch 'pull/collectd-4'
Florian Forster [Fri, 20 Apr 2007 06:20:28 +0000 (08:20 +0200)]
Merge branch 'pull/collectd-4'

17 years agobuild system: Use the prefix given to --with-libperl to set the path to the perl...
Florian Forster [Fri, 20 Apr 2007 06:19:18 +0000 (08:19 +0200)]
build system: Use the prefix given to --with-libperl to set the path to the perl interpreter.

17 years agocpu plugin: Return an integer even under FreeBSD.
Florian Forster [Fri, 20 Apr 2007 06:15:47 +0000 (08:15 +0200)]
cpu plugin: Return an integer even under FreeBSD.

17 years agorrdtool plugin: Add a config option to configure the RRA-timespans at runtime.
Florian Forster [Thu, 19 Apr 2007 19:10:30 +0000 (21:10 +0200)]
rrdtool plugin: Add a config option to configure the RRA-timespans at runtime.

17 years agoconfigure.in: Bumped version to 4.0.0-rc5
Florian Forster [Wed, 18 Apr 2007 16:04:18 +0000 (18:04 +0200)]
configure.in: Bumped version to 4.0.0-rc5

17 years agoMerge branch 'sh/perl' into collectd-4
Florian Forster [Wed, 18 Apr 2007 16:00:42 +0000 (18:00 +0200)]
Merge branch 'sh/perl' into collectd-4

17 years agoconfigure.in: Print the Perl-version in the configure-summary.
Florian Forster [Wed, 18 Apr 2007 11:44:10 +0000 (13:44 +0200)]
configure.in: Print the Perl-version in the configure-summary.

17 years agocollectd-nagios(1): Added manpage for the Nagios-glue.
Florian Forster [Tue, 17 Apr 2007 21:28:04 +0000 (23:28 +0200)]
collectd-nagios(1): Added manpage for the Nagios-glue.

17 years agoChangeLog: Added a note about the perl plugin.
Florian Forster [Tue, 17 Apr 2007 20:56:33 +0000 (22:56 +0200)]
ChangeLog: Added a note about the perl plugin.

17 years agoperl plugin: Use the `BaseName' only if it is non-empty.
Florian Forster [Tue, 17 Apr 2007 20:51:56 +0000 (22:51 +0200)]
perl plugin: Use the `BaseName' only if it is non-empty.

17 years agoconfigure.in: Bumped version to 4.0.0-rc4 collectd-4.0.0-rc4
Florian Forster [Tue, 17 Apr 2007 19:58:12 +0000 (21:58 +0200)]
configure.in: Bumped version to 4.0.0-rc4

17 years agoMerge branch 'pull/collectd-4' into collectd-4
Florian Forster [Tue, 17 Apr 2007 19:56:43 +0000 (21:56 +0200)]
Merge branch 'pull/collectd-4' into collectd-4

17 years agoping plugin: Improved error and debug messages.
Florian Forster [Mon, 16 Apr 2007 13:49:53 +0000 (15:49 +0200)]
ping plugin: Improved error and debug messages.

17 years agoping plugin: Fail if no hosts was pinged.
Florian Forster [Mon, 16 Apr 2007 13:30:08 +0000 (15:30 +0200)]
ping plugin: Fail if no hosts was pinged.

17 years agoMerge branch 'pull/collectd-4' into collectd-4
Florian Forster [Mon, 16 Apr 2007 12:53:12 +0000 (14:53 +0200)]
Merge branch 'pull/collectd-4' into collectd-4

17 years agoperl plugin: Exported plugin_log() to Perl.
Sebastian Harl [Tue, 10 Apr 2007 22:27:54 +0000 (00:27 +0200)]
perl plugin: Exported plugin_log() to Perl.

This adds the following function to collectd's Perl API:

Collectd::plugin_log:
  pass a message to collectd's logging mechanism

  arguments:
  level - log level
  message - log message

The log level should be any of the Collectd::LOG_* constants.

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agoperl plugin: Exported plugin_log() to Perl.
Sebastian Harl [Tue, 10 Apr 2007 22:27:54 +0000 (00:27 +0200)]
perl plugin: Exported plugin_log() to Perl.

This adds the following function to collectd's Perl API:

Collectd::plugin_log:
  pass a message to collectd's logging mechanism

  arguments:
  level - log level
  message - log message

The log level should be any of the Collectd::LOG_* constants.

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agoperl plugin: Added "BaseName" config option.
Sebastian Harl [Tue, 10 Apr 2007 22:25:57 +0000 (00:25 +0200)]
perl plugin: Added "BaseName" config option.

This option sets the basename of a Perl plugin, i.e. the prefix to its name
when loading the module. It defaults to "Collectd::Plugin".

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agoMerge branch 'master' into collectd-4
Florian Forster [Tue, 10 Apr 2007 15:23:13 +0000 (17:23 +0200)]
Merge branch 'master' into collectd-4

Conflicts:

configure.in

17 years agoMerge branch 'collectd-3.11'
Florian Forster [Tue, 10 Apr 2007 15:21:49 +0000 (17:21 +0200)]
Merge branch 'collectd-3.11'

Conflicts:

ChangeLog

17 years agoBumped version to 3.11.4; Updated ChangeLog. collectd-3.11.4
Florian Forster [Tue, 10 Apr 2007 15:19:09 +0000 (17:19 +0200)]
Bumped version to 3.11.4; Updated ChangeLog.

17 years agosrc/utils_dns.c: Include `sys/socket.h' before `net/if_arp.h'.
Florian Forster [Tue, 10 Apr 2007 15:09:09 +0000 (17:09 +0200)]
src/utils_dns.c: Include `sys/socket.h' before `net/if_arp.h'.

17 years agoconfigure.in: Improved the checks for `net/if_arp.h' and `netinet/if_ether.h'.
Florian Forster [Tue, 10 Apr 2007 15:08:09 +0000 (17:08 +0200)]
configure.in: Improved the checks for `net/if_arp.h' and `netinet/if_ether.h'.

17 years agoconfigure.in: Added check for `libperl'.
Florian Forster [Tue, 10 Apr 2007 14:56:14 +0000 (16:56 +0200)]
configure.in: Added check for `libperl'.

17 years agocollectd(1): Added documentation for the `perl' plugin.
Florian Forster [Tue, 10 Apr 2007 12:46:29 +0000 (14:46 +0200)]
collectd(1): Added documentation for the `perl' plugin.

17 years agoperl plugin: Added a plugin to embed a Perl interpreter into collectd.
Sebastian Harl [Mon, 9 Apr 2007 16:26:48 +0000 (18:26 +0200)]
perl plugin: Added a plugin to embed a Perl interpreter into collectd.

This is the long awaited plugin that makes it possible to write plugins in
plain Perl. This is my first glance at using Perl's C API, so I'm pretty sure
there are some things that could habe been done better. Much of the plugin
could have been written in Perl as well, but I decided not to do so mainly for
exercise reasons ;-)

This plugin still needs a lot of testing. Also comments on the API, code, etc.
are very welcome.

Basically, the plugin is just the glue that's required for Perl plugins to
access collectd's internals. The following API is currently available:

Collectd::plugin_register:
  register working functions or data sets with collectd

  arguments:
  type - type of the registered data
  name - name of the plugin
  data - reference to the plugin's working subroutine or the data set

Collectd::plugin_unregister:
  unregister working functions or data sets from collectd

  arguments:
  type - type of the data to be unregistered
  name - name of the plugin

Collectd::plugin_dispatch_values:
  dispatch the collected values to the write functions

  arguments:
  name - name of the plugin
  values - list of values to submit

The plugin type may be any of the following:
  Collectd::TYPE_INIT
  Collectd::TYPE_READ
  Collectd::TYPE_WRITE
  Collectd::TYPE_LOG
  Collectd::TYPE_SHUTDOWN
  Collectd::TYPE_DATASET

A data set is represented as a reference to an array containing hashes with the
following elements:
  name => $ds_name (required)
  type => $ds_type (default: COUNTER)
  min  => $ds_min (default: NAN)
  max  => $ds_max (default: NAN)

A value list is represented as a reference to a hash with the following
elements:
  values => [ @values ] (required)
  time   => $time (default: time(NULL))
  host   => $hostname (default: hostname_g)
  plugin => $plugin (default: "")
  plugin_instance => $plugin_instance (default: "")
  type_instance   => $type_instance (default: "")

The default value is used whenever the element is not defined.

Three arguments are passed to write functions: the plugin's type, the plugin's
data set and the value list.

Two arguments are passed to log functions: the log level and the log message.

In case a function returns false (as interpreted by Perl) the following actions
are taken depending on the function type:
  read: the function will be disabled for an increasing amount of time
  init: the plugin will be disabled completely
  anything else: a warning is logged

In addition to the ones listed above the following constants are also exported:
  Collectd::DS_TYPE_COUNTER
  Collectd::DS_TYPE_GAUGE
  Collectd::LOG_ERR
  Collectd::LOG_WARNING
  Collectd::LOG_NOTICE
  Collectd::LOG_INFO
  Collectd::LOG_DEBUG

There is no need to load any Collectd modules - everything is completely
integrated into collectd.

TODO:
  add support for accessing the config file
  write documentation
  add checks for perl to configure

Signed-off-by: Sebastian Harl <sh@tokkee.org>
17 years agoREADME: Updated list of plugins and requirements.
Florian Forster [Mon, 9 Apr 2007 22:15:21 +0000 (00:15 +0200)]
README: Updated list of plugins and requirements.

17 years agocontrib/: Updated the `README' file.
Florian Forster [Mon, 9 Apr 2007 16:07:38 +0000 (18:07 +0200)]
contrib/: Updated the `README' file.

17 years agocontrib/: Moved the SLES 10.1 files into a seperate subdirectory.
Florian Forster [Mon, 9 Apr 2007 15:53:07 +0000 (17:53 +0200)]
contrib/: Moved the SLES 10.1 files into a seperate subdirectory.