Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions doc/source/configuration/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,4 @@ the various features provided.
:maxdepth: 1

release-train
monitoring
13 changes: 13 additions & 0 deletions doc/source/configuration/monitoring.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
========================
Monitoring Configuration
========================

StackHPC kayobe config includes a reference monitoring stack based on
Prometheus. Whilst this often works out of the box, there are some tunables
which can be customised to adapt the configuration to a particular deployment.

The configuration options can be found in
``etc/kayobe/stackhpc-monitoring.yml``:

.. literalinclude:: ../../../etc/kayobe/stackhpc-monitoring.yml
:language: yaml
2 changes: 1 addition & 1 deletion etc/kayobe/kolla/config/prometheus/system.rules
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ groups:
description: "{{ $labels.device }} is {{ $value }}% full."

- alert: LowMemory
expr: (node_memory_MemAvailable_bytes / 1024^3) < {{ alertmanager_low_memory_threshold_gib }}
expr: (node_memory_MemAvailable_bytes / 1024^3) < {% endraw %}{{ alertmanager_low_memory_threshold_gib }}{% raw %}
for: 1m
labels:
severity: alert
Expand Down
3 changes: 0 additions & 3 deletions etc/kayobe/kolla/globals.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,5 @@ bifrost_tag: xena-20221128T101757

es_heap_size: 8g
prometheus_cmdline_extras: "--storage.tsdb.retention.time=30d"
# Threshold to trigger a LowMemory alert in Gibibytes (GiB). When the amount
# of free memory is lower than this value an alert will be triggered.
alertmanager_low_memory_threshold_gib: 5

#############################################################################
11 changes: 11 additions & 0 deletions etc/kayobe/stackhpc-monitoring.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
# StackHPC monitoring configuration

###############################################################################
# Alert configuration

# Threshold to trigger a LowMemory alert in Gibibytes (GiB). When the amount
# of free memory is lower than this value an alert will be triggered.
alertmanager_low_memory_threshold_gib: 5

###############################################################################