-
Notifications
You must be signed in to change notification settings - Fork 140
/
function.go
108 lines (92 loc) · 3.15 KB
/
function.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
package percentileOfSeries
import (
"context"
"github.com/go-graphite/carbonapi/expr/consolidations"
fconfig "github.com/go-graphite/carbonapi/expr/functions/config"
"github.com/go-graphite/carbonapi/expr/helper"
"github.com/go-graphite/carbonapi/expr/interfaces"
"github.com/go-graphite/carbonapi/expr/types"
"github.com/go-graphite/carbonapi/pkg/parser"
)
type Config struct {
ExtractTagsFromArgs bool
}
type percentileOfSeries struct {
interfaces.FunctionBase
extractTagsFromArgs bool
}
func GetOrder() interfaces.Order {
return interfaces.Any
}
func New(configFile string) []interfaces.FunctionMetadata {
res := make([]interfaces.FunctionMetadata, 0)
f := &percentileOfSeries{}
functions := []string{"percentileOfSeries"}
for _, n := range functions {
res = append(res, interfaces.FunctionMetadata{Name: n, F: f})
}
return res
}
// percentileOfSeries(seriesList, n, interpolate=False)
func (f *percentileOfSeries) Do(ctx context.Context, e parser.Expr, from, until int64, values map[parser.MetricRequest][]*types.MetricData) ([]*types.MetricData, error) {
// TODO(dgryski): make sure the arrays are all the same 'size'
if e.ArgsLen() < 2 {
return nil, parser.ErrMissingArgument
}
args, err := helper.GetSeriesArg(ctx, e.Arg(0), from, until, values)
if err != nil {
return nil, err
}
if len(args) == 0 {
return []*types.MetricData{}, nil
}
percent, err := e.GetFloatArg(1)
if err != nil {
return nil, err
}
interpolate, err := e.GetBoolNamedOrPosArgDefault("interpolate", 2, false)
if err != nil {
return nil, err
}
xFilesFactor := args[0].XFilesFactor
return helper.AggregateSeries(e, args, func(values []float64) float64 {
return consolidations.Percentile(values, percent, interpolate)
}, float64(xFilesFactor), fconfig.Config.ExtractTagsFromArgs)
}
// SetExtractTagsFromArgs for use in tests
func (f *percentileOfSeries) SetExtractTagsFromArgs(e bool) {
f.extractTagsFromArgs = e
}
// Description is auto-generated description, based on output of https://github.com/graphite-project/graphite-web
func (f *percentileOfSeries) Description() map[string]types.FunctionDescription {
return map[string]types.FunctionDescription{
"percentileOfSeries": {
Description: "percentileOfSeries returns a single series which is composed of the n-percentile\nvalues taken across a wildcard series at each point. Unless `interpolate` is\nset to True, percentile values are actual values contained in one of the\nsupplied series.",
Function: "percentileOfSeries(seriesList, n, interpolate=False)",
Group: "Combine",
Module: "graphite.render.functions",
Name: "percentileOfSeries",
Params: []types.FunctionParam{
{
Name: "seriesList",
Required: true,
Type: types.SeriesList,
},
{
Name: "n",
Required: true,
Type: types.Integer,
},
{
Default: types.NewSuggestion(false),
Name: "interpolate",
Type: types.Boolean,
},
},
SeriesChange: true, // function aggregate metrics or change series items count
NameChange: true, // name changed
TagsChange: true, // name tag changed
ValuesChange: true, // values changed
},
}
}