freebsd-dev/share/man
Ed Schouten 1e1f3941e4 Add support for attaching aggregation labels to sysctl objects.
I'm currently working on writing a metrics exporter for the Prometheus
monitoring system to provide access to sysctl metrics. Prometheus and
sysctl have some structural differences:

- sysctl is a tree of string component names.
- Prometheus uses a flat namespace for its metrics, but allows you to
  attach labels with values to them, so that you can do aggregation.

An initial version of my exporter simply translated

    hw.acpi.thermal.tz1.temperature

to

    sysctl_hw_acpi_thermal_tz1_temperature_celcius

while we should ideally have

    sysctl_hw_acpi_thermal_temperature_celcius{thermal_zone="tz1"}

allowing you to graph all thermal zones on a system in one go.

The change presented in this commit adds support for accomplishing this,
by providing the ability to attach labels to nodes. In the example I
gave above, the label "thermal_zone" would be attached to "tz1". As this
is a feature that will only be used very rarely, I decided to not change
the KPI too aggressively.

Discussed on:	hackers@
Reviewed by:	cem
Differential Revision:	https://reviews.freebsd.org/D8775
2016-12-14 12:47:34 +00:00
..
man1 Separate manual pages into their own package. 2016-01-21 16:36:33 +00:00
man3 thr_set_name(): silently truncate the given name as needed 2016-12-03 01:14:21 +00:00
man4 rsu(4): refresh the manpage. 2016-12-10 19:14:51 +00:00
man5 Add support for encrypted kernel crash dumps. 2016-12-10 16:20:39 +00:00
man6 Separate manual pages into their own package. 2016-01-21 16:36:33 +00:00
man7 o Add support for long double. 2016-11-03 13:06:17 +00:00
man8 Remove backup_uses_rcs from rc.subr 2016-09-18 12:49:23 +00:00
man9 Add support for attaching aggregation labels to sysctl objects. 2016-12-14 12:47:34 +00:00
Makefile Add more SUBDIR_PARALLEL. 2015-10-15 22:55:08 +00:00