Skip to main content
Version: 0.16

Management

Traces, metrics, and log entries are runtime telemetry records produced by the server and retained according to the configured telemetry history. The existing Live telemetry page covers real-time streaming, and the History page covers the backends and retention windows that persist this data. Once persisted, the records themselves are accessible as management objects through the WebUI, the CLI, and the JMAP API.

Traces

A Trace (found in the WebUI under Management › Emails › History › Inbound Delivery, Management › Emails › History › Outbound Delivery) represents a single message-delivery trace with its associated events: inbound reception, queueing, outbound delivery attempts, and the outcome of each hop. Traces are retrievable by id, filterable by account, remote host, domain, and time range, and are primarily surfaced through the History view of the WebUI. Retention is governed by holdTracesFor on the DataRetention object.

Enterprise feature

This object is available exclusively in the Enterprise Edition of Stalwart and is not included in the Community Edition.

Metrics

A Metric is a single sampled data point of a server metric (counter, gauge, or histogram variants). Samples are collected on the schedule defined by metricsCollectionInterval and retained for the duration given by holdMetricsFor. Queries support filtering by metric name and time range and drive the Dashboard charts in the WebUI.

Individual samples are consumed by the Dashboard in the WebUI and do not have a dedicated inspection surface; administrators who need raw samples can fetch them through the CLI or the JMAP API.

Enterprise feature

This object is available exclusively in the Enterprise Edition of Stalwart and is not included in the Community Edition.

Logs

A Log (found in the WebUI under Management › Observability › Logs) is a server log entry captured by the tracing subsystem and persisted to the history store. Unlike traces and metrics, log access is available in the Community Edition. Entries carry a timestamp, level, and the structured keys documented on the Events page, and can be queried through the same management surfaces.