NAME

lxc_guests - collect statistics about containers virtualized via LXC

CONFIGURATION

  [lxc_guests]
    user root

    # The memory usage of containers are by default drawn as stacked area
    # charts.  Alternatively a non-stacked graph with lines can be configured.
    # Default: true
    #env.ram_display_stacked true

    # lxc container path, default below
    #env.lxcpath /var/lib/lxc

    # exclude the following containers
    # (default none excluded)
    #env.exclude container1 container2

    # path where tasks sysfs files are stored,
    # set this if the various attempts in the
    # code don't work
    # (default none)
    #env.cgrouppath /sys/fs/cgroup/cpuacct/lxc/

INTERPRETATION

This plugin needs root privilege.

This plugin has been tested with lxc 3 and lx2 (on Debian buster and Debian jessie, respectively).

For the network graphs to work, you need to have in every container's config file a line defining the virtual network interface path (else lxc will use a random name at each container's start); see the lxc_netdev() function below.

If using lxc 2, make sure you do not have cruft in your container config files, you can test it with: lxc-cgroup -o /dev/stdout -l INFO -n 104 cpuacct.usage -- with 104 a valid lxc instance), if you get a warning, fix the config file.

For the logins graph, the "users" command is required in each container.

Tested on Debian buster and Debian jessie.

AUTHOR

vajtsz vajtsz@gmail.com mitty mitty@mitty.jp alphanet schaefer@alphanet.ch (many changes and multigraph) Lars Kruse <devel@sumpfralle.de>

LICENSE

2-clause BSD License or GPLv3 license or later, at your option

MAGIC MARKERS

 #%# family=auto
 #%# capabilities=autoconf