mirror of
https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk.git
synced 2025-12-06 23:41:43 +01:00
76 lines
2.4 KiB
Markdown
76 lines
2.4 KiB
Markdown
<!--
|
||
SPDX-FileCopyrightText: 2023 Bundesministerium des Innern und für Heimat, PG ZenDiS "Projektgruppe für Aufbau ZenDiS"
|
||
SPDX-License-Identifier: Apache-2.0
|
||
-->
|
||
|
||
<h1>Monitoring</h1>
|
||
|
||
This document will cover how you can enable observability with Prometheus-based monitoring and Grafana dashboards as
|
||
well as the overall status of monitoring integration.
|
||
|
||
<!-- TOC -->
|
||
* [Technology](#technology)
|
||
* [Defaults](#defaults)
|
||
* [Metrics](#metrics)
|
||
* [Alerts](#alerts)
|
||
* [Dashboards for Grafana](#dashboards-for-grafana)
|
||
* [Components](#components)
|
||
<!-- TOC -->
|
||
|
||
# Technology
|
||
|
||
We provide integration into the Prometheus-based monitoring.
|
||
Together with
|
||
[kube-prometheus-stack](https://github.com/prometheus-community/helm-charts/tree/main/charts/kube-prometheus-stack) you
|
||
easily leverage the full potential of the open-source cloud-native observability stack.
|
||
|
||
Before enabling the following options, you need to install the respective CRDs from the kube-prometheus-stack
|
||
repository or Prometheus operator.
|
||
|
||
# Defaults
|
||
|
||
All configurable options and their defaults can be found in
|
||
[`monitoring.yaml`](../helmfile/environments/default/monitoring.yaml).
|
||
|
||
# Metrics
|
||
|
||
To deploy `podMonitor` and `serviceMonitor` custom resources, enable it by:
|
||
|
||
```yaml
|
||
prometheus:
|
||
serviceMonitors:
|
||
enabled: true
|
||
podMonitors:
|
||
enabled: true
|
||
```
|
||
|
||
# Alerts
|
||
|
||
openDesk ships with a set of Prometheus alerting rules that are specific to the operation of openDesk.
|
||
Some of these are created by our partners while others are defined in [opendesk-alerts](https://gitlab.opencode.de/bmi/opendesk/components/platform-development/charts/opendesk-alerts).
|
||
|
||
All alert rules are deployed as [PrometheusRule](https://prometheus-operator.dev/docs/api-reference/api/#monitoring.coreos.com/v1.PrometheusRule) and can be enabled like this:
|
||
|
||
```yaml
|
||
prometheus:
|
||
prometheusRules:
|
||
enabled: true
|
||
```
|
||
|
||
# Dashboards for Grafana
|
||
|
||
To deploy optional ConfigMaps with Grafana dashboards, enable it by:
|
||
|
||
```yaml
|
||
grafana:
|
||
dashboards:
|
||
enabled: true
|
||
```
|
||
|
||
# Components
|
||
|
||
| Component | Metrics (pod- or serviceMonitor) | Alerts (prometheusRule) | Dashboard (Grafana) |
|
||
|:----------|-----------------------------------|-------------------------|---------------------|
|
||
| Collabora | :white_check_mark: | :white_check_mark: | :white_check_mark: |
|
||
| Nextcloud | :white_check_mark: | :x: | :x: |
|