collectd

Set up Collectd in Debian-like systems.

Requirements

None

Variables

collectd_install: [default: []]: (Additional) Packages to install
collectd_plugins_present: [default: ['contextswitch', 'cpu', 'df', 'disk', 'interface', 'irq', 'network', 'processes', 'swap', 'tcpconns', 'uptime']]: Names of the plugins to install
collectd_plugins_absent: [default: []]: Names of the plugins to remove

Plugin `network`

collectd_plugin_network_servers: [default: []]: The servers to send the data to
collectd_plugin_network_servers.{n}.server: [required]: The IP address of the server
collectd_plugin_network_servers.{n}.port: [default: 25826]: The port of the server
collectd_plugin_network_servers.{n}.security_level: [optional]: The security level is one of three values: None, Sign or Encrypt
collectd_plugin_network_servers.{n}.username: [optional]: Username
collectd_plugin_network_servers.{n}.password: [optional]: Password

Plugin `disk`

collectd_plugin_disk_disks: [default: ['/^[vhs]d[a-f]$/']]: Names (or regexes to match names) of disks to collect information of

Plugin `interface`

collectd_plugin_interface_interfaces: [default: []]: Network interfaces to collect information of, defaults to all interfaces when empty

Plugin `mysql`

collectd_plugin_mysql_databases: [default: []]: The MySQL databases to collect information of.
collectd_plugin_mysql_databases.{n}.alias: [optional]: Alias to use as sender instead of hostname when reporting. This may be useful when having cryptic hostnames.
collectd_plugin_mysql_databases.{n}.hostname: [default: localhost]: Hostname of the database server
collectd_plugin_mysql_databases.{n}.username: [optional]: Username to use when connecting to the database. The user does not have to be granted any privileges (which is synonym to granting the USAGE privilege), unless you want to collectd replication statistics (see MasterStats and SlaveStats below). In this case, the user needs the REPLICATION CLIENT (or SUPER) privileges. Else, any existing MySQL user will do.
collectd_plugin_mysql_databases.{n}.password: [optional]: Password needed to log into the database.
collectd_plugin_mysql_databases.{n}.database: [optional]: Select this database. Defaults to no database which is a perfectly reasonable option for what this plugin does.
collectd_plugin_mysql_databases.{n}.port: [optional]: TCP-port to connect to. If Host is set to localhost (the default), this setting has no effect. See the documentation for the mysql_real_connect function for details.
collectd_plugin_mysql_databases.{n}.socket: [optional]: Specifies the path to the UNIX domain socket of the MySQL server. This option only has any effect, if Host is set to localhost (the default). Otherwise, use the Port option above. See the documentation for the mysql_real_connect function for details.
collectd_plugin_mysql_databases.{n}.innodb_stats: [default: true]: If enabled, metrics about the InnoDB storage engine are collected.
collectd_plugin_mysql_databases.{n}.master_stats: [default: false]: Enable the collection of master statistics in a replication setup. In order to be able to get access to these statistics, the user needs special privileges. Defaults to false.
collectd_plugin_mysql_databases.{n}.slave_stats: [default: false]: Enable the collection of slave statistics in a replication setup. In order to be able to get access to these statistics, the user needs special privileges. Defaults to false.

Plugin `apache`

collectd_plugin_apache_instances: [default: []]: The Apaches instances to collect information of.
collectd_plugin_apache_instances.{n}.name: [default: apache]: The name of the instance
collectd_plugin_apache_instances.{n}.url: [default: http://localhost/mod_status?auto]: Sets the URL of the mod_status output. This needs to be the output generated by ExtendedStatus on and it needs to be the machine readable output generated by appending the ?auto argument.
collectd_plugin_apache_instances.{n}.username: [optional]: Optional user name needed for authentication
collectd_plugin_apache_instances.{n}.password: [optional]: Optional password needed for authentication
collectd_plugin_apache_instances.{n}.verify_peer: [default: true]: Enable or disable peer SSL certificate verification. See http://curl.haxx.se/docs/sslcerts.html for details
collectd_plugin_apache_instances.{n}.verify_host: [default: true]: Enable or disable peer host name verification. If enabled, the plugin checks if the Common Name or a Subject Alternate Name field of the SSL certificate matches the host name provided by the URL option. If this identity check fails, the connection is aborted. Obviously, only works when connecting to a SSL enabled server.
collectd_plugin_apache_instances.{n}.ca_cert_file: [optional]: File that holds one or more SSL certificates. If you want to use HTTPS you will possibly need this option. What CA certificates come bundled with libcurl and are checked by default depends on the distribution you use.
collectd_plugin_apache_instances.{n}.ssl_ciphers: [optional]: Specifies which ciphers to use in the connection. The list of ciphers must specify valid ciphers. See http://www.openssl.org/docs/apps/ciphers.html for details.

Dependencies

None

Example(s)

Minimal (set server IP address for network plugin only)

---
- hosts: all
  roles:
    - oefenweb.collectd
  vars:
    collectd_plugin_network_servers:
      - server: '10.0.0.1'

With encryption

---
- hosts: all
  roles:
    - oefenweb.collectd
  vars:
    collectd_plugin_network_servers:
      - server: '10.0.0.1'
        security_level: Encrypt
        username: foo
        password: bar

With plugin mysql

---
- hosts: all
  roles:
    - oefenweb.collectd
  vars:
    collectd_install:
      - collectd-utils
    collectd_plugin_mysql_databases:
      - username: foo
        password: bar

License

MIT

Author Information

Mark van Driel
Mischa ter Smitten

Feedback, bug-reports, requests, ...

Are welcome!

nlware/ansible-collectd

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 2

Uh oh!

Languages

Packages