107 lines
2.4 KiB
Go
107 lines
2.4 KiB
Go
// Package `perfdata` provides representations for a monitoring plugin's
|
|
// performance data.
|
|
package perfdata // import nocternity.net/gomonop/pkg/perfdata
|
|
|
|
import (
|
|
"strings"
|
|
)
|
|
|
|
// Performance data, including a label, units, a value, warning/critical
|
|
// ranges and min/max boundaries.
|
|
type PerfData struct {
|
|
Label string
|
|
units UnitOfMeasurement
|
|
bits perfDataBits
|
|
value string
|
|
warn, crit Range
|
|
min, max string
|
|
}
|
|
|
|
// Create performance data using the specified label and units.
|
|
func New(label string, units UnitOfMeasurement, value string) *PerfData {
|
|
if value != "" && !valueCheck.MatchString(value) {
|
|
panic("invalid value")
|
|
}
|
|
pdRange := &PerfData{}
|
|
pdRange.Label = label
|
|
pdRange.units = units
|
|
if value == "" {
|
|
pdRange.value = "U"
|
|
} else {
|
|
pdRange.value = value
|
|
}
|
|
return pdRange
|
|
}
|
|
|
|
// Set the warning range for the performance data record.
|
|
func (d *PerfData) SetWarn(r *Range) {
|
|
if r == nil {
|
|
d.bits &^= PDatWarn
|
|
} else {
|
|
d.warn = *r
|
|
d.bits |= PDatWarn
|
|
}
|
|
}
|
|
|
|
// Set the critical range for the performance data record.
|
|
func (d *PerfData) SetCrit(r *Range) {
|
|
if r == nil {
|
|
d.bits &^= PDatCrit
|
|
} else {
|
|
d.crit = *r
|
|
d.bits |= PDatCrit
|
|
}
|
|
}
|
|
|
|
// Set the performance data's minimal value.
|
|
func (d *PerfData) SetMin(min string) {
|
|
if !valueCheck.MatchString(min) {
|
|
panic("invalid value")
|
|
}
|
|
d.min = min
|
|
d.bits |= PDatMin
|
|
}
|
|
|
|
// Set the performance data's maximal value.
|
|
func (d *PerfData) SetMax(max string) {
|
|
if !valueCheck.MatchString(max) {
|
|
panic("invalid value")
|
|
}
|
|
d.max = max
|
|
d.bits |= PDatMax
|
|
}
|
|
|
|
// Converts performance data to a string which may be read by the monitoring
|
|
// system.
|
|
func (d *PerfData) String() string {
|
|
var strBuilder strings.Builder
|
|
needsQuotes := strings.ContainsAny(d.Label, " '=\"")
|
|
if needsQuotes {
|
|
strBuilder.WriteRune('\'')
|
|
}
|
|
strBuilder.WriteString(strings.ReplaceAll(d.Label, "'", "''"))
|
|
if needsQuotes {
|
|
strBuilder.WriteRune('\'')
|
|
}
|
|
strBuilder.WriteRune('=')
|
|
strBuilder.WriteString(d.value)
|
|
strBuilder.WriteString(d.units.String())
|
|
strBuilder.WriteRune(';')
|
|
if d.bits&PDatWarn != 0 {
|
|
strBuilder.WriteString(d.warn.String())
|
|
}
|
|
strBuilder.WriteRune(';')
|
|
if d.bits&PDatCrit != 0 {
|
|
strBuilder.WriteString(d.crit.String())
|
|
}
|
|
strBuilder.WriteRune(';')
|
|
if d.bits&PDatMin != 0 {
|
|
strBuilder.WriteString(d.min)
|
|
}
|
|
strBuilder.WriteRune(';')
|
|
if d.bits&PDatMax != 0 {
|
|
strBuilder.WriteString(d.max)
|
|
}
|
|
|
|
return strBuilder.String()
|
|
}
|