Patrick.Sy/website-and-documentation
1
0
Fork 0
forked from DevFW-CICD/website-and-documentation
Code Pull requests Activity

Merge remote-tracking branch 'refs/remotes/ipceicis-dev/main'

Browse source
This commit is contained in:
Stephan Lo 2024-11-29 09:00:58 +01:00
commit 1b77a80563
3 changed files with 50 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

31
content/en/docs/solution/tools/Kube-prometheus-stack/_index.md Normal file
View file

@ -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.

10
content/en/docs/solution/tools/Loki/_index.md Normal file
View file

@ -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.

9
content/en/docs/solution/tools/Promtail/_index.md Normal file
View file

@ -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.