Limits
Rate limits and size limits for traces sent to Recount, and what the SDK does when a trace is over them.
Rate limits are enforced per IP address using a 5-minute rolling window.
| Endpoint | Limit | Response |
|---|
Trace ingest (/ingest) | 2,000 requests / 5 min | 429 Too Many Requests |
When a 429 is returned, the SDK drops the trace silently - no error is thrown and your application continues normally.
If you need a higher limit, get in touch.
| Limit | Response |
|---|
| 256 KB per request | 413 Payload Too Large |
This is a total-body limit across the whole trace (name, metadata, and every span combined) - it's independent of the per-field limits below, which bound individual values within that budget.
| Field | Limit |
|---|
name | 5–500 characters |
durationMs | Max 86,400,000 ms (24 hours) |
spans | 1–500 non-group spans per trace |
metadata keys | Max 10 keys, each key max 64 characters |
metadata values | Max 256 characters (strings) |
These limits apply to every span type unless noted.
| Field | Limit |
|---|
name | 5–500 characters |
durationMs | Max 86,400,000 ms (24 hours) |
alerts | Max 10 per span |
Group spans do not count toward the per-trace span limit. Only non-group spans (and their children) are counted.
| Field | Limit |
|---|
| Columns | Max 50 |
| Rows | Max 500 |
| Cells per row | Max 50 |
| Column label | Max 256 characters |
| Summary stats | Max 20 |
| Summary text | Max 512 characters |
| Field | Limit |
|---|
| Labels | Max 1,000 |
| Series | Max 20 |
| Data points | Max 1,000 per series |
| Reference lines | Max 20 |
| Field | Limit |
|---|
prompt | Max 65,536 characters |
system | Max 65,536 characters |
messages | Max 200 |
| Message content | Max 65,536 characters |
response | Max 65,536 characters (string) |
provider | Max 128 characters |
model | Max 128 characters |
| Field | Limit |
|---|
url | Max 2,048 characters |
| Headers | Max 50 entries |
| Header name | Max 256 characters |
| Header value | Max 1,024 characters |
| Body | Max 65,536 characters |
| Field | Limit |
|---|
query | Max 10,000 characters |
params | Max 100 entries |
| Param string value | Max 1,024 characters |
| Field | Limit |
|---|
url | Max 2,048 characters |
label | Max 256 characters |
| Field | Limit |
|---|
text | Max 2,048 characters |
| Field | Limit |
|---|
label | Max 128 characters |
checks | 1–200 per alert |
target | Max 256 characters |
