Skip to content

Commit 8a30170

Browse files
committed
docs: Add ingestion troubleshooting topic
1 parent 448cc74 commit 8a30170

File tree

3 files changed

+1251
-0
lines changed

3 files changed

+1251
-0
lines changed

docs/sources/configure/bp-configure.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,3 +81,50 @@ Loki and Promtail have flags which will dump the entire config object to stderr
8181
`-print-config-stderr` works well when invoking Loki from the command line, as you can get a quick output of the entire Loki configuration.
8282

8383
`-log-config-reverse-order` is the flag Grafana runs Loki with in all our environments. The configuration entries are reversed, so that the order of the configuration reads correctly top to bottom when viewed in Grafana's Explore.
84+
85+
## Recommended production limits
86+
87+
```yaml
88+
limits_config:
89+
# Rate limits
90+
ingestion_rate_strategy: global
91+
ingestion_rate_mb: 10
92+
ingestion_burst_size_mb: 20
93+
per_stream_rate_limit: 3MB
94+
per_stream_rate_limit_burst: 15MB
95+
96+
# Stream limits
97+
max_global_streams_per_user: 10000
98+
max_streams_per_user: 0
99+
100+
# Validation
101+
max_line_size: 256KB
102+
max_line_size_truncate: false
103+
max_label_name_length: 1024
104+
max_label_value_length: 2048
105+
max_label_names_per_series: 15
106+
107+
# Time constraints
108+
reject_old_samples: true
109+
reject_old_samples_max_age: 168h # 7 days
110+
creation_grace_period: 10m
111+
unordered_writes: true
112+
```
113+
114+
## Ingester configuration
115+
116+
```yaml
117+
ingester:
118+
# Chunk settings
119+
chunk_idle_period: 30m
120+
chunk_target_size: 1572864 # 1.5 MB
121+
chunk_encoding: snappy
122+
max_chunk_age: 2h
123+
124+
# WAL settings
125+
wal:
126+
enabled: true
127+
dir: /loki/wal
128+
checkpoint_duration: 5m
129+
flush_on_shutdown: true
130+
```
File renamed without changes.

0 commit comments

Comments
 (0)