Horizon UI
Data Retention
Path: /operate/ttl. Verb: ttl:read (granted by maintainer, operator, admin).
The Data Retention page shows how long the connected OAP keeps records and metrics. It is read-only; change retention in OAP configuration, then refresh Horizon.
What You See
The page has two sections:
| Section | What it means |
|---|---|
| Records | Event-style data such as traces, Zipkin traces, logs, and browser error logs. |
| Metrics | Aggregated metric tiers: minute, hour, day, and metadata when the OAP backend exposes it. |
Values are shown in days. A cold value means BanyanDB cold-stage retention. no cold stage means the connected OAP has no cold storage stage for that data class.
Requirements
- OAP query port reachable from Horizon.
- The logged-in user has
ttl:read. - OAP supports
getRecordsTTLandgetMetricsTTL.
If the page reports OAP unreachable, check oap.queryUrl and the network path to the query port.
During Operations
Use this page before changing dashboard time windows, alert retention, or storage sizing. If a user expects old traces or metrics and Horizon cannot find them, compare the requested time range with this page first.