mirror of
				https://github.com/ClusterCockpit/cc-metric-collector.git
				synced 2025-11-04 02:35:07 +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:
		@@ -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
 | 
			
		||||
- [`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`
 | 
			
		||||
- [`prometeus`](./prometheusSink.md): Publish metrics for the [Prometheus Monitoring System](https://prometheus.io/)
 | 
			
		||||
 | 
			
		||||
# 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.
 | 
			
		||||
		Reference in New Issue
	
	Block a user