Skip to content
This repository has been archived by the owner on Dec 17, 2019. It is now read-only.

Latest commit

 

History

History
 
 

klumps

KLUMPS: Kubernetes/Linux USE Method with Prometheus

A set of USE Method dashboards for Grafana, using Prometheus as a backend. Use these dashboards if you want insight into the performance of your Kubernetes infrastructure. For more motivation, see "The RED Method: How to instrument your services" talk from CloudNativeCon Austin.

Getting Started

First you'll need jsonnet - on a Mac I recommend installing it with brew. Once you have jsonnet installed, the dashboards can be generated with the following command:

$ jsonnet -m . lib/to_json_files.jsonnet

The dashboards depend on a set of Prometheus recording rules, which can be generated with the following command:

$ jsonnet recording_rules.jsonnet >recording_rules.yaml

This generates JSON, but luckily JSON is a subset of YAML so Prometheus can use this file.

Ksonnet

Alternatively, if you use ksonnet to generate your Kubernetes config, the dashboards can be included in a config map directly:

local k = import "ksonnet.beta.2/k8s.libsonnet",
  dashboards = import "dashboards.jsonnet",
  configMap = k.core.v1.configMap;

configMap.new() +
configMap.mixin.metadata.name("dashboards") +
configMap.data({[name]: std.toString(dashboards[name])
  for name in std.objectFields(dashboards)})