Skip to content

Commit 4fd48e7

Browse files
committed
Add documentation for bins parameter limitation on timestamp fields
Signed-off-by: Kai Huang <[email protected]>
1 parent 3a75657 commit 4fd48e7

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

docs/user/ppl/cmd/bin.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -182,6 +182,8 @@ Automatically calculates the span using a mathematical O(1) algorithm to create
182182

183183
**Validation**: The bins parameter must be between 2 and 50000 (inclusive). Values outside this range will result in an error.
184184

185+
**Limitation**: The bins parameter on timestamp fields requires pushdown to be enabled. When pushdown is disabled, use the ``span`` parameter instead (e.g., ``bin @timestamp span=5m``).
186+
185187
The algorithm uses **mathematical optimization** instead of iteration for O(1) performance:
186188

187189
1. **Validate bins**: Ensure ``2 ≤ bins ≤ 50000``

0 commit comments

Comments
 (0)