/* Copyright 2018 The Kubernetes Authors All rights reserved. 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 metricsstore import ( "io" "sync" "k8s.io/apimachinery/pkg/api/meta" "k8s.io/apimachinery/pkg/types" ) // FamilyByteSlicer represents a metric family that can be converted to its string // representation. type FamilyByteSlicer interface { ByteSlice() []byte } // MetricsStore implements the k8s.io/client-go/tools/cache.Store // interface. Instead of storing entire Kubernetes objects, it stores metrics // generated based on those objects. type MetricsStore struct { // Protects metrics mutex sync.RWMutex // metrics is a map indexed by Kubernetes object id, containing a slice of // metric families, containing a slice of metrics. We need to keep metrics // grouped by metric families in order to zip families with their help text in // MetricsStore.WriteAll(). metrics map[types.UID][][]byte // headers contains the header (TYPE and HELP) of each metric family. It is // later on zipped with with their corresponding metric families in // MetricStore.WriteAll(). headers []string // generateMetricsFunc generates metrics based on a given Kubernetes object // and returns them grouped by metric family. generateMetricsFunc func(interface{}) []FamilyByteSlicer } // NewMetricsStore returns a new MetricsStore func NewMetricsStore(headers []string, generateFunc func(interface{}) []FamilyByteSlicer) *MetricsStore { return &MetricsStore{ generateMetricsFunc: generateFunc, headers: headers, metrics: map[types.UID][][]byte{}, } } // Implementing k8s.io/client-go/tools/cache.Store interface // Add inserts adds to the MetricsStore by calling the metrics generator functions and // adding the generated metrics to the metrics map that underlies the MetricStore. func (s *MetricsStore) Add(obj interface{}) error { o, err := meta.Accessor(obj) if err != nil { return err } s.mutex.Lock() defer s.mutex.Unlock() families := s.generateMetricsFunc(obj) familyStrings := make([][]byte, len(families)) for i, f := range families { familyStrings[i] = f.ByteSlice() } s.metrics[o.GetUID()] = familyStrings return nil } // Update updates the existing entry in the MetricsStore. func (s *MetricsStore) Update(obj interface{}) error { // TODO: For now, just call Add, in the future one could check if the resource version changed? return s.Add(obj) } // Delete deletes an existing entry in the MetricsStore. func (s *MetricsStore) Delete(obj interface{}) error { o, err := meta.Accessor(obj) if err != nil { return err } s.mutex.Lock() defer s.mutex.Unlock() delete(s.metrics, o.GetUID()) return nil } // List implements the List method of the store interface. func (s *MetricsStore) List() []interface{} { return nil } // ListKeys implements the ListKeys method of the store interface. func (s *MetricsStore) ListKeys() []string { return nil } // Get implements the Get method of the store interface. func (s *MetricsStore) Get(obj interface{}) (item interface{}, exists bool, err error) { return nil, false, nil } // GetByKey implements the GetByKey method of the store interface. func (s *MetricsStore) GetByKey(key string) (item interface{}, exists bool, err error) { return nil, false, nil } // Replace will delete the contents of the store, using instead the // given list. func (s *MetricsStore) Replace(list []interface{}, _ string) error { s.mutex.Lock() s.metrics = map[types.UID][][]byte{} s.mutex.Unlock() for _, o := range list { err := s.Add(o) if err != nil { return err } } return nil } // Resync implements the Resync method of the store interface. func (s *MetricsStore) Resync() error { return nil } // WriteAll writes all metrics of the store into the given writer, zipped with the // help text of each metric family. func (s *MetricsStore) WriteAll(w io.Writer) { s.mutex.RLock() defer s.mutex.RUnlock() for i, help := range s.headers { w.Write([]byte(help)) w.Write([]byte{'\n'}) for _, metricFamilies := range s.metrics { w.Write([]byte(metricFamilies[i])) } } }