Files
akvorado/outlet/flow/decoder/sflow/root.go

122 lines
3.4 KiB
Go

// SPDX-FileCopyrightText: 2022 Tchadel Icard
// SPDX-License-Identifier: AGPL-3.0-only
// Package sflow handles sFlow v5 decoding.
package sflow
import (
"bytes"
"fmt"
"net"
"time"
"github.com/netsampler/goflow2/v2/decoders/sflow"
"akvorado/common/reporter"
"akvorado/common/schema"
"akvorado/outlet/flow/decoder"
)
// Decoder contains the state for the sFlow v5 decoder.
type Decoder struct {
r *reporter.Reporter
d decoder.Dependencies
errLogger reporter.Logger
metrics struct {
errors *reporter.CounterVec
stats *reporter.CounterVec
sampleRecordsStatsSum *reporter.CounterVec
sampleStatsSum *reporter.CounterVec
}
}
// New instantiates a new sFlow decoder.
func New(r *reporter.Reporter, dependencies decoder.Dependencies) decoder.Decoder {
nd := &Decoder{
r: r,
d: dependencies,
errLogger: r.Sample(reporter.BurstSampler(30*time.Second, 3)),
}
nd.metrics.errors = nd.r.CounterVec(
reporter.CounterOpts{
Name: "errors_total",
Help: "sFlows processed errors.",
},
[]string{"exporter", "error"},
)
nd.metrics.stats = nd.r.CounterVec(
reporter.CounterOpts{
Name: "flows_total",
Help: "sFlows processed.",
},
[]string{"exporter", "agent", "version"},
)
nd.metrics.sampleRecordsStatsSum = nd.r.CounterVec(
reporter.CounterOpts{
Name: "sample_records_sum",
Help: "sFlows samples sum of records.",
},
[]string{"exporter", "agent", "version", "type"},
)
nd.metrics.sampleStatsSum = nd.r.CounterVec(
reporter.CounterOpts{
Name: "sample_sum",
Help: "sFlows samples sum.",
},
[]string{"exporter", "agent", "version", "type"},
)
return nd
}
// Decode decodes an sFlow payload.
func (nd *Decoder) Decode(in decoder.RawFlow, _ decoder.Option, bf *schema.FlowMessage, finalize decoder.FinalizeFlowFunc) (int, error) {
buf := bytes.NewBuffer(in.Payload)
key := in.Source.String()
ts := uint64(in.TimeReceived.UTC().Unix())
var packet sflow.Packet
if err := sflow.DecodeMessageVersion(buf, &packet); err != nil {
nd.metrics.errors.WithLabelValues(key, "sFlow decoding error").Inc()
nd.errLogger.Err(err).Str("exporter", key).Msg("error while decoding sFlow")
return 0, fmt.Errorf("error while decoding sFlow: %w", err)
}
// Update some stats
agent := net.IP(packet.AgentIP).String()
version := "5"
samples := packet.Samples
nd.metrics.stats.WithLabelValues(key, agent, version).Inc()
for _, s := range samples {
switch sConv := s.(type) {
case sflow.FlowSample:
nd.metrics.sampleStatsSum.WithLabelValues(key, agent, version, "FlowSample").
Inc()
nd.metrics.sampleRecordsStatsSum.WithLabelValues(key, agent, version, "FlowSample").
Add(float64(len(sConv.Records)))
case sflow.ExpandedFlowSample:
nd.metrics.sampleStatsSum.WithLabelValues(key, agent, version, "ExpandedFlowSample").
Inc()
nd.metrics.sampleRecordsStatsSum.WithLabelValues(key, agent, version, "ExpandedFlowSample").
Add(float64(len(sConv.Records)))
case sflow.CounterSample:
nd.metrics.sampleStatsSum.WithLabelValues(key, agent, version, "CounterSample").
Inc()
nd.metrics.sampleRecordsStatsSum.WithLabelValues(key, agent, version, "CounterSample").
Add(float64(len(sConv.Records)))
}
}
return len(samples), nd.decode(packet, bf, func() {
bf.TimeReceived = uint32(ts)
finalize()
})
}
// Name returns the name of the decoder.
func (nd *Decoder) Name() string {
return "sflow"
}