mirror of
https://github.com/ClusterCockpit/cc-metric-collector.git
synced 2024-12-25 15:09:05 +01:00
Add sink for Prometheus monitoring system (#46)
* Add sink for Prometheus monitoring system * Add prometheus sink to README
This commit is contained in:
parent
fe3a8d59b0
commit
f099a311a0
@ -10,6 +10,7 @@ This folder contains the SinkManager and sink implementations for the cc-metric-
|
|||||||
- [`nats`](./natsSink.md): Publish metrics to the [NATS](https://nats.io/) network overlay system
|
- [`nats`](./natsSink.md): Publish metrics to the [NATS](https://nats.io/) network overlay system
|
||||||
- [`ganglia`](./gangliaSink.md): Publish metrics in the [Ganglia Monitoring System](http://ganglia.info/) using the `gmetric` CLI tool
|
- [`ganglia`](./gangliaSink.md): Publish metrics in the [Ganglia Monitoring System](http://ganglia.info/) using the `gmetric` CLI tool
|
||||||
- [`libganglia`](./libgangliaSink.md): Publish metrics in the [Ganglia Monitoring System](http://ganglia.info/) directly using `libganglia.so`
|
- [`libganglia`](./libgangliaSink.md): Publish metrics in the [Ganglia Monitoring System](http://ganglia.info/) directly using `libganglia.so`
|
||||||
|
- [`prometeus`](./prometheusSink.md): Publish metrics for the [Prometheus Monitoring System](https://prometheus.io/)
|
||||||
|
|
||||||
# Configuration
|
# Configuration
|
||||||
|
|
||||||
|
199
sinks/prometheusSink.go
Normal file
199
sinks/prometheusSink.go
Normal file
@ -0,0 +1,199 @@
|
|||||||
|
package sinks
|
||||||
|
|
||||||
|
import (
|
||||||
|
"context"
|
||||||
|
"encoding/json"
|
||||||
|
"errors"
|
||||||
|
"fmt"
|
||||||
|
"net/http"
|
||||||
|
"strings"
|
||||||
|
"sync"
|
||||||
|
|
||||||
|
cclog "github.com/ClusterCockpit/cc-metric-collector/internal/ccLogger"
|
||||||
|
lp "github.com/ClusterCockpit/cc-metric-collector/internal/ccMetric"
|
||||||
|
"github.com/gorilla/mux"
|
||||||
|
"github.com/prometheus/client_golang/prometheus"
|
||||||
|
"github.com/prometheus/client_golang/prometheus/promhttp"
|
||||||
|
)
|
||||||
|
|
||||||
|
type PrometheusSinkConfig struct {
|
||||||
|
defaultSinkConfig
|
||||||
|
Host string `json:"host,omitempty"`
|
||||||
|
Port string `json:"port"`
|
||||||
|
Path string `json:"path,omitempty"`
|
||||||
|
GroupAsNameSpace bool `json:"group_as_namespace,omitempty"`
|
||||||
|
// User string `json:"user,omitempty"`
|
||||||
|
// Password string `json:"password,omitempty"`
|
||||||
|
// FlushDelay string `json:"flush_delay,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
type PrometheusSink struct {
|
||||||
|
sink
|
||||||
|
config PrometheusSinkConfig
|
||||||
|
labelMetrics map[string]*prometheus.GaugeVec
|
||||||
|
nodeMetrics map[string]prometheus.Gauge
|
||||||
|
promWg sync.WaitGroup
|
||||||
|
promServer *http.Server
|
||||||
|
}
|
||||||
|
|
||||||
|
func intToFloat64(input interface{}) (float64, error) {
|
||||||
|
switch value := input.(type) {
|
||||||
|
case float64:
|
||||||
|
return value, nil
|
||||||
|
case float32:
|
||||||
|
return float64(value), nil
|
||||||
|
case int:
|
||||||
|
return float64(value), nil
|
||||||
|
case int32:
|
||||||
|
return float64(value), nil
|
||||||
|
case int64:
|
||||||
|
return float64(value), nil
|
||||||
|
}
|
||||||
|
return 0, errors.New("cannot cast value to float64")
|
||||||
|
}
|
||||||
|
|
||||||
|
func getLabelValue(metric lp.CCMetric) []string {
|
||||||
|
labelValues := []string{}
|
||||||
|
if tid, tidok := metric.GetTag("type-id"); tidok && metric.HasTag("type") {
|
||||||
|
labelValues = append(labelValues, tid)
|
||||||
|
}
|
||||||
|
if d, ok := metric.GetTag("device"); ok {
|
||||||
|
labelValues = append(labelValues, d)
|
||||||
|
} else if d, ok := metric.GetMeta("device"); ok {
|
||||||
|
labelValues = append(labelValues, d)
|
||||||
|
}
|
||||||
|
return labelValues
|
||||||
|
}
|
||||||
|
|
||||||
|
func getLabelNames(metric lp.CCMetric) []string {
|
||||||
|
labelNames := []string{}
|
||||||
|
if t, tok := metric.GetTag("type"); tok && metric.HasTag("type-id") {
|
||||||
|
labelNames = append(labelNames, t)
|
||||||
|
}
|
||||||
|
if _, ok := metric.GetTag("device"); ok {
|
||||||
|
labelNames = append(labelNames, "device")
|
||||||
|
} else if _, ok := metric.GetMeta("device"); ok {
|
||||||
|
labelNames = append(labelNames, "device")
|
||||||
|
}
|
||||||
|
return labelNames
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *PrometheusSink) newMetric(metric lp.CCMetric) error {
|
||||||
|
var value float64 = 0
|
||||||
|
name := metric.Name()
|
||||||
|
opts := prometheus.GaugeOpts{
|
||||||
|
Name: name,
|
||||||
|
}
|
||||||
|
labels := getLabelNames(metric)
|
||||||
|
labelValues := getLabelValue(metric)
|
||||||
|
if len(labels) > 0 && len(labels) != len(labelValues) {
|
||||||
|
return fmt.Errorf("cannot detect metric labels for metric %s", name)
|
||||||
|
}
|
||||||
|
|
||||||
|
if metricValue, ok := metric.GetField("value"); ok {
|
||||||
|
if floatValue, err := intToFloat64(metricValue); err == nil {
|
||||||
|
value = floatValue
|
||||||
|
} else {
|
||||||
|
return fmt.Errorf("metric %s with value '%v' cannot be casted to float64", name, metricValue)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if s.config.GroupAsNameSpace && metric.HasMeta("group") {
|
||||||
|
g, _ := metric.GetMeta("group")
|
||||||
|
opts.Namespace = strings.ToLower(g)
|
||||||
|
}
|
||||||
|
|
||||||
|
if len(labels) > 0 {
|
||||||
|
new := prometheus.NewGaugeVec(opts, labels)
|
||||||
|
new.WithLabelValues(labelValues...).Set(value)
|
||||||
|
s.labelMetrics[name] = new
|
||||||
|
prometheus.Register(new)
|
||||||
|
} else {
|
||||||
|
new := prometheus.NewGauge(opts)
|
||||||
|
new.Set(value)
|
||||||
|
s.nodeMetrics[name] = new
|
||||||
|
prometheus.Register(new)
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *PrometheusSink) updateMetric(metric lp.CCMetric) error {
|
||||||
|
var value float64 = 0.0
|
||||||
|
name := metric.Name()
|
||||||
|
labelValues := getLabelValue(metric)
|
||||||
|
|
||||||
|
if metricValue, ok := metric.GetField("value"); ok {
|
||||||
|
if floatValue, err := intToFloat64(metricValue); err == nil {
|
||||||
|
value = floatValue
|
||||||
|
} else {
|
||||||
|
return fmt.Errorf("metric %s with value '%v' cannot be casted to float64", name, metricValue)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if len(labelValues) > 0 {
|
||||||
|
if _, ok := s.labelMetrics[name]; !ok {
|
||||||
|
err := s.newMetric(metric)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
}
|
||||||
|
s.labelMetrics[name].WithLabelValues(labelValues...).Set(value)
|
||||||
|
} else {
|
||||||
|
if _, ok := s.labelMetrics[name]; !ok {
|
||||||
|
err := s.newMetric(metric)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
}
|
||||||
|
s.nodeMetrics[name].Set(value)
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *PrometheusSink) Write(m lp.CCMetric) error {
|
||||||
|
return s.updateMetric(m)
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *PrometheusSink) Flush() error {
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *PrometheusSink) Close() {
|
||||||
|
cclog.ComponentDebug(s.name, "CLOSE")
|
||||||
|
s.promServer.Shutdown(context.Background())
|
||||||
|
s.promWg.Wait()
|
||||||
|
}
|
||||||
|
|
||||||
|
func NewPrometheusSink(name string, config json.RawMessage) (Sink, error) {
|
||||||
|
s := new(PrometheusSink)
|
||||||
|
s.name = "PrometheusSink"
|
||||||
|
if len(config) > 0 {
|
||||||
|
err := json.Unmarshal(config, &s.config)
|
||||||
|
if err != nil {
|
||||||
|
cclog.ComponentError(s.name, "Error reading config for", s.name, ":", err.Error())
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if len(s.config.Port) == 0 {
|
||||||
|
err := errors.New("not all configuration variables set required by PrometheusSink")
|
||||||
|
cclog.ComponentError(s.name, err.Error())
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
s.labelMetrics = make(map[string]*prometheus.GaugeVec)
|
||||||
|
s.nodeMetrics = make(map[string]prometheus.Gauge)
|
||||||
|
s.promWg.Add(1)
|
||||||
|
go func() {
|
||||||
|
router := mux.NewRouter()
|
||||||
|
// Prometheus endpoint
|
||||||
|
router.Path("/" + s.config.Path).Handler(promhttp.Handler())
|
||||||
|
|
||||||
|
url := fmt.Sprintf("%s:%s", s.config.Host, s.config.Port)
|
||||||
|
cclog.ComponentDebug(s.name, "Serving Prometheus metrics at", fmt.Sprintf("%s:%s/%s", s.config.Host, s.config.Port, s.config.Path))
|
||||||
|
s.promServer = &http.Server{Addr: url, Handler: router}
|
||||||
|
err := s.promServer.ListenAndServe()
|
||||||
|
if err != nil && err.Error() != "http: Server closed" {
|
||||||
|
cclog.ComponentError(s.name, err.Error())
|
||||||
|
}
|
||||||
|
s.promWg.Done()
|
||||||
|
}()
|
||||||
|
return s, nil
|
||||||
|
}
|
23
sinks/prometheusSink.md
Normal file
23
sinks/prometheusSink.md
Normal file
@ -0,0 +1,23 @@
|
|||||||
|
## `prometheus` sink
|
||||||
|
|
||||||
|
The `prometheus` sink publishes all metrics via an HTTP server ready to be scraped by a [Prometheus](https://prometheus.io) server. It creates gauge metrics for all node metrics and gauge vectors for all metrics with a subtype like 'device', 'cpu' or 'socket'.
|
||||||
|
|
||||||
|
|
||||||
|
### Configuration structure
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"<name>": {
|
||||||
|
"type": "prometheus",
|
||||||
|
"host": "localhost",
|
||||||
|
"port": "8080",
|
||||||
|
"path": "metrics"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- `type`: makes the sink an `prometheus` sink
|
||||||
|
- `host`: The HTTP server gets bound to that IP/hostname
|
||||||
|
- `port`: Portnumber (as string) for the HTTP server
|
||||||
|
- `path`: Path where the metrics should be servered. The metrics will be published at `host`:`port`/`path`
|
||||||
|
- `group_as_namespace`: Most metrics contain a group as meta information like 'memory', 'load'. With this the metric names are extended to `group`_`name` if possible.
|
Loading…
Reference in New Issue
Block a user