121 lines
3.1 KiB
Go
121 lines
3.1 KiB
Go
// Copyright 2013 Prometheus Team
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package extraction
|
|
|
|
import (
|
|
"io"
|
|
"time"
|
|
|
|
"github.com/prometheus/client_golang/model"
|
|
)
|
|
|
|
// ProcessOptions dictates how the interpreted stream should be rendered for
|
|
// consumption.
|
|
type ProcessOptions struct {
|
|
// Timestamp is added to each value from the stream that has no explicit
|
|
// timestamp set.
|
|
Timestamp model.Timestamp
|
|
}
|
|
|
|
// Ingester consumes result streams in whatever way is desired by the user.
|
|
type Ingester interface {
|
|
Ingest(*Result) error
|
|
}
|
|
|
|
// Processor is responsible for decoding the actual message responses from
|
|
// stream into a format that can be consumed with the end result written
|
|
// to the results channel.
|
|
type Processor interface {
|
|
// ProcessSingle treats the input as a single self-contained message body and
|
|
// transforms it accordingly. It has no support for streaming.
|
|
ProcessSingle(in io.Reader, out Ingester, o *ProcessOptions) error
|
|
}
|
|
|
|
// Helper function to convert map[string]string into LabelSet.
|
|
//
|
|
// NOTE: This should be deleted when support for go 1.0.3 is removed; 1.1 is
|
|
// smart enough to unmarshal JSON objects into LabelSet directly.
|
|
func labelSet(labels map[string]string) model.LabelSet {
|
|
labelset := make(model.LabelSet, len(labels))
|
|
|
|
for k, v := range labels {
|
|
labelset[model.LabelName(k)] = model.LabelValue(v)
|
|
}
|
|
|
|
return labelset
|
|
}
|
|
|
|
// Result encapsulates the outcome from processing samples from a source.
|
|
type Result struct {
|
|
Err error
|
|
Samples model.Samples
|
|
}
|
|
|
|
func (r *Result) equal(o *Result) bool {
|
|
if r == o {
|
|
return true
|
|
}
|
|
|
|
if r.Err != o.Err {
|
|
if r.Err == nil || o.Err == nil {
|
|
return false
|
|
}
|
|
|
|
if r.Err.Error() != o.Err.Error() {
|
|
return false
|
|
}
|
|
}
|
|
|
|
if len(r.Samples) != len(o.Samples) {
|
|
return false
|
|
}
|
|
|
|
for i, mine := range r.Samples {
|
|
other := o.Samples[i]
|
|
|
|
if !mine.Equal(other) {
|
|
return false
|
|
}
|
|
}
|
|
|
|
return true
|
|
}
|
|
|
|
// A basic interface only useful in testing contexts for dispensing the time
|
|
// in a controlled manner.
|
|
type instantProvider interface {
|
|
// The current instant.
|
|
Now() time.Time
|
|
}
|
|
|
|
// Clock is a simple means for fluently wrapping around standard Go timekeeping
|
|
// mechanisms to enhance testability without compromising code readability.
|
|
//
|
|
// It is sufficient for use on bare initialization. A provider should be
|
|
// set only for test contexts. When not provided, it emits the current
|
|
// system time.
|
|
type clock struct {
|
|
// The underlying means through which time is provided, if supplied.
|
|
Provider instantProvider
|
|
}
|
|
|
|
// Emit the current instant.
|
|
func (t *clock) Now() time.Time {
|
|
if t.Provider == nil {
|
|
return time.Now()
|
|
}
|
|
|
|
return t.Provider.Now()
|
|
}
|