firehol/netdata

View on GitHub
src/go/plugin/go.d/modules/ping/ping.go

Summary

Maintainability
A
40 mins
Test Coverage
// SPDX-License-Identifier: GPL-3.0-or-later

package ping

import (
    _ "embed"
    "errors"
    "time"

    "github.com/netdata/netdata/go/plugins/logger"
    "github.com/netdata/netdata/go/plugins/plugin/go.d/agent/module"
    "github.com/netdata/netdata/go/plugins/plugin/go.d/pkg/confopt"

    probing "github.com/prometheus-community/pro-bing"
)

//go:embed "config_schema.json"
var configSchema string

func init() {
    module.Register("ping", module.Creator{
        JobConfigSchema: configSchema,
        Defaults: module.Defaults{
            UpdateEvery: 5,
        },
        Create: func() module.Module { return New() },
        Config: func() any { return &Config{} },
    })
}

func New() *Ping {
    return &Ping{
        Config: Config{
            Network:     "ip",
            Privileged:  true,
            SendPackets: 5,
            Interval:    confopt.Duration(time.Millisecond * 100),
        },

        charts:    &module.Charts{},
        hosts:     make(map[string]bool),
        newProber: newPingProber,
    }
}

type Config struct {
    UpdateEvery int              `yaml:"update_every,omitempty" json:"update_every"`
    Hosts       []string         `yaml:"hosts" json:"hosts"`
    Network     string           `yaml:"network,omitempty" json:"network"`
    Privileged  bool             `yaml:"privileged" json:"privileged"`
    SendPackets int              `yaml:"packets,omitempty" json:"packets"`
    Interval    confopt.Duration `yaml:"interval,omitempty" json:"interval"`
    Interface   string           `yaml:"interface,omitempty" json:"interface"`
}

type (
    Ping struct {
        module.Base
        Config `yaml:",inline" json:""`

        charts *module.Charts

        prober    prober
        newProber func(pingProberConfig, *logger.Logger) prober

        hosts map[string]bool
    }
    prober interface {
        ping(host string) (*probing.Statistics, error)
    }
)

func (p *Ping) Configuration() any {
    return p.Config
}

func (p *Ping) Init() error {
    err := p.validateConfig()
    if err != nil {
        p.Errorf("config validation: %v", err)
        return err
    }

    pr, err := p.initProber()
    if err != nil {
        p.Errorf("init prober: %v", err)
        return err
    }
    p.prober = pr

    return nil
}

func (p *Ping) Check() error {
    mx, err := p.collect()
    if err != nil {
        return err
    }
    if len(mx) == 0 {
        return errors.New("no metrics collected")

    }
    return nil
}

func (p *Ping) Charts() *module.Charts {
    return p.charts
}

func (p *Ping) Collect() map[string]int64 {
    mx, err := p.collect()
    if err != nil {
        p.Error(err)
    }

    if len(mx) == 0 {
        return nil
    }
    return mx
}

func (p *Ping) Cleanup() {}