https://github.com/unguiculus/loki-minio-demo

Demo setup for Grafana Loki in microservices mode using MinIO as storage backend
https://github.com/unguiculus/loki-minio-demo

grafana helm kind kubernetes loki minio prometheus promtail

Last synced: 24 days ago
JSON representation

Demo setup for Grafana Loki in microservices mode using MinIO as storage backend

• Host: GitHub
• URL: https://github.com/unguiculus/loki-minio-demo
• Owner: unguiculus
• Created: 2020-12-21T15:12:33.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2021-03-25T18:21:27.000Z (over 3 years ago)
• Last Synced: 2024-02-14T21:56:34.031Z (9 months ago)
• Topics: grafana, helm, kind, kubernetes, loki, minio, prometheus, promtail
• Language: Shell
• Homepage:
• Size: 48.8 KB
• Stars: 26
• Watchers: 3
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# loki-minio-demo

Demo setup for Grafana Loki in microservices mode using MinIO as storage backend.

## Pre-requisites

The following pre-requisites must be installed:

* [Helm 3](https://helm.sh/)

* [kubectl](https://kubernetes.io/de/docs/tasks/tools/install-kubectl/)

* [Docker](https://www.docker.com/)

* [kind](https://github.com/kubernetes-sigs/kind/)

## Usage

Run `./setup.sh`.

This will create a kind cluster and install all services.

## What's Included?

A kind cluster with one master and three worker nodes is created.

The cluster uses a local pull-through Docker registry for faster image pulling on the various kind nodes and to avoid rate-limiting issue with Docker hub.

The setup creates an _almost_ production-ready, highly available, distributed Loki setup.

However, there are no resources configured for pods in this setup because we have to be able to spin up a lot of pods on a local Docker setup.

You may want to tweak your Docker configuration increasing the number of CPUs and the amount of memory it can use.

In a production setup resources should definitely be configured.

Port 30123 is mapped to the same port on the master node in order to enable ingress.

### The following Helm charts are installed:

* [ingress-nginx](https://github.com/kubernetes/ingress-nginx/tree/master/charts/ingress-nginx)

* [metrics-server](https://github.com/bitnami/charts/tree/master/bitnami/metrics-server)

* [kube-prometheus-stack](https://github.com/prometheus-community/helm-charts/tree/main/charts/kube-prometheus-stack)

* [minio](https://github.com/minio/charts/tree/master/minio)

* [loki-distributed](https://github.com/grafana/helm-charts/tree/main/charts/loki-distributed)

* [Heptio Eventrouter](https://github.com/heptiolabs/eventrouter)

* [promtail](https://github.com/grafana/helm-charts/tree/main/charts/promtail)

* [loki-canary](https://github.com/grafana/helm-charts/tree/main/charts/loki-canary)

* [test-logger](charts/test-logger)

### Loki is installed with the following components:

* gateway

* ingester

* distributor

* querier

* query-frontend

* table-manager

* compactor

* ruler

* memcached-chunks

* memcached-frontend

* memcached-index-queries

Single-Store (boltdb-shipper) is used for index storage with MinIO as storage backend.

### The following services are reachable via ingress:

* Grafana: http://localhost:30123/grafana

* Prometheus: http://localhost:30123/prom

* Alertmanager: http://localhost:30123/alerts

* MinIO: http://localhost:30123/minio

  MinIO access key and secret key for logging into the UI can be retrieved with the following commands.

  ```console

  kubectl get secret -n minio minio-credentials -o jsonpath="{.data.accesskey}" | base64 --decode | xargs echo

  kubectl get secret -n minio minio-credentials -o jsonpath="{.data.secretkey}" | base64 --decode | xargs echo

  ```

### Test Loggers

Two instances of the test-logger chart are installed which simply log test messages for demo purposes, one in JSON format and one in logfmt format.

The Promtail configuration demonstrates how to extract the log level as label.

### Grafana Dashboards

Besides a number of dashboards that come with the kube-prometheus-stack, the following dashboards are provided for Loki:

* Loki Operational (adapted from Grafana's Tanka setup): http://localhost:30123/grafana/d/loki-operational/

* Loki Canary: http://localhost:30123/grafana/d/loki-canary/

* Kubernetes Events: http://localhost:30123/grafana/d/kubernetes-events/