ClusterCockpit/cc-metric-collector
1
0
Fork 0
mirror of https://github.com/ClusterCockpit/cc-metric-collector.git synced 2025-10-24 06:45:07 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
9232dd97328a0959484dda99afd1e3d274c0b9b0
cc-metric-collector/receivers
History
Thomas Roehl f74d5dc51a Reuse parser to avoid overhead in NATS receiver
2021-10-08 13:28:44 +02:00
..
metricReceiver.go
Format Receivers
2021-05-18 15:44:42 +02:00
natsReceiver.go
Reuse parser to avoid overhead in NATS receiver
2021-10-08 13:28:44 +02:00
README.md
Add README for receivers
2021-05-18 15:39:22 +02:00

README.md

This folder contains the receivers for the cc-metric-collector.

metricReceiver.go

The base class/configuration is located in metricReceiver.go.

Receivers

  • natsReceiver.go: Receives metrics from the Nats transport system in Influx line protocol encoding. The database name is used as subscription subject for the NATS messages. It uses https://github.com/nats-io/nats.go

Installation

Nothing to do, all receivers are pure Go code

Contributing own receivers

A receiver contains three functions and is derived from the type Receiver (in metricReceiver.go):

  • Init(config ReceiverConfig) error
  • Start() error
  • Close()

The data structures should be set up in Init() like opening a file or server connection. The Start() function should either start a go routine or issue some other asynchronous mechanism for receiving metrics. The Close() function should tear down anything created in Init().

Finally, the receiver needs to be registered in the metric-collector.go. There is a list of receivers called Receivers which is a map (string -> pointer to receiver). Add a new entry with a descriptive name and the new receiver.