mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2024-08-26 22:47:51 +02:00
106 lines
3 KiB
Go
106 lines
3 KiB
Go
|
// Copyright 2012-present Oliver Eilhard. All rights reserved.
|
||
|
// Use of this source code is governed by a MIT-license.
|
||
|
// See http://olivere.mit-license.org/license.txt for details.
|
||
|
|
||
|
package elastic
|
||
|
|
||
|
// SerialDiffAggregation implements serial differencing.
|
||
|
// Serial differencing is a technique where values in a time series are
|
||
|
// subtracted from itself at different time lags or periods.
|
||
|
//
|
||
|
// For more details, see
|
||
|
// https://www.elastic.co/guide/en/elasticsearch/reference/7.0/search-aggregations-pipeline-serialdiff-aggregation.html
|
||
|
type SerialDiffAggregation struct {
|
||
|
format string
|
||
|
gapPolicy string
|
||
|
lag *int
|
||
|
|
||
|
meta map[string]interface{}
|
||
|
bucketsPaths []string
|
||
|
}
|
||
|
|
||
|
// NewSerialDiffAggregation creates and initializes a new SerialDiffAggregation.
|
||
|
func NewSerialDiffAggregation() *SerialDiffAggregation {
|
||
|
return &SerialDiffAggregation{
|
||
|
bucketsPaths: make([]string, 0),
|
||
|
}
|
||
|
}
|
||
|
|
||
|
// Format to use on the output of this aggregation.
|
||
|
func (a *SerialDiffAggregation) Format(format string) *SerialDiffAggregation {
|
||
|
a.format = format
|
||
|
return a
|
||
|
}
|
||
|
|
||
|
// GapPolicy defines what should be done when a gap in the series is discovered.
|
||
|
// Valid values include "insert_zeros" or "skip". Default is "insert_zeros".
|
||
|
func (a *SerialDiffAggregation) GapPolicy(gapPolicy string) *SerialDiffAggregation {
|
||
|
a.gapPolicy = gapPolicy
|
||
|
return a
|
||
|
}
|
||
|
|
||
|
// GapInsertZeros inserts zeros for gaps in the series.
|
||
|
func (a *SerialDiffAggregation) GapInsertZeros() *SerialDiffAggregation {
|
||
|
a.gapPolicy = "insert_zeros"
|
||
|
return a
|
||
|
}
|
||
|
|
||
|
// GapSkip skips gaps in the series.
|
||
|
func (a *SerialDiffAggregation) GapSkip() *SerialDiffAggregation {
|
||
|
a.gapPolicy = "skip"
|
||
|
return a
|
||
|
}
|
||
|
|
||
|
// Lag specifies the historical bucket to subtract from the current value.
|
||
|
// E.g. a lag of 7 will subtract the current value from the value 7 buckets
|
||
|
// ago. Lag must be a positive, non-zero integer.
|
||
|
func (a *SerialDiffAggregation) Lag(lag int) *SerialDiffAggregation {
|
||
|
a.lag = &lag
|
||
|
return a
|
||
|
}
|
||
|
|
||
|
// Meta sets the meta data to be included in the aggregation response.
|
||
|
func (a *SerialDiffAggregation) Meta(metaData map[string]interface{}) *SerialDiffAggregation {
|
||
|
a.meta = metaData
|
||
|
return a
|
||
|
}
|
||
|
|
||
|
// BucketsPath sets the paths to the buckets to use for this pipeline aggregator.
|
||
|
func (a *SerialDiffAggregation) BucketsPath(bucketsPaths ...string) *SerialDiffAggregation {
|
||
|
a.bucketsPaths = append(a.bucketsPaths, bucketsPaths...)
|
||
|
return a
|
||
|
}
|
||
|
|
||
|
// Source returns the a JSON-serializable interface.
|
||
|
func (a *SerialDiffAggregation) Source() (interface{}, error) {
|
||
|
source := make(map[string]interface{})
|
||
|
params := make(map[string]interface{})
|
||
|
source["serial_diff"] = params
|
||
|
|
||
|
if a.format != "" {
|
||
|
params["format"] = a.format
|
||
|
}
|
||
|
if a.gapPolicy != "" {
|
||
|
params["gap_policy"] = a.gapPolicy
|
||
|
}
|
||
|
if a.lag != nil {
|
||
|
params["lag"] = *a.lag
|
||
|
}
|
||
|
|
||
|
// Add buckets paths
|
||
|
switch len(a.bucketsPaths) {
|
||
|
case 0:
|
||
|
case 1:
|
||
|
params["buckets_path"] = a.bucketsPaths[0]
|
||
|
default:
|
||
|
params["buckets_path"] = a.bucketsPaths
|
||
|
}
|
||
|
|
||
|
// Add Meta data if available
|
||
|
if len(a.meta) > 0 {
|
||
|
source["meta"] = a.meta
|
||
|
}
|
||
|
|
||
|
return source, nil
|
||
|
}
|