{# steward/templates/settings/thresholds.html — tunable degraded/critical cutoffs #} {% extends "base.html" %} {% block title %}Settings — Thresholds & Retention — Steward{% endblock %} {% block content %} {% set active_tab = "thresholds" %} {% include "settings/_tabs.html" %} {% macro pair(label, warn_field, warn_key, crit_field, crit_key, unit, hint, step="1") %}
warn crit
{% if hint %}
{{ hint }}
{% endif %}
{% endmacro %}

Monitoring thresholds

Values at or beyond warn show amber; at or beyond crit show red — across dashboard widgets and host views. Higher is worse for everything except uptime, where the cutoffs are floors.

{{ pair("CPU usage", "cpu_warn", "thresholds.cpu_warn", "cpu_crit", "thresholds.cpu_crit", "%", "Average CPU utilization per host.") }} {{ pair("Memory usage", "mem_warn", "thresholds.mem_warn", "mem_crit", "thresholds.mem_crit", "%", "Memory in use per host.") }} {{ pair("Disk usage", "disk_warn", "thresholds.disk_warn", "disk_crit", "thresholds.disk_crit", "%", "Filesystem usage.") }} {{ pair("Load", "load_warn", "thresholds.load_warn", "load_crit", "thresholds.load_crit", "% per core", "Load average normalized by core count (100% = one full core per core).") }} {{ pair("Temperature", "temp_warn", "thresholds.temp_warn", "temp_crit", "thresholds.temp_crit", "°C", "Hottest reported sensor per host.") }} {{ pair("Ping latency", "latency_warn", "ping.threshold.good_ms", "latency_crit", "ping.threshold.warn_ms", "ms", "Round-trip time. Shared with the Ping widget's good/warn colouring.") }} {{ pair("Uptime / SLA", "uptime_warn", "thresholds.uptime_warn", "uptime_crit", "thresholds.uptime_crit", "%", "Lower is worse — amber below warn, red below crit.", step="0.1") }}
{% macro days(label, field, key, hint) %}
{% if hint %}
{{ hint }}
{% endif %}
{% endmacro %}

Docker data retention

Bounds how much Docker history is stored. Raw per-sample container metrics are kept for the raw window, then rolled up into hourly averages kept for the rollup window; lifecycle events are kept for the events window. Applied by the hourly cleanup task — a change takes effect on its next run.

{{ days("Raw metrics", "docker_metrics_raw_days", "docker.retention.metrics_raw_days", "Keep per-sample container CPU/memory points this long, then roll up to hourly.") }} {{ days("Rolled-up metrics", "docker_metrics_rollup_days", "docker.retention.metrics_rollup_days", "Keep the hourly-averaged series this long for multi-day history.") }} {{ days("Lifecycle events", "docker_events_days", "docker.retention.events_days", "Keep container start/stop/die/health history this long.") }}

Host metrics retention

Bounds how much host-agent metric history is stored (CPU, memory, disk, network, temps, …). Raw per-sample points are kept for the raw window, then rolled up into hourly averages kept for the rollup window. Host charts read raw for the recent part of a range and hourly for older data. Applied by the hourly cleanup.

{{ days("Raw metrics", "metrics_raw_days", "metrics.retention.raw_days", "Keep per-sample host metrics this long, then roll up to hourly averages.") }} {{ days("Rolled-up metrics", "metrics_rollup_days", "metrics.retention.rollup_days", "Keep the hourly-averaged series this long for multi-week history.") }}
Takes effect immediately — no restart.
{% endblock %}