forked from knative/pkg
/
stats_reporter.go
148 lines (128 loc) · 4.71 KB
/
stats_reporter.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
/*
Copyright 2018 The Knative Authors
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 controller
import (
"context"
"errors"
"time"
"github.com/knative/pkg/metrics"
"go.opencensus.io/stats"
"go.opencensus.io/stats/view"
"go.opencensus.io/tag"
"go.uber.org/zap"
)
var (
workQueueDepthStat = stats.Int64("work_queue_depth", "Depth of the work queue", stats.UnitNone)
reconcileCountStat = stats.Int64("reconcile_count", "Number of reconcile operations", stats.UnitNone)
reconcileLatencyStat = stats.Int64("reconcile_latency", "Latency of reconcile operations", stats.UnitMilliseconds)
// reconcileDistribution defines the bucket boundaries for the histogram of reconcile latency metric.
// Bucket boundaries are 10ms, 100ms, 1s, 10s, 30s and 60s.
reconcileDistribution = view.Distribution(10, 100, 1000, 10000, 30000, 60000)
// Create the tag keys that will be used to add tags to our measurements.
// Tag keys must conform to the restrictions described in
// go.opencensus.io/tag/validate.go. Currently those restrictions are:
// - length between 1 and 255 inclusive
// - characters are printable US-ASCII
reconcilerTagKey = mustNewTagKey("reconciler")
keyTagKey = mustNewTagKey("key")
successTagKey = mustNewTagKey("success")
)
// func init() {
// // Create views to see our measurements. This can return an error if
// // a previously-registered view has the same name with a different value.
// // View name defaults to the measure name if unspecified.
// err := view.Register(
// &view.View{
// Description: "Depth of the work queue",
// Measure: workQueueDepthStat,
// Aggregation: view.LastValue(),
// TagKeys: []tag.Key{reconcilerTagKey},
// },
// &view.View{
// Description: "Number of reconcile operations",
// Measure: reconcileCountStat,
// Aggregation: view.Count(),
// TagKeys: []tag.Key{reconcilerTagKey, keyTagKey, successTagKey},
// },
// &view.View{
// Description: "Latency of reconcile operations",
// Measure: reconcileLatencyStat,
// Aggregation: reconcileDistribution,
// TagKeys: []tag.Key{reconcilerTagKey, keyTagKey, successTagKey},
// },
// )
// if err != nil {
// panic(err)
// }
// }
// StatsReporter defines the interface for sending metrics
type StatsReporter interface {
// ReportQueueDepth reports the queue depth metric
ReportQueueDepth(v int64) error
// ReportReconcile reports the count and latency metrics for a reconcile operation
ReportReconcile(duration time.Duration, key, success string) error
}
// Reporter holds cached metric objects to report metrics
type reporter struct {
reconciler string
globalCtx context.Context
}
// NewStatsReporter creates a reporter that collects and reports metrics
func NewStatsReporter(reconciler string) (StatsReporter, error) {
// Reconciler tag is static. Create a context containing that and cache it.
ctx, err := tag.New(
context.Background(),
tag.Insert(reconcilerTagKey, reconciler))
if err != nil {
return nil, err
}
return &reporter{reconciler: reconciler, globalCtx: ctx}, nil
}
// MustNewStatsReporter creates a new instance of StatsReporter.
// Logs fatally if creation fails.
func MustNewStatsReporter(reconciler string, logger *zap.SugaredLogger) StatsReporter {
stats, err := NewStatsReporter(reconciler)
if err != nil {
logger.Fatalw("Failed to initialize the stats reporter", zap.Error(err))
}
return stats
}
// ReportQueueDepth reports the queue depth metric
func (r *reporter) ReportQueueDepth(v int64) error {
if r.globalCtx == nil {
return errors.New("reporter is not initialized correctly")
}
metrics.Record(r.globalCtx, workQueueDepthStat.M(v))
return nil
}
// ReportReconcile reports the count and latency metrics for a reconcile operation
func (r *reporter) ReportReconcile(duration time.Duration, key, success string) error {
ctx, err := tag.New(
context.Background(),
tag.Insert(reconcilerTagKey, r.reconciler),
tag.Insert(keyTagKey, key),
tag.Insert(successTagKey, success))
if err != nil {
return err
}
metrics.Record(ctx, reconcileCountStat.M(1))
metrics.Record(ctx, reconcileLatencyStat.M(int64(duration/time.Millisecond)))
return nil
}
func mustNewTagKey(s string) tag.Key {
tagKey, err := tag.NewKey(s)
if err != nil {
panic(err)
}
return tagKey
}