GATHERD.CONF(5)

📦
version 2.2.9 · 2 versions
, in fedora 43

💖 GATHERD.CONF(5) 💖

okay bestie, so this is the manual page for gatherd.conf — the SBLIM metric repository daemon configuration file — and honestly? it's giving "small file, big power". the manual name up top is GATHERD.CONF(5), in case you were wondering what you're reading. let's get into it ✨

🌸 NAME 🌸

gatherd.conf — the SBLIM metric repository daemon configuration file. yes queen, it configures the daemon that holds all the metrics. iconic behavior.

🦋 DESCRIPTION 🦋

so gatherd(8) reads the file gatherd.conf when it starts up. every single line is a configuration option value pair — option, then value, split by an = character. and if you see a # (that's a number sign, babes), that's the start of a comment. anything after it is just vibes, no effect.

✨ OPTIONS ✨

okay here's the whole menu, no skipping, we eat every bite:

  • RepositoryHost=addr — the IP address of the remote repository daemon where all your metric values get sent. default is localhost (home sweet home).
  • RepositoryPort=port — the TCP port of that remote repository daemon. default is 6363.
  • TraceLevel=level — how much tracing the gatherd process does. default is 0 (chill, no drama).
  • TraceFile=file — the name of the file where tracing info gets written. default is stderr.
  • TraceComponents=comps[:comps...] — which gatherer components get traced, separated by a colon (:). the valid components are: comm, util, gather, rrepos. default is none — no one's being watched.
  • PluginDirectory=dir — the directory where the metric collection plugins live. default is /usr/lib/gather/mplug (or /usr/lib64/gather/mplug on 64-bit, slay).
  • AutoLoad=plugin[:plugin...] — plugins to automatically load, initialize and start sampling. valid values are * or a colon-separated list. default is none.
  • SampleInterval=secs — if you set this, the interval overrides each plugin's own individual sampling intervals. the unit is seconds.
⚠️ WARNING, bestie, listen to me: this config option should only be used for debugging purposes. it overrides the per-metric sample interval of all the plugins, and really short intervals can introduce skew in the data because seconds just aren't a high enough sample resolution. fr fr, don't be reckless with this one. 💀
  • Synchronization=0|1 — says whether the metric plugins get invoked in a time-synchronized way. synchronized metrics that share the same sample interval will be scheduled together. possible values are:
    1. 1 — synchronized relative to Jan, 1st, 1970, 00:00
    2. 0 — unsynchronized, will be scheduled asap

default is 1.

🫶 BUGS 🫶

the SBLIM project keeps a mailing list, and that's where you should send all your questions about sfc b, sfcc, wbemcli, the metric data gatherer, or any of the SBLIM providers. to subscribe, go here:

https://lists.sourceforge.net/lists/listinfo/sblim-issues

and if you find actual bugs, please report them to the bug tracker. the SBLIM project bug tracking page lives at:

https://sourceforge.net/tracker/?group_id=128809&atid=712784

👑 AUTHORS 👑

please refer to the AUTHORS file distributed with sblim-gather. the receipts are all in there.

Copyright © 2003-2012 IBM Corp.

🌈 LICENSE 🌈

gatherd.conf is distributed under the terms of the Eclipse Public License (the "Agreement"). any use, reproduction or distribution of this program constitutes recipients acceptance of the agreement.

you can grab a current copy of the Eclipse Public License from:

http://www.opensource.org/licenses/eclipse-1.0.php

🎀 SEE ALSO 🎀

and that's the whole thing, no cap 💅 this page is from sblim-gather-2.2.9, dated 07/25/2025 — so if you ever need to cite your sources, there they are. now go forth and configure, main character 🦋✨

📦 where this page comes from