[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[bug#31911] [PATCH] services: Add prometheus-node-exporter-service-type.

From: Ludovic Courtès
Subject: [bug#31911] [PATCH] services: Add prometheus-node-exporter-service-type.
Date: Sat, 23 Jun 2018 23:51:43 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)

Hello Gábor!

Gábor Boskovits <address@hidden> skribis:

> * gnu/services/monitoring.scm (prometheus-node-exporter-service-type):
> New variable.
> (<prometheus-node-exporter-configuration>): New record type.
> (prometheus-node-exporter-shepherd-service): New procedure.
> * gnu/doc/guix.texi (Monitoring Services): Document it.

That’s very useful!  Hopefully we can start using it on our build farm,
though we’ll need Grafena (?) or something to visualize those stats,
right?  OTOH apparently it already provides a web interface, so…?

It would be nice to add a system test for this service.  It could ensure
that representative URLs return 200 or 404, for instance (see the
hpcguix-web test in (gnu tests web) as an example.)


Minor comments:

> address@hidden Prometheus Node Exporter Service

Leave a newline here.

> address@hidden prometheus-node-exporter
> +Prometheus node exporter is a Prometheus exporter. It makes hardware and
> +operating system statistics provided by *NIX kernels available for the

The first sentence looks like a tautology.  :-)
I’m also unconvinced by the “*NIX” notation.

What about:

  The Prometheus ``node exporter'' makes hardware and operating system
  statistics available for the…

Please leave two spaces after end-of-sentence periods.

> address@hidden {Scheme variable} prometheus-node-exporter-service-type

Should be @defvr instead of @defvar.

> address@hidden {Data Type} prometheus-node-exporter-configuration
> +Data type representing the configuration of @command{node_exporter}.
> +
> address@hidden @asis
> address@hidden @code{package} (default: 
> @code{go-github-com-prometheus-node-exporter})
> +The prometheus-node-exporter package to use.
> address@hidden @code{web-listen-address} (default: @code{":9100"})
> +Bind the web interface to the specified address.

Please add a newline before the second @item.

With these changes and ideally a simple test, this is ready to go IMO!


reply via email to

[Prev in Thread] Current Thread [Next in Thread]