Limits for Logs
Last updated on
To ensure consistent performance and reliability for all users, STACKIT Logs enforces specific limits on data ingestion, metadata, and querying.
Ingestion limits
Section titled “Ingestion limits”These limits define how much data you can send to STACKIT Logs instance and the constraints on the individual log lines.
| Limit | Value | Description |
|---|---|---|
| Ingestion Rate | 10 MB/s | The maximum amount of compressed log data allowed per second. The instance returns a 429 Too Many Requests error on exceeding the limit. Open a support ticket in the Help Center to request an increase. |
| Per Stream Rate Limit | 3 MB/s | The maximum byte rate per second per log stream (a unique set of labels). See the Grafana Loki documentation for more details. |
| Max Line Size | 256 KB | The maximum size of a single log line. Lines exceeding this limit are rejected. |
| Old Sample Rejection | 7 days | STACKIT Logs rejects logs with a timestamp older than 7 days relative to the current time. |
Metadata and label limits
Section titled “Metadata and label limits”These limits define the number of labels you can attach to log lines and the constraints on them. Labels are the keys and values used to index your logs. Efficient use of labels is critical for query performance.
| Limit | Value | Description |
|---|---|---|
| Max Labels | 15 | The maximum number of unique label names allowed per log stream. |
| Label Name Length | 1024 chars | The maximum length allowed for a label name (key). |
| Label Value Length | 2048 chars | The maximum length allowed for a label value. |
Why limit labels?
Section titled “Why limit labels?”STACKIT Logs is based on Loki which is designed to be “metadata light.” Unlike traditional databases, STACKIT Logs does not index the full text of logs, but only the labels. An excessive number of labels (high cardinality) significantly slows down the index and increases memory usage.
See the documentation for more details about labels.
Structured metadata limits
Section titled “Structured metadata limits”With structured metadata, you can attach additional context to log lines without the performance penalty of traditional labels.
| Limit | Value | Description |
|---|---|---|
| Max Metadata Size | 64 KB | The total size limit for all structured metadata fields combined. |
| Max Metadata Count | 128 keys | The maximum number of structured metadata fields per log line. |
What is structured metadata?
Section titled “What is structured metadata?”Structured metadata is ideal for high-cardinality data (like request_id or user_id) that you want to attach to a log line for filtering,
but which shouldn’t be part of the main index labels.
See the documentation for more details about structured metadata.
Query limits
Section titled “Query limits”These limits apply when you are retrieving log data through the STACKIT Logs API e.g. inside the Grafana dashboard.
| Limit | Value | Description |
|---|---|---|
| Max Query Range | 30 days | The maximum time window allowed for a single query (e.g., searching from now-30d to now). |