kubernetes/vendor/github.com/google/cadvisor/utils/cpuload/netlink/reader.go

// Copyright 2015 Google Inc. 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 netlink

import (
	"fmt"
	"os"

	info "github.com/google/cadvisor/info/v1"

	"k8s.io/klog/v2"
)

type NetlinkReader struct {
	familyID uint16
	conn     *Connection
}

func New() (*NetlinkReader, error) {
	conn, err := newConnection()
	if err != nil {
		return nil, fmt.Errorf("failed to create a new connection: %s", err)
	}

	id, err := getFamilyID(conn)
	if err != nil {
		return nil, fmt.Errorf("failed to get netlink family id for task stats: %s", err)
	}
	klog.V(4).Infof("Family id for taskstats: %d", id)
	return &NetlinkReader{
		familyID: id,
		conn:     conn,
	}, nil
}

func (r *NetlinkReader) Stop() {
	if r.conn != nil {
		r.conn.Close()
	}
}

func (r *NetlinkReader) Start() error {
	// We do the start setup for netlink in New(). Nothing to do here.
	return nil
}

// Returns instantaneous number of running tasks in a group.
// Caller can use historical data to calculate cpu load.
// path is an absolute filesystem path for a container under the CPU cgroup hierarchy.
// NOTE: non-hierarchical load is returned. It does not include load for subcontainers.
func (r *NetlinkReader) GetCpuLoad(name string, path string) (info.LoadStats, error) {
	if len(path) == 0 {
		return info.LoadStats{}, fmt.Errorf("cgroup path can not be empty")
	}

	cfd, err := os.Open(path)
	if err != nil {
		return info.LoadStats{}, fmt.Errorf("failed to open cgroup path %s: %q", path, err)
	}
	defer cfd.Close()

	stats, err := getLoadStats(r.familyID, cfd, r.conn)
	if err != nil {
		return info.LoadStats{}, err
	}
	klog.V(4).Infof("Task stats for %q: %+v", path, stats)
	return stats, nil
}