kubernetes-graphite-cluster

A deployment-ready graphite cluster on top of Kubernetes. Find the full details here

A statsd proxy deployment and service for metric collection
A statsd daemon deployment and service for metric aggregation and shipping
Carbon relay deployment and service to spread metrics across several Graphite data nodes
Graphite data nodes as a stateful set with persistent volumes
Graphite query node to be used as a query gateway to the data nodes

Requirements:

Kubernetes version 1.5.X (We're using StatefulSet)
kubectl configured to work with your Kubernetes API
Tested on Kubernetes 1.5.X/1.6.X (Without RBAC) on top of AWS/GKE
Optional - Access to your own docker repository to store your own images. That's relevant if you don't want to use the default images offered here.

Environment Variables:

Name	Default Value	Purpose
DOCKER_REPOSITORY	nanit	Change it if you want to build and use custom docker repository. nanit images are public so leaving it as it is should work out of the box.
SUDO	sudo	Should docker commands be prefixed with sudo. Change to "" to omit sudo.
STATSD_PROXY_REPLICAS	None	Number of replicas for statsd proxy
STATSD_DAEMON_REPLICAS	None	Number of StatsD daemons running behind the proxies.
CARBON_RELAY_REPLICAS	None	Number of replicas for carbon relay
GRAPHITE_NODE_REPLICAS	None	The number of Graphite data nodes in the cluster. This number affects both carbon relay and graphite master configuration.
GRAPHITE_NODE_DISK_SIZE	None	The size of the persistent disk to be allocated for each Graphite node.
GRAPHITE_NODE_CURATOR_RETENTION	None	Set this variable to run a cronjob which deletes metrics that haven't been written for X days. Leaving it blank will not run the curator
GRAPHITE_NODE_STORAGE_CLASS	None	The storage class for the persistent volumen claims of the Graphite node stateful set
GRAPHITE_MASTER_REPLICAS	None	Number of replicas for graphite query node

Deployment:

Clone this repository
Run:

export DOCKER_REPOSITORY=nanit && \
export STATSD_PROXY_REPLICAS=3 && \
export STATSD_DAEMON_REPLICAS=2 && \
export CARBON_RELAY_REPLICAS=3 && \
export GRAPHITE_NODE_REPLICAS=3 && \
export GRAPHITE_NODE_DISK_SIZE=30G && \
export GRAPHITE_NODE_CURATOR_RETENTION=5 && \
export GRAPHITE_MASTER_REPLICAS=1 && \
export GRAPHITE_NODE_STORAGE_CLASS=default && \
export STATSD_PROXY_ADDITIONAL_YAML="" && \
export STATSD_DAEMON_ADDITIONAL_YAML="" && \
export CARBON_RELAY_ADDITIONAL_YAML="" && \
export GRAPHITE_NODE_ADDITIONAL_YAML="" && \
export SUDO="" && \
make deploy

Usage:

After the deployment is done there are two endpoints of interest:

statsd:8125 is the host for your metrics collection. It points the statsd proxies.
graphite:80 is the host for you metrics queries. It points to the graphite query node which queries all data nodes in the cluster.

Run kubectl get pods,statefulsets,svc and expect to see the following resources:

The replicas of each resource may change according to your environment variables of course.

Verifying The Deployment:

To verify everything works as expected just paste the following into your terminal:

POD_NAME=$(kubectl get pods -l app=statsd -o jsonpath="{.items[0].metadata.name}")
kubectl exec -it $POD_NAME bash 
for i in {1..10}
do
  echo "test_counter:1|c" | nc -w1 -u statsd 8125
  sleep 1
done

apk --update add curl
curl 'graphite/render?target=stats.counters.test_counter.count&from=-10min&format=json'

You should see a lot of null values along with your few increments at the end.

Building your own images

If you want to build use your own images make sure to change the DOCKER_REPOSITORY environment variable to your own docker repository. It will build the images, push them to your docker repository and use them to create all the needed kubernetes deployments.

Changing an active cluster configuration

Graphite nodes and StatsD daemons are deployed as StatefulSets. The StatsD proxies continuously watch the Kubernetes API for StatsD daemon endpoints and updates the configuration. Both Graphite master and carbon relays continuously watch the Kubernetes API for Graphite nodes endpoints and update the configuration.

That means you can scale each part independently, and the system reacts to your changes by updating its config file accordingly.

Acknowledgement

I have learnt a lot about Graphite clustering from this excellent article
The docker images for the graphite nodes are based on this repository

nanit/kubernetes-graphite-cluster