README.md

metrics

Kubernetes metrics API type definitions and clients.

Purpose

This repository contains type definitions and client code for the metrics APIs that Kubernetes makes use of. Depending on the API, the actual implementations live elsewhere.

Consumers of the metrics APIs can make use of this repository to access implementations of the APIs, while implementors should make use of this library when implementing their API servers.

APIs

This repository contains types and clients for several APIs.

Custom Metrics API

This API allows consumers to access arbitrary metrics which describe Kubernetes resources.

The API is intended to be implemented by monitoring pipeline vendors, on top of their metrics storage solutions.

If you want to implement this as an API server for this API, please see the kubernetes-sigs/custom-metrics-apiserver library, which contains the basic infrastructure required to set up such an API server.

Import Path: k8s.io/metrics/pkg/apis/custom_metrics.

Resource Metrics API

This API allows consumers to access resource metrics (CPU and memory) for pods and nodes.

The API is implemented by metrics-server and prometheus-adapter.

Import Path: k8s.io/metrics/pkg/apis/metrics.

Compatibility

The APIs in this repository follow the standard guarantees for Kubernetes APIs, and will follow Kubernetes releases.

Community, discussion, contribution, and support

Learn how to engage with the Kubernetes community on the community page.

You can reach the maintainers of this repository at:

• Slack: #sig-instrumentation channel, you can get an invite at slack.kubernetes.io.
• Mailing List

Code of Conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.

Contibution Guidelines

See CONTRIBUTING.md for more information.