Sitelet https://maple.dev/docs/reference/limits/
Skip to content
Maple Docs
Open app
Browse the docs
On this page

Limits

Every limit in one place: ingest request size and concurrency, query time ranges, raw SQL, alert rules, event fields, and API and MCP rate limits.

The limits Maple enforces, grouped by where you would hit them. Each links to the page that explains the behavior in full.

Ingest

See Ingest API for status codes and retry guidance.

LimitValueOver the limit
Request body20 MiB, measured compressed413
Request duration30 seconds503, retry after 5 s
Concurrent requests1,000 in flight per organization429, retry after 1 s
Compressiongzip only415
Session replay1 GiB of uncompressed data per recordingRecording stops at the limit

Product events and session events

See Product events API. An event that breaks a dropped rule is discarded silently; the rest of the batch is still stored. Other fields are truncated to their limit.

FieldLimitOver the limit
Event name128 bytes; no $ prefix except $screenDropped
Event timestamp30 days in the past to 1 day in the futureDropped
User, visitor, session and group IDs256 bytesTruncated
Page path1 KiBTruncated
URL2 KiBTruncated
Session event message1 KiBTruncated
Session event attributes32 per event; keys 64 bytes, values 1 KiBTruncated

Queries

The dashboard, the API and the MCP tools share these limits. Queries time out after 30 seconds.

QueryLongest time range
Charts and time series31 days
Trace and log lists7 days
Breakdowns (top-N by service, route, …)30 days
Breakdowns with no filter24 hours
Attribute and metric discovery30 days
Log pattern mining24 hours

A time series returns at most 1,500 points. Bucket width is chosen from the range, from 1 minute up to 1 day.

Raw SQL

See SQL reference.

LimitValue
Query text32,768 characters
Rows returned1,000 (more is an error)
Result size5 MB of JSON; 64,000 characters per cell
Execution time10 seconds; 5 seconds inside an alert rule

Alert rules

LimitValue
Evaluation window1 minute to 24 hours
Check intervalEvery minute
Groups per raw-SQL alert100
Tags per rule20, up to 32 characters each
Notification template4,000 characters for the title and for the body
Webhook response time15 seconds
Webhook delivery attempts5

API and MCP rate limits

SurfaceLimitOver the limit
Maple API (/v2)600 requests per 60 seconds per key429, Retry-After: 60
MCP server requests120 per 10 seconds per key or user429, Retry-After: 10
API list pageslimit 1 to 100, default 20400

Rate limits are counted per edge location, so treat them as approximate rather than an exact global budget.