https://github.com/cvmfs/collectd-cvmfs

Collectd Plugin to Monitor CvmFS Clients
https://github.com/cvmfs/collectd-cvmfs

collectd collectd-plugin cvmfs

Last synced: 5 months ago
JSON representation

Collectd Plugin to Monitor CvmFS Clients

• Host: GitHub
• URL: https://github.com/cvmfs/collectd-cvmfs
• Owner: cvmfs
• License: apache-2.0
• Created: 2017-07-21T09:43:15.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2025-09-06T13:33:27.000Z (9 months ago)
• Last Synced: 2025-09-06T15:22:02.628Z (9 months ago)
• Topics: collectd, collectd-plugin, cvmfs
• Language: Python
• Homepage:
• Size: 43.9 KB
• Stars: 5
• Watchers: 5
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • Changelog: NEWS.txt
  • License: LICENSE

Awesome Lists containing this project

README

          
Collectd Module for CvmFS

=========================

Configuration

-------------

Example::

    TypesDB "/usr/share/collectd/collectd_cvmfs.db"

    

      Import "collectd_cvmfs"

      

        Repo "alice.cern.ch" "atlas.cern.ch"

        Repo "ams.cern.ch"

        MountTime True

        MountTimeout 10

        Memory True

        Attribute ndownload nioerr

        Attribute usedfd

        Verbose False

        Interval "300"

      

    

* ``TypesDB``: types used by the plugin and shipped with the package.

* ``Repo``: cvmfs repository to monitor.

* ``MountTime``: boolean value to specify whether mount time should be reported or not.

* ``MountTimeout``: timeout in seconds while trying to mount the repositories.

* ``Memory``: boolean value to specify whether the memory footprint should be reported or not.

* ``Attribute``: attribute to monitor on the given repositories. You can get the list from of valid attributes from the type db in ``resources/collectd_cvmfs.db``.

* ``Interval``: interval in seconds to probe the CVMFS repositories.

* ``Verbose``: boolean value to produce logs more verbosed in collectd. It is false by default.

The plugin allows multiple instances for different configurations. This allows probing different repos at different intervals or probing different attributes depending on the repository.

Metrics

-------

The metrics are published in the following structure::

    Plugin: cvmfs

    PluginInstance: 

    Type: {|MountTime|Memory|Mountok}

    # Only with Memory:

    TypeInstance: [rss|vms]

Example::

    lxplus123.cern.ch/cvmfs-lhcb.cern.ch/mounttime values=[0.000999927520751953]

    lxplus123.cern.ch/cvmfs-lhcb.cern.ch/nioerr values=[0]

    lxplus123.cern.ch/cvmfs-lhcb.cern.ch/memory-rss values=[31760384]

    lxplus123.cern.ch/cvmfs-repo.domain.ch/mountok values=[1]