aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar Joe Banks <[email protected]>2024-04-09 23:59:17 +0100
committerGravatar Joe Banks <[email protected]>2024-04-10 17:51:04 +0100
commit0e455a171d5338d453bfbb8eed73b8abe7c872bf (patch)
tree64cb8e8c12df1f887b6ac5508eb53f4b3c321c58
parentAdd /tmp volume to Grafana for plugin install (diff)
Add logging documentation
-rw-r--r--kubernetes/namespaces/loki/README.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/kubernetes/namespaces/loki/README.md b/kubernetes/namespaces/loki/README.md
new file mode 100644
index 0000000..26c158d
--- /dev/null
+++ b/kubernetes/namespaces/loki/README.md
@@ -0,0 +1,25 @@
+# Logging
+
+We deploy multiple components through Helm to solve logging within our cluster.
+
+## Loki
+
+We use `loki_values.yml` to deploy the `grafana/loki` Helm chart.
+
+Once this is deployed, the service `loki-gateway.loki.svc.cluster.local` will point to one of the Loki replicas.
+
+```
+$ helm repo add grafana https://grafana.github.io/helm-charts
+$ helm repo update
+$ helm upgrade --install -n loki --values loki_values.yml loki grafana/loki
+```
+
+## Alloy
+
+[Alloy](https://grafana.com/oss/alloy-opentelemetry-collector/) ships logs from all pods through to Loki.
+
+This requires no additional configuration, just make sure Loki is up and Alloy will start shipping logs.
+
+```
+$ helm upgrade --install -n loki --values alloy_values.yml alloy grafana/alloy
+```