Skip to main content

Collectd plugin to monitor EOS MGM metrics.

Project description

Collectd plugin to collect EOS metrics. Connects to a mgm instance using eos client and publishes node, fs and space metrics.

Collectd config section example:

<Plugin python>
    Import collectd_eos
    <Module collectd_eos>
        instance example root://eos.example
        instance another root://another.eos.instance.example
        instance third root://third.mgm.intance.example
        interval 60
        eos_client_command ssh eos
  • instance expects 2 values:
    • EOS instance name / plugin instance name
  • interval overrides the default collection interval
  • eos_client_command is used when there is no eos client on the collectd node, and ssh or docker are needed to run eos, especially during plugin development

If there are no instances defined in config and $EOS_MGM_URL is set, it is used as the default url with the instance name set to the hostname portion.

If there are no instances defined in config and $EOS_MGM_URL is unset, the current hostname is used as the instance name and url.


Test in virutalenv:

virtualenv venv
. venv/bin/activate
pip install -r build-requirements.txt -r test-requirements.txt
pip install -e .
python sdist bdist_wheel
twine check dist/*

Use collectd.conf or collectd.docker.conf for functional testing: does the plugin cope with real metrics?

On a host with eos:

$ collectd -Tf -C collectd.conf

Docker can be used for the eos client:

$ docker run --name eos_client --rm -itd
<container id output>
$ docker exec -it eos_client kinit <username>@CERN.CH
<password prompt>
$ collectd -Tf -C collectd.docker.conf
<check collectd log for errors>
$ docker stop eos_client


All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.1 - 2019-02-28


  • More testing
  • More documentation


  • Readme needed one more newline at the end to be used as the package description


  • Python 2.6 support no longer promised, attempted, or tested.

0.2.0 - 2019-02-27


  • pyproject.toml to define build requirements as per PEP-518
  • build-requirements.txt and build-requirements.26.txt to document build requirements in a more realistic, backwards-compatible way.


  • Configuration section format. mgm_url key is removed EOS instances are now defined by the key “instance” which expects two values:
    • instance name, must be unique, defines the collectd plugin instance name reported with the metrics
    • mgm_url, the url eos client will query for data


  • Don’t sent interval of -1 to collectd, it does not interpret it as default

0.1.0 - 2019-02-26


  • README.rst and CHANGELOG.rst
  • package sources src/collectd_eos
  • unit tests in tests/ and tox.ini
  • collectd.conf and collectd.docker.conf for testing with collectd
  • eos.types.db to define eos time-series datasets for collectd
  • LICENSE Apache 2

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collectd_eos-0.2.1.tar.gz (15.1 kB view hashes)

Uploaded source

Built Distributions

collectd_eos-0.2.1-py3-none-any.whl (10.0 kB view hashes)

Uploaded py3

collectd_eos-0.2.1-py2-none-any.whl (10.0 kB view hashes)

Uploaded py2

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page