|
|
|
|
@ -54,17 +54,13 @@ This document offers guidance on migrating from Prometheus 2.x to Prometheus 3.0 |
|
|
|
|
|
|
|
|
|
- The `.` pattern in regular expressions in PromQL matches newline characters. |
|
|
|
|
With this change a regular expressions like `.*` matches strings that include |
|
|
|
|
`\n`. This applies to matchers in queries and relabel configs. For example the |
|
|
|
|
following regular expressions now match the accompanying strings, whereas in |
|
|
|
|
Prometheus v2 these combinations didn't match. |
|
|
|
|
|
|
|
|
|
| Regex | Additional matches | |
|
|
|
|
| ----- | ------ | |
|
|
|
|
| ".*" | "foo\n", "Foo\nBar" | |
|
|
|
|
| "foo.?bar" | "foo\nbar" | |
|
|
|
|
| "foo.+bar" | "foo\nbar" | |
|
|
|
|
|
|
|
|
|
If you want Prometheus v3 to behave like v2 did, you will have to change your |
|
|
|
|
`\n`. This applies to matchers in queries and relabel configs. |
|
|
|
|
- For example, the following regular expressions now match the accompanying |
|
|
|
|
strings, whereas in Prometheus v2 these combinations didn't match. |
|
|
|
|
- `.*` additionally matches `foo\n` and `Foo\nBar` |
|
|
|
|
- `foo.?bar` additionally matches `foo\nbar` |
|
|
|
|
- `foo.+bar` additionally matches `foo\nbar` |
|
|
|
|
- If you want Prometheus v3 to behave like v2, you will have to change your |
|
|
|
|
regular expressions by replacing all `.` patterns with `[^\n]`, e.g. |
|
|
|
|
`foo[^\n]*`. |
|
|
|
|
- Lookback and range selectors are left open and right closed (previously left |
|
|
|
|
@ -73,11 +69,11 @@ This document offers guidance on migrating from Prometheus 2.x to Prometheus 3.0 |
|
|
|
|
timeseries with evenly spaced samples exactly 1 minute apart. Before Prometheus |
|
|
|
|
v3, a range query with `5m` would usually return 5 samples. But if the query |
|
|
|
|
evaluation aligns perfectly with a scrape, it would return 6 samples. In |
|
|
|
|
Prometheus v3 queries like this will always return 5 samples. |
|
|
|
|
Prometheus v3 queries like this will always return 5 samples. |
|
|
|
|
This change has likely few effects for everyday use, except for some subquery |
|
|
|
|
use cases. |
|
|
|
|
use cases. |
|
|
|
|
Query front-ends that align queries usually align subqueries to multiples of |
|
|
|
|
the step size. These subqueries will likely be affected. |
|
|
|
|
the step size. These subqueries will likely be affected. |
|
|
|
|
Tests are more likely to affected. To fix those either adjust the expected |
|
|
|
|
number of samples or extend the range by less than one sample interval. |
|
|
|
|
- The `holt_winters` function has been renamed to `double_exponential_smoothing` |
|
|
|
|
|