CDIST-TYPE__PROMETHEUS_EXPORTER(7)

✨ cdist-type__prometheus_exporter ✨

okay bestie, gather round, because this is the cdist manual page for cdist-type__prometheus_exporter (section 7, we're fancy like that) and it's literally about making your servers spill their little metrics secrets to Prometheus πŸ’…


🌸 NAME 🌸

cdist-type__prometheus_exporter β€” install some Prometheus exporters, no cap πŸŽ€


πŸ¦‹ DESCRIPTION πŸ¦‹

So what this type does is install and configure some exporters so your Prometheus monitoring setup (that's https://prometheus.io/ btw, go look at it, it's iconic) can actually see what's going on. πŸ‘‘

Here's the tea: this type creates a daemontools-compatible service directory right under /service/$__object_id. Which means… daemontools (or something compatible with it) has to already be installed, okay? And specifically, the command svc must be executable β€” like, non-negotiable. If it's not, this whole thing is giving nothing. πŸ’€

Also!! This type installs and builds the latest version straight from git, using go get. So you need a recent version of golang hanging around, plus build tools (make, g++, etc.). Yes bestie, actual compiler energy. πŸ”₯

Currently supported exporters, in a cute little list:

  • node
  • blackbox
  • ceph

πŸ’– REQUIRED PARAMETERS πŸ’–

None. Nothing. Zero. Zilch. You're free, you're unburdened, it's giving main character with no homework. 🫢


✨ OPTIONAL PARAMETERS ✨

  • exporter β€” which exporter you want installed and configured. Default is $__object_id (she's self-referential like that πŸ™ˆ). Currently supported: node, blackbox, ceph.

πŸŽ€ BOOLEAN PARAMETERS πŸŽ€

  • add-consul-service β€” adds this exporter as a Consul service so you get automatic service discovery. Set it and forget it, automatic bestie behaviour. 🌈

⭐ EXAMPLES ⭐

okay here's the whole vibe, verbatim, don't @ me:

__daemontools
__golang_from_vendor --version 1.9  # required for prometheus and many exporters

require="__daemontools __golang_from_vendor" __prometheus_exporter node

see how __golang_from_vendor --version 1.9 is marked as required for prometheus and many exporters? yeah. heed that. πŸ“Œ


πŸ”₯ SEE ALSO πŸ”₯

go read them, iykyk 🧚


πŸ’œ AUTHORS πŸ’œ

Kamila SoučkovΓ‘ <kamila--@--ksp.sk> β€” absolute legend, we stan 🫢


πŸ‘‘ COPYING πŸ‘‘

Copyright (C) 2017 Kamila SoučkovΓ‘. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. fr fr, that's the license, respect it. πŸ’…


ungleich GmbH 2021


and that's the whole page bestie!! this one's version 7.0.0, dated Jul 31, 202 (the footer got its little number cut off mid-sentence, but that's literally what it says 😭), and it came to you courtesy of the cdist crew. mwah, go monitor something πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from