From 0b7a85575e1c5334d4ec81793a53e8e274712dd4 Mon Sep 17 00:00:00 2001 From: Christopher Hase Date: Thu, 28 Nov 2024 15:18:10 +0100 Subject: [PATCH] deploy kube-prometheus --- .../tools/Kube-prometheus-stack/_index.md | 31 +++++++++++++++++++ .../_index.md:Zone.Identifier | 0 content/en/docs/solution/tools/Loki/_index.md | 10 ++++++ .../tools/Loki/_index.md:Zone.Identifier | 0 .../en/docs/solution/tools/Promtail/_index.md | 9 ++++++ .../tools/Promtail/_index.md:Zone.Identifier | 0 6 files changed, 50 insertions(+) create mode 100644 content/en/docs/solution/tools/Kube-prometheus-stack/_index.md create mode 100644 content/en/docs/solution/tools/Kube-prometheus-stack/_index.md:Zone.Identifier create mode 100644 content/en/docs/solution/tools/Loki/_index.md create mode 100644 content/en/docs/solution/tools/Loki/_index.md:Zone.Identifier create mode 100644 content/en/docs/solution/tools/Promtail/_index.md create mode 100644 content/en/docs/solution/tools/Promtail/_index.md:Zone.Identifier diff --git a/content/en/docs/solution/tools/Kube-prometheus-stack/_index.md b/content/en/docs/solution/tools/Kube-prometheus-stack/_index.md new file mode 100644 index 0000000..ccf6338 --- /dev/null +++ b/content/en/docs/solution/tools/Kube-prometheus-stack/_index.md @@ -0,0 +1,31 @@ +--- +title: Kube-prometheus-stack +description: Kube-prometheus-stack contains Kubernetes manifests, Prometheus and Grafana, including preconfigured dashboards +--- + +## Kube-prometheus-stack Overview + +Grafana is an open-source monitoring solution that enables viusalization of metrics and logs. +Prometheus is an open-source monitoring and alerting system which collects metrics from services and allows the metrics to be shown in Grafana. + +### Implementation Details + +The application ist started in edfbuilder/kind/stacks/core/kube-prometheus.yaml. +The application has the sync option spec.syncPolicy.syncOptions ServerSideApply=true. This is necessary, since kube-prometheus-stack exceeds the size limit for secrets and without this option a sync attempt will fail and throw an exception. +The Helm values file edfbuilder/kind/stacks/core/kube-prometheus/values.yaml contains configuration values: +grafana.additionalDataSources contains Loki as a Grafana Data Source. +grafana.ingress contains the Grafana ingress configuratione, like the host url (cnoe.localtest.me). +grafana.sidecar.dashboards contains necessary configurations so additional user defined dashboards are loaded when Grafana is started. +grafana.grafana.ini.server contains configuration details that are necessary, so the ingress points to the correct url. + +## Start +Once Grafana is running it is accessible under https://cnoe.localtest.me/grafana. +Many preconfigured dashboards can be used by klicking the menu option Dashboards. + +### Adding your own dashboards +The application edfbuilder/kind/stacks/core/kube-prometheus.yaml is used to import new Loki dashboards. +Examples for imported dashboards can be found in the folder edfbuilder/kind/stacks/core/kube-prometheus/dashboards. + +It is possible to add your own dashboards: +Dashboards must be in JSON format. To add your own dashboard create a new ConfigMap in YAML format using onw of the examples as a blueprint. +The new dashboard in JSON format has to be added as the value for data.k8s-dashboard-[...].json like in the examples. diff --git a/content/en/docs/solution/tools/Kube-prometheus-stack/_index.md:Zone.Identifier b/content/en/docs/solution/tools/Kube-prometheus-stack/_index.md:Zone.Identifier new file mode 100644 index 0000000..e69de29 diff --git a/content/en/docs/solution/tools/Loki/_index.md b/content/en/docs/solution/tools/Loki/_index.md new file mode 100644 index 0000000..91945b3 --- /dev/null +++ b/content/en/docs/solution/tools/Loki/_index.md @@ -0,0 +1,10 @@ +--- +title: Loki +description: Grafana Loki is a scalable open-source log aggregation system +--- + +## Loki Overview + +The application Grafana Loki is started in edfbuilder/kind/stacks/core/loki.yaml. +Loki is started in microservices mode and contains the components ingester, distributor, querier, and query-frontend. +The Helm values file edfbuilder/kind/stacks/core/loki/values.yaml contains configuration values. diff --git a/content/en/docs/solution/tools/Loki/_index.md:Zone.Identifier b/content/en/docs/solution/tools/Loki/_index.md:Zone.Identifier new file mode 100644 index 0000000..e69de29 diff --git a/content/en/docs/solution/tools/Promtail/_index.md b/content/en/docs/solution/tools/Promtail/_index.md new file mode 100644 index 0000000..a5a1a81 --- /dev/null +++ b/content/en/docs/solution/tools/Promtail/_index.md @@ -0,0 +1,9 @@ +--- +title: Promtail +description: Grafana Promtail is an agent that ships logs to a Grafan Loki instance (log-shipper) +--- + +## Promtail Overview + +The application Grafana Promtail is started in edfbuilder/kind/stacks/core/promtail.yaml. +The Helm values file edfbuilder/kind/stacks/core/promtail/values.yaml contains configuration values. diff --git a/content/en/docs/solution/tools/Promtail/_index.md:Zone.Identifier b/content/en/docs/solution/tools/Promtail/_index.md:Zone.Identifier new file mode 100644 index 0000000..e69de29