Skip to main content

Limits and defaults

Hard limits, soft limits and default sizes: queue lengths, timeouts, retention.

The numbers you can ignore until scale finds them. The full set is in Configuration reference.

HTTP​

ItemDefaultKey
Request body limit64 MiB[HTTP] MaxContentLength
Read timeout20s[HTTP] ReadTimeout
Write timeout40s[HTTP] WriteTimeout
Idle timeout120s[HTTP] IdleTimeout
Graceful shutdown30s[HTTP] ShutdownTimeout

Bulk-importing alert rules or a large dashboard JSON is what usually meets the body limit first.

Metadata database​

ItemDefaultKey
Max open connections150[DB] MaxOpenConns
Max idle connections50[DB] MaxIdleConns
Max connection lifetime7200s[DB] MaxLifetime

Multiply by the number of instances and stay under the database's own max_connections.

Embedded TSDB​

ItemDefaultKey
Retention15d[EmbeddedTSDB] RetentionDuration
Disk cap10 GiB[EmbeddedTSDB] MaxBytes
Query timeout1m[EmbeddedTSDB] QueryTimeout

Past MaxBytes, the oldest blocks are deleted first.

The real limit is not any of these numbers: it is that the data lives on one Center process's local disk, so several replicas each hold a fragment. Useful to roughly 100k active series; past that, use an external store. See Embedded TSDB single-Center limits.

Ingest and forwarding​

ItemDefaultKey
Forward queue length1000000[Pushgw] QueueMaxSize
Forward request timeout10000ms[[Pushgw.Writers]] Timeout
Dial timeout3000ms[[Pushgw.Writers]] DialTimeout

A full queue drops data. A queue length that keeps climbing toward the cap means the downstream TSDB cannot keep up; watching n9e_alert_alert_queue_size and friends catches it earlier — see Built-in metrics.

Rule evaluation​

ItemDefaultWhere
Execution frequency@every 60sRule form
For duration60sRule form
Recover duration0 (immediate)Rule form
Repeat interval60 minutesRule form
Max send times0 (unlimited)Rule form

Data retention​

DataKept forKey
Notification records7 days[Center] CleanNotifyRecordDay
Workflow execution records7 daysbuilt into the cleanup job
Embedded TSDB samples15 days[EmbeddedTSDB] RetentionDuration
Historical alert eventsforever by default[Center] CleanAlertHisEventDay

Historical alert events are kept forever unless you say otherwise. The knob exists but ships commented out, and <= 0 means keep forever. Set CleanAlertHisEventDay to a number of days and a daily 02:00 job deletes older events in batches — otherwise plan for that table's growth.