mirror of
https://github.com/prometheus/prometheus
synced 2024-12-27 00:53:12 +00:00
85 lines
2.6 KiB
Go
85 lines
2.6 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 model
|
|
|
|
import (
|
|
"code.google.com/p/goprotobuf/proto"
|
|
"fmt"
|
|
"github.com/prometheus/prometheus/coding/indexable"
|
|
dto "github.com/prometheus/prometheus/model/generated"
|
|
"time"
|
|
)
|
|
|
|
// SampleKey models the business logic around the data-transfer object
|
|
// SampleKey.
|
|
type SampleKey struct {
|
|
Fingerprint *Fingerprint
|
|
FirstTimestamp time.Time
|
|
LastTimestamp time.Time
|
|
SampleCount uint32
|
|
}
|
|
|
|
// MayContain indicates whether the given SampleKey could potentially contain a
|
|
// value at the provided time. Even if true is emitted, that does not mean a
|
|
// satisfactory value, in fact, exists.
|
|
func (s SampleKey) MayContain(t time.Time) bool {
|
|
switch {
|
|
case t.Before(s.FirstTimestamp):
|
|
return false
|
|
case t.After(s.LastTimestamp):
|
|
return false
|
|
default:
|
|
return true
|
|
}
|
|
}
|
|
|
|
// ToDTO converts this SampleKey into a DTO for use in serialization purposes.
|
|
func (s SampleKey) ToDTO() (out *dto.SampleKey) {
|
|
out = &dto.SampleKey{
|
|
Fingerprint: s.Fingerprint.ToDTO(),
|
|
Timestamp: indexable.EncodeTime(s.FirstTimestamp),
|
|
LastTimestamp: proto.Int64(s.LastTimestamp.Unix()),
|
|
SampleCount: proto.Uint32(s.SampleCount),
|
|
}
|
|
|
|
return
|
|
}
|
|
|
|
// ToPartialDTO converts this SampleKey into a DTO that is only suitable for
|
|
// database exploration purposes for a given (Fingerprint, First Sample Time)
|
|
// tuple.
|
|
func (s SampleKey) ToPartialDTO(out *dto.SampleKey) {
|
|
out = &dto.SampleKey{
|
|
Fingerprint: s.Fingerprint.ToDTO(),
|
|
Timestamp: indexable.EncodeTime(s.FirstTimestamp),
|
|
}
|
|
|
|
return
|
|
}
|
|
|
|
func (s SampleKey) String() string {
|
|
return fmt.Sprintf("SampleKey for %s at %s to %s with %d values.", s.Fingerprint, s.FirstTimestamp, s.LastTimestamp, s.SampleCount)
|
|
}
|
|
|
|
// NewSampleKeyFromDTO builds a new SampleKey from a provided data-transfer
|
|
// object.
|
|
func NewSampleKeyFromDTO(dto *dto.SampleKey) SampleKey {
|
|
return SampleKey{
|
|
Fingerprint: NewFingerprintFromDTO(dto.Fingerprint),
|
|
FirstTimestamp: indexable.DecodeTime(dto.Timestamp),
|
|
LastTimestamp: time.Unix(*dto.LastTimestamp, 0).UTC(),
|
|
SampleCount: *dto.SampleCount,
|
|
}
|
|
}
|