kubert-prometheus-process

Crates.iokubert-prometheus-process
lib.rskubert-prometheus-process
version0.1.0
sourcesrc
created_at2023-12-10 00:07:06.092205
updated_at2023-12-10 00:07:06.092205
descriptionA prometheus-client process metrics collector
homepage
repositoryhttps://github.com/olix0r/kubert
max_upload_size
id1063944
size12,742
Oliver Gould (olix0r)

documentation

README

kubert

Rust Kubernetes runtime helpers. Based on kube-rs.

kubert

Crates.io Documentation License

Features

  • clap command-line interface support;
  • A basic admin server with /ready and /live probe endpoints;
  • Optional prometheus-client integration;
  • A default Kubernetes client;
  • Graceful shutdown on SIGTERM or SIGINT signals;
  • An HTTPS server (for admission controllers and API extensions) with certificate reloading;
  • A utility for maintaining an index derived from watching one or more Kubernetes resources types;
  • A requeue channel that supports deferring/rescheduling updates (i.e. in case a write fails);
  • And a Runtime type that ties it all together!

Why not kube-rs?

The kube crate is great! And in fact, kubert builds on kube's client and runtime modules. This crate, however, captures some of the repeated patterns we've encountered building controllers for Linkerd. It doesn't try to hide kube--though it does reduce boilerplate around initializing watches and caches (reflectors); and it expects you to schedule work via the tokio runtime.

Examples

This repository includes a simple example application that demonstrates how to use a kubert::Runtime.

Other examples include:

kubert-prometheus-process

The kubert-prometheus-process crate provides process metrics for prometheus-client. It has no dependencies on kubert, and can be used independently.

Status

This crate is still fairly experimental, though it's based on production code from Linkerd; and we plan to use it in Linkerd moving forward.

Commit count: 169

cargo fmt