-
Notifications
You must be signed in to change notification settings - Fork 24
/
promql.go
399 lines (346 loc) · 12.3 KB
/
promql.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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
package promql
import (
"context"
"errors"
"fmt"
"math"
"sync"
"time"
prometheusv1 "github.com/prometheus/client_golang/api/prometheus/v1"
prometheusmodel "github.com/prometheus/common/model"
"go.uber.org/fx"
"google.golang.org/protobuf/proto"
"google.golang.org/protobuf/types/known/durationpb"
"google.golang.org/protobuf/types/known/wrapperspb"
policylangv1 "github.com/fluxninja/aperture/v2/api/gen/proto/go/aperture/policy/language/v1"
"github.com/fluxninja/aperture/v2/pkg/config"
"github.com/fluxninja/aperture/v2/pkg/jobs"
"github.com/fluxninja/aperture/v2/pkg/notifiers"
"github.com/fluxninja/aperture/v2/pkg/policies/controlplane/iface"
"github.com/fluxninja/aperture/v2/pkg/policies/controlplane/runtime"
"github.com/fluxninja/aperture/v2/pkg/prometheus"
"github.com/fluxninja/aperture/v2/pkg/status"
)
// ErrNoQueriesReturned is returned when no queries are returned by the policy (initial state).
var ErrNoQueriesReturned = errors.New("no queries returned until now")
const (
promTimeout = time.Second * 5
)
// Module returns fx options for PromQL in the main app.
func Module() fx.Option {
return fx.Options(
fx.Provide(fx.Annotate(
provideFxOptionsFunc,
fx.ResultTags(iface.FxOptionsFuncTag),
)),
)
}
func provideFxOptionsFunc(promAPI prometheusv1.API, enforcer *prometheus.PrometheusEnforcer) notifiers.FxOptionsFunc {
return func(key notifiers.Key, _ config.Unmarshaller, _ status.Registry) (fx.Option, error) {
return fx.Supply(fx.Annotate(promAPI, fx.As(new(prometheusv1.API))),
fx.Annotate(enforcer, fx.As(new(*prometheus.PrometheusEnforcer))),
), nil
}
}
type scalarResultCallback func(float64, error)
type promResultCallback func(prometheusmodel.Value, error)
type scalarResultBroker struct {
job jobs.Job
err error
cb scalarResultCallback
query string
// lock to protect concurrent access to the result
lock sync.RWMutex
res float64
}
// Make sure scalarResultBroker complies with the jobResultBroker interface.
var _ runtime.BackgroundJob = (*scalarResultBroker)(nil)
// GetJob implements runtime.BackgroundJob.GetJob.
func (srb *scalarResultBroker) GetJob() jobs.Job {
return srb.job
}
// NotifyCompletion implements runtime.BackgroundJob.NotifyCompletion.
func (srb *scalarResultBroker) NotifyCompletion() {
srb.lock.RLock()
defer srb.lock.RUnlock()
srb.cb(srb.res, srb.err)
}
func (srb *scalarResultBroker) handleResult(_ context.Context, value float64, cbArgs ...interface{}) (proto.Message, error) {
srb.lock.Lock()
defer srb.lock.Unlock()
srb.res = value
srb.err = nil
return wrapperspb.Double(value), nil
}
func (srb *scalarResultBroker) handleError(err error, cbArgs ...interface{}) (proto.Message, error) {
srb.lock.Lock()
defer srb.lock.Unlock()
srb.res = math.NaN()
srb.err = err
return nil, errors.New("invalid ScalarResult, error in prometheus query")
}
type taggedResultBroker struct {
job jobs.Job
res prometheusmodel.Value
err error
cb promResultCallback
query string
// lock to protect concurrent access to the result
lock sync.RWMutex
}
// Make sure promResultBroker complies with the jobResultBroker interface.
var _ runtime.BackgroundJob = (*taggedResultBroker)(nil)
// GetJob implements runtime.Job.GetJob.
func (trb *taggedResultBroker) GetJob() jobs.Job {
return trb.job
}
// NotifyCompletion implements runtime.BackgroundJob.NotifyCompletion.
func (trb *taggedResultBroker) NotifyCompletion() {
trb.lock.RLock()
defer trb.lock.RUnlock()
trb.cb(trb.res, trb.err)
}
func (trb *taggedResultBroker) handleResult(_ context.Context, value prometheusmodel.Value, cbArgs ...interface{}) (proto.Message, error) {
trb.lock.Lock()
defer trb.lock.Unlock()
trb.res = value
trb.err = nil
return nil, nil
}
func (trb *taggedResultBroker) handleError(err error, cbArgs ...interface{}) (proto.Message, error) {
trb.lock.Lock()
defer trb.lock.Unlock()
trb.err = err
trb.res = nil
return nil, errors.New("invalid taggedResult, error in prometheus query")
}
// Job Register can determine the type of job to register.
type queryScheduerIfc interface {
scheduleQuery(endTimestamp time.Time, circuitAPI runtime.CircuitAPI)
}
// PromQL is a component that runs a Prometheus query in the background and returns the result as a signal Reading.
type PromQL struct {
// Prometheus API
promAPI prometheusv1.API
// Prometheus Labels Enforcer
enforcer *prometheus.PrometheusEnforcer
// Policy read API
policyReadAPI iface.Policy
// Current error
err error
// Query Scheduler used to scheduler Prometheus query jobs. Determines the type of job to register.
queryScheduler queryScheduerIfc
// Job name for the query
jobName string
// The query to run
queryString string
// Component index
componentID string
// Execute the query every ticksPerExecution ticks
ticksPerExecution int
// Current value
value float64
// Interval of time between evaluations
evaluationInterval time.Duration
}
// Name implements runtime.Component.
func (*PromQL) Name() string { return "PromQL" }
// Type implements runtime.Component.
func (*PromQL) Type() runtime.ComponentType { return runtime.ComponentTypeSource }
// ShortDescription implements runtime.Component.
func (promQL *PromQL) ShortDescription() string {
return fmt.Sprintf("every %s", promQL.evaluationInterval)
}
// IsActuator implements runtime.Component.
func (*PromQL) IsActuator() bool { return false }
var _ runtime.Component = (*PromQL)(nil)
// Make sure PromQL implements querySchedulerIfc.
var _ queryScheduerIfc = (*PromQL)(nil)
// NewPromQLAndOptions creates PromQL and its fx options.
func NewPromQLAndOptions(
promQLProto *policylangv1.PromQL,
componentID runtime.ComponentID,
policyReadAPI iface.Policy,
) (*PromQL, fx.Option, error) {
promQLEvaluationInterval := promQLProto.EvaluationInterval.AsDuration()
circuitEvaluationInterval := policyReadAPI.GetEvaluationInterval()
ticksPerExecution := int(math.Ceil(float64(promQLEvaluationInterval) / float64(circuitEvaluationInterval)))
promQL := &PromQL{
ticksPerExecution: ticksPerExecution,
policyReadAPI: policyReadAPI,
componentID: componentID.String(),
// Set err to make sure the initial runs of Execute return Invalid readings.
err: ErrNoQueriesReturned,
}
// Job register is implemented by self
promQL.queryScheduler = promQL
// Job name
promQL.jobName = fmt.Sprintf("Component-%s", promQL.componentID)
// Resolve metric names in PromQL to get the query string
promQL.queryString = promQLProto.GetQueryString()
// Invoke setup in the Policy app startup via fx.Options
options := fx.Options(
fx.Invoke(
promQL.setup,
),
)
return promQL, options, nil
}
func (promQL *PromQL) setup(promAPI prometheusv1.API, enforcer *prometheus.PrometheusEnforcer) error {
promQL.promAPI = promAPI
promQL.enforcer = enforcer
return nil
}
// Execute implements runtime.Component.Execute.
func (promQL *PromQL) Execute(inPortReadings runtime.PortToReading,
circuitAPI runtime.CircuitAPI,
) (outPortReadings runtime.PortToReading, err error) {
tickInfo := circuitAPI.GetTickInfo()
endTimestamp := tickInfo.Timestamp().Truncate(tickInfo.Interval())
promQL.scheduleQuery(endTimestamp, circuitAPI)
// Create current reading based on err and value
var currentReading runtime.Reading
if promQL.err != nil {
currentReading = runtime.InvalidReading()
} else {
currentReading = runtime.NewReading(promQL.value)
}
return runtime.PortToReading{
"output": []runtime.Reading{currentReading},
}, nil
}
// DynamicConfigUpdate is a no-op for PromQL.
func (promQL *PromQL) DynamicConfigUpdate(event notifiers.Event, unmarshaller config.Unmarshaller) {}
func (promQL *PromQL) scheduleQuery(endTimestamp time.Time, circuitAPI runtime.CircuitAPI) {
jobName := promQL.jobName
query := promQL.queryString
promAPI := promQL.promAPI
enforcer := promQL.enforcer
cb := promQL.onScalarResult
// Result handler for this job
scalarResBroker := &scalarResultBroker{
cb: cb,
query: query,
}
job := jobs.NewBasicJob(jobName,
prometheus.NewScalarQueryJob(
query,
endTimestamp,
promAPI,
enforcer,
promTimeout,
scalarResBroker.handleResult,
scalarResBroker.handleError,
))
scalarResBroker.job = job
circuitAPI.ScheduleConditionalBackgroundJob(scalarResBroker, promQL.ticksPerExecution)
}
func (promQL *PromQL) onScalarResult(value float64, err error) {
promQL.value = value
promQL.err = err
}
// ScalarQuery is a construct that can be used by other components to get tick aligned scalar results of a PromQL query.
type ScalarQuery struct {
promQL *PromQL
}
// NewScalarQueryAndOptions creates a new ScalarQuery and its fx options.
func NewScalarQueryAndOptions(
queryString string,
evaluationInterval time.Duration,
componentID runtime.ComponentID,
policyReadAPI iface.Policy,
jobPostFix string,
) (*ScalarQuery, fx.Option, error) {
// Create promQLProto
promQLProto := &policylangv1.PromQL{
QueryString: queryString,
EvaluationInterval: durationpb.New(evaluationInterval),
}
// Create promQL
promQL, options, err := NewPromQLAndOptions(promQLProto, componentID, policyReadAPI)
if err != nil {
return nil, fx.Options(), err
}
promQL.jobName = fmt.Sprintf("Component-%s.%s", promQL.componentID, jobPostFix)
scalarQuery := &ScalarQuery{
promQL: promQL,
}
return scalarQuery, options, nil
}
// ExecuteScalarQuery runs a ScalarQueryJob and returns the current results: value and err. This function is supposed to be run under Circuit Execution Lock (Execution of Circuit Components is protected by this lock).
func (scalarQuery *ScalarQuery) ExecuteScalarQuery(circuitAPI runtime.CircuitAPI) (ScalarResult, error) {
inPortReadings := runtime.PortToReading{}
_, _ = scalarQuery.promQL.Execute(inPortReadings, circuitAPI)
// FYI: promQL ensures that initial runs return err when no queries have returned yet.
return ScalarResult{Value: scalarQuery.promQL.value}, scalarQuery.promQL.err
}
// ScalarResult is the result of a ScalarQuery.
type ScalarResult struct {
Value float64
}
// TaggedQuery is a construct that can be used by other components to get tick aligned prometheus value results of a PromQL query.
type TaggedQuery struct {
scalarQuery *ScalarQuery
res prometheusmodel.Value
err error
}
// Make sure TaggedQuery implements queryScheduerIfc.
var _ queryScheduerIfc = (*TaggedQuery)(nil)
// NewTaggedQueryAndOptions creates a new TaggedQuery and its fx options.
func NewTaggedQueryAndOptions(
queryString string,
evaluationInterval time.Duration,
componentID runtime.ComponentID,
policyReadAPI iface.Policy,
jobPostFix string,
) (*TaggedQuery, fx.Option, error) {
scalarQuery, options, err := NewScalarQueryAndOptions(queryString, evaluationInterval, componentID, policyReadAPI, jobPostFix)
if err != nil {
return nil, fx.Options(), err
}
taggedQuery := &TaggedQuery{
scalarQuery: scalarQuery,
// Set err to make sure the initial runs of ExecuteTaggedQuery return error.
err: ErrNoQueriesReturned,
}
// taggedQuery implements jobRegisterer
scalarQuery.promQL.queryScheduler = taggedQuery
return taggedQuery, options, nil
}
func (taggedQuery *TaggedQuery) scheduleQuery(endTimestamp time.Time, circuitAPI runtime.CircuitAPI) {
jobName := taggedQuery.scalarQuery.promQL.jobName
query := taggedQuery.scalarQuery.promQL.queryString
promAPI := taggedQuery.scalarQuery.promQL.promAPI
enforcer := taggedQuery.scalarQuery.promQL.enforcer
cb := taggedQuery.onTaggedResult
// Result handler for this job
taggedResBroker := &taggedResultBroker{
cb: cb,
query: query,
}
job := jobs.NewBasicJob(jobName,
prometheus.NewPromQueryJob(
query,
endTimestamp,
promAPI,
enforcer,
promTimeout,
taggedResBroker.handleResult,
taggedResBroker.handleError,
))
taggedResBroker.job = job
circuitAPI.ScheduleConditionalBackgroundJob(taggedResBroker, taggedQuery.scalarQuery.promQL.ticksPerExecution)
}
func (taggedQuery *TaggedQuery) onTaggedResult(res prometheusmodel.Value, err error) {
taggedQuery.res = res
taggedQuery.err = err
}
// ExecuteTaggedQuery runs a PromQueryJob and returns the current results: res and err. This function is supposed to be run under Circuit Execution Lock (Execution of Circuit Components is protected by this lock).
func (taggedQuery *TaggedQuery) ExecuteTaggedQuery(circuitAPI runtime.CircuitAPI) (TaggedResult, error) {
_, _ = taggedQuery.scalarQuery.ExecuteScalarQuery(circuitAPI)
return TaggedResult{Value: taggedQuery.res}, taggedQuery.err
}
// TaggedResult is the result of a ScalarQuery.
type TaggedResult struct {
Value prometheusmodel.Value
}