Introduction
In this post, that is actually documentation for myself, I'll guide you thru the deployment of a monitoring environment in your local machine, this can be used for study and prototype. The project will use prometheus to monitor and grafana to plot graphs.
Getting your machine ready
I'm using Ubuntu 20.04.1 LTS as my OS
First you'll need to install a tool to run Kubernetes locally (kind, minikube, k3s or other that you like; Personally I use kind)
The steps are the following
$wget https://github.com/kubernetes-sigs/kind/releases/download/v0.8.1/kind-linux-amd64
$chmod +x kind-linux-amd64
$mv kind-linux-amd64 /usr/local/bin/kind
$kind version
and then install Helm
sudo snap install helm --classic
for other ways of installing helm please refer to Helm Documentation
Kind
Now that we have our tools installed we need to create a kubernetes cluster
kind create cluster --name
If you don't put the flag --name
the cluster name will be "kind"
Helm
Helm is a package manager for Kubernetes
To Add the prometheus charts repo use the command:
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
We'll install two helm charts
kube-prometheus-stack
As per github This chart contains a collection of Kubernetes manifests, Grafana dashboards, and Prometheus rules combined with documentation and scripts to provide easy to operate end-to-end Kubernetes cluster monitoring with Prometheus using the Prometheus Operator.
helm install prometheus-community/kube-prometheus-stack --generate-name
pushgateway
Pushgateway is a tool that pushes metrics that cannot be scraped
helm install prometheus-community/prometheus-pushgateway --generate-name
Testing and Tweaking
Run kubectl get services
to see the services running and some information about them. A detail when deploying prometheus localy is to change the type of the following services kube-prometheus-stack-1611-operator
kube-prometheus-stack-1611575778-grafana
from ClusterIP to NodePort (if you are deploying it in a cloud environment you shall change to LoadBalancer). More information about Kubernetes services can be found here
To edit the services use the following command
kubectl edit svc your-service-goes-here
this command will open a vim type editor and allow you to edit information about the service
Now all you have to do is expose the ports using the port-forward command, the following example allows me to access alert-manager via browser
kubectl port-forward svc/alertmanager-operated 9093
The syntax is kubectl port-forward TYPE/NAME PORT.
And that's all for today 🤓
References
Kube Prometheus Stack
Helm Documentation
Kind Quick Start
Pushgateway
Port Forward
Kubectl cheat sheet
Top comments (0)