Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/asl/ref/clamp-max.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ and handling occasional data spikes.
## Problem and Solution

The axis parameters for controlling [axis bounds](../../api/graph/axis-bounds.md) have limitations:

- They apply to everything on the axis and cannot target specific lines
- For data with occasional spikes, they can hide important details in the rest of the data

Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/cq.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ Apply a common application filter to an expression with multiple queries:
@@@

This transforms:

- `name,ssCpuUser,:eq` becomes `name,ssCpuUser,:eq,nf.app,alerttest,:eq,:and`
- `name,DiscoveryStatus_UP,:eq` becomes `name,DiscoveryStatus_UP,:eq,nf.app,alerttest,:eq,:and`

Expand Down
3 changes: 3 additions & 0 deletions docs/asl/ref/derivative.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ converting cumulative values back to rates or identifying trends in the data.
## Behavior

Each output value represents the difference between consecutive datapoints:

- `derivative[i] = input[i] - input[i-1]`
- The first datapoint will typically be NaN since there's no previous value
- Missing values (NaN) are handled as 0 for the calculation
Expand All @@ -32,11 +33,13 @@ Integral Then Derivative: /api/v1/graph?w=200&h=125&s=e-3h&e=2012-01-01T07:00&tz
## Relationship with Integral

`:derivative` and `:integral` have an asymmetric relationship:

- Applying `:integral` then `:derivative` approximates the original signal
- Applying `:derivative` then `:integral` does NOT restore the original signal

The derivative operation loses information that cannot be recovered with integral. For example,
with a constant input like `1`:

- `1,:derivative` produces `0` (derivative of constant is zero)
- `0,:integral` produces `0` (integral of zero stays zero)
- The original constant value `1` is permanently lost
Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/des-simple.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ the default values may not be optimal for all use cases.
## Default Configuration

This operator is equivalent to calling `:des` with these default parameters:

- **Training**: 10 data points
- **Alpha**: 0.1 (level smoothing factor)
- **Beta**: 0.5 (trend smoothing factor)
Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/div.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ Compute a new time series where each interval has the value `(a / b)` where `a`
and `b` are the corresponding intervals in the input time series.

Special handling for division by zero:

- If both `a` and `b` are 0, the result is 0 (instead of NaN)
- If only `b` (divisor) is 0, the result is NaN

Expand Down
2 changes: 2 additions & 0 deletions docs/asl/ref/eureka-avg.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ through Eureka.
## When to Use

This operator is specifically designed for scenarios where:

- Metrics represent incoming traffic routed through Eureka service discovery
- You want average per active instance, not per total deployed instance
- The goal is to measure per-node load for traffic-bearing services
Expand All @@ -47,6 +48,7 @@ Computing average requests per second per active instance:
## Infrastructure Tag Scoping

The operator automatically uses common tags to ensure the denominator matches the numerator scope:

- `nf.app` - Application name
- `nf.cluster` - Cluster identifier
- `nf.region` - AWS region
Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/limit.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ when dealing with large result sets.
## Selection Behavior

The limit operation selects the first N series based on the current ordering:

- If no sort is specified, series are ordered by legend text (alphabetical)
- If [:sort](sort.md) is used, series are ordered by the specified statistic
- The [:order](order.md) operation controls ascending vs. descending sort direction
Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/percentiles-heatmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ name,requestLatency,:eq,(,percentile,),:by,:heatmap
```

The resulting heatmap shows:

- **X-axis**: Time progression
- **Y-axis**: Percentile levels (P50, P90, P95, P99, etc.)
- **Color intensity**: Magnitude of values at each percentile/time combination
Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/sdes-simple.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ stability than the standard [:des-simple](des-simple.md) operator.
## Default Configuration

This operator is equivalent to calling `:sdes` with these default parameters:

- **Training**: 10 data points
- **Alpha**: 0.1 (level smoothing factor)
- **Beta**: 0.5 (trend smoothing factor)
Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/sdes.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ Result:
```

Where:

- **A**: Both functions wait for training window boundary
- **T1/T2**: Training phases for each function
- **P1/P2**: Prediction phases alternating between functions
Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/stddev.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ from the different time series in the group using the computational formula:
```

Where:

- `N` = number of non-NaN values at that timestamp
- `sum(x)` = sum of all time series values at that timestamp
- `sum(x²)` = sum of squared time series values at that timestamp
Expand Down
1 change: 1 addition & 0 deletions docs/asl/ref/time-span.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@ Absolute: /api/v1/graph?w=200&h=125&s=e-3h&e=2012-01-01T07:00&tz=UTC&q=2014-02-2
## Signal Output

The operator produces a signal time series where:

- **Value 1**: Time falls within the specified range [startTime, endTime]
- **Value 0**: Time falls outside the specified range
- This creates a boolean-like signal suitable for logical operations
Expand Down