|
2 | 2 |
|
3 | 3 | ## unreleased |
4 | 4 |
|
5 | | -## 3.0.0-rc.1 / 2024-11-11 |
| 5 | +## 3.0.0 / 2024-11-14 |
| 6 | + |
| 7 | +This release includes new features such as a brand new UI and UTF-8 support enabled by default. As this marks the first new major version in seven years, several breaking changes are introduced. The breaking changes are mainly around the removal of deprecated feature flags and CLI arguments, and the full list can be found below. For users that want to upgrade we recommend to read through our [migration guide](https://prometheus.io/docs/prometheus/3.0/migration/). |
6 | 8 |
|
7 | 9 | * [CHANGE] Set the `GOMAXPROCS` variable automatically to match the Linux CPU quota. Use `--no-auto-gomaxprocs` to disable it. The `auto-gomaxprocs` feature flag was removed. #15376 |
8 | 10 | * [CHANGE] Set the `GOMEMLIMIT` variable automatically to match the Linux container memory limit. Use `--no-auto-gomemlimit` to disable it. The `auto-gomemlimit` feature flag was removed. #15373 |
9 | | -* [FEATURE] OTLP receiver: Ability to skip UTF-8 normalization using `otlp.translation_strategy = NoUTF8EscapingWithSuffixes` configuration option. #15384 |
10 | | -* [BUGFIX] Scraping: Don't log errors on empty scrapes. #15357 |
11 | | -* [BUGFIX] UI: fix selector / series formatting for empty metric names. #15341 |
12 | | - |
13 | | -## 3.0.0-rc.0 / 2024-10-31 |
14 | | - |
15 | 11 | * [CHANGE] Scraping: Remove implicit fallback to the Prometheus text format in case of invalid/missing Content-Type and fail the scrape instead. Add ability to specify a `fallback_scrape_protocol` in the scrape config. #15136 |
16 | 12 | * [CHANGE] Remote-write: default enable_http2 to false. #15219 |
17 | 13 | * [CHANGE] Scraping: normalize "le" and "quantile" label values upon ingestion. #15164 |
18 | 14 | * [CHANGE] Scraping: config `scrape_classic_histograms` was renamed to `always_scrape_classic_histograms`. #15178 |
19 | 15 | * [CHANGE] Config: remove expand-external-labels flag, expand external labels env vars by default. #14657 |
20 | 16 | * [CHANGE] Disallow configuring AM with the v1 api. #13883 |
21 | | -* [ENHANCEMENT] Scraping, rules: handle targets reappearing, or rules moving group, when out-of-order is enabled. #14710 |
22 | | -* [ENHANCEMENT] Tools: add debug printouts to promtool rules unit testing #15196 |
23 | | -* [ENHANCEMENT] Scraping: support Created-Timestamp feature on native histograms. #14694 |
24 | | -* [BUGFIX] PromQL: Fix stddev+stdvar aggregations to always ignore native histograms. #14941 |
25 | | -* [BUGFIX] PromQL: Fix stddev+stdvar aggregations to treat Infinity consistently. #14941 |
26 | | -* [BUGFIX] OTLP receiver: Preserve colons when generating metric names in suffix adding mode (this mode is always enabled, unless one uses Prometheus as a library). #15251 |
27 | | - |
28 | | -## 3.0.0-beta.1 / 2024-10-09 |
29 | | - |
30 | 17 | * [CHANGE] regexp `.` now matches all characters (performance improvement). #14505 |
31 | 18 | * [CHANGE] `holt_winters` is now called `double_exponential_smoothing` and moves behind the [experimental-promql-functions feature flag](https://prometheus.io/docs/prometheus/latest/feature_flags/#experimental-promql-functions). #14930 |
32 | 19 | * [CHANGE] API: The OTLP receiver endpoint can now be enabled using `--web.enable-otlp-receiver` instead of `--enable-feature=otlp-write-receiver`. #14894 |
33 | 20 | * [CHANGE] Prometheus will not add or remove port numbers from the target address. `no-default-scrape-port` feature flag removed. #14160 |
34 | 21 | * [CHANGE] Logging: the format of log lines has changed a little, along with the adoption of Go's Structured Logging package. #14906 |
35 | | -* [CHANGE] Don't create extra `_created` timeseries if feature-flag `created-timestamp-zero-ingestion' is enabled. #14738 |
| 22 | +* [CHANGE] Don't create extra `_created` timeseries if feature-flag `created-timestamp-zero-ingestion` is enabled. #14738 |
36 | 23 | * [CHANGE] Float literals and time durations being the same is now a stable fetaure. #15111 |
| 24 | +* [CHANGE] UI: The old web UI has been replaced by a completely new one that is less cluttered and adds a few new features (PromLens-style tree view, better metrics explorer, "Explain" tab). However, it is still missing some features of the old UI (notably, exemplar display and heatmaps). To switch back to the old UI, you can use the feature flag `--enable-feature=old-ui` for the time being. #14872 |
| 25 | +* [CHANGE] PromQL: Range selectors and the lookback delta are now left-open, i.e. a sample coinciding with the lower time limit is excluded rather than included. #13904 |
| 26 | +* [CHANGE] Kubernetes SD: Remove support for `discovery.k8s.io/v1beta1` API version of EndpointSlice. This version is no longer served as of Kubernetes v1.25. #14365 |
| 27 | +* [CHANGE] Kubernetes SD: Remove support for `networking.k8s.io/v1beta1` API version of Ingress. This version is no longer served as of Kubernetes v1.22. #14365 |
| 28 | +* [CHANGE] UTF-8: Enable UTF-8 support by default. Prometheus now allows all UTF-8 characters in metric and label names. The corresponding `utf8-name` feature flag has been removed. #14705 |
| 29 | +* [CHANGE] Console: Remove example files for the console feature. Users can continue using the console feature by supplying their own JavaScript and templates. #14807 |
| 30 | +* [CHANGE] SD: Enable the new service discovery manager by default. This SD manager does not restart unchanged discoveries upon reloading. This makes reloads faster and reduces pressure on service discoveries' sources. The corresponding `new-service-discovery-manager` feature flag has been removed. #14770 |
| 31 | +* [CHANGE] Agent mode has been promoted to stable. The feature flag `agent` has been removed. To run Prometheus in Agent mode, use the new `--agent` cmdline arg instead. #14747 |
| 32 | +* [CHANGE] Remove deprecated `remote-write-receiver`,`promql-at-modifier`, and `promql-negative-offset` feature flags. #13456, #14526 |
| 33 | +* [CHANGE] Remove deprecated `storage.tsdb.allow-overlapping-blocks`, `alertmanager.timeout`, and `storage.tsdb.retention` flags. #14640, #14643 |
| 34 | +* [FEATURE] OTLP receiver: Ability to skip UTF-8 normalization using `otlp.translation_strategy = NoUTF8EscapingWithSuffixes` configuration option. #15384 |
| 35 | +* [FEATURE] Support config reload automatically - feature flag `auto-reload-config`. #14769 |
| 36 | +* [ENHANCEMENT] Scraping, rules: handle targets reappearing, or rules moving group, when out-of-order is enabled. #14710 |
| 37 | +* [ENHANCEMENT] Tools: add debug printouts to promtool rules unit testing #15196 |
| 38 | +* [ENHANCEMENT] Scraping: support Created-Timestamp feature on native histograms. #14694 |
37 | 39 | * [ENHANCEMENT] UI: Many fixes and improvements. #14898, #14899, #14907, #14908, #14912, #14913, #14914, #14931, #14940, #14945, #14946, #14972, #14981, #14982, #14994, #15096 |
38 | 40 | * [ENHANCEMENT] UI: Web UI now displays notifications, e.g. when starting up and shutting down. #15082 |
39 | 41 | * [ENHANCEMENT] PromQL: Introduce exponential interpolation for native histograms. #14677 |
40 | 42 | * [ENHANCEMENT] TSDB: Add support for ingestion of out-of-order native histogram samples. #14850, #14546 |
41 | 43 | * [ENHANCEMENT] Alerts: remove metrics for removed Alertmanagers. #13909 |
42 | 44 | * [ENHANCEMENT] Kubernetes SD: Support sidecar containers in endpoint discovery. #14929 |
43 | 45 | * [ENHANCEMENT] Consul SD: Support catalog filters. #11224 |
| 46 | +* [ENHANCEMENT] Move AM discovery page from "Monitoring status" to "Server status". #14875 |
44 | 47 | * [PERF] TSDB: Parallelize deletion of postings after head compaction. #14975 |
45 | 48 | * [PERF] TSDB: Chunk encoding: shorten some write sequences. #14932 |
46 | 49 | * [PERF] TSDB: Grow postings by doubling. #14721 |
47 | 50 | * [PERF] Relabeling: Optimize adding a constant label pair. #12180 |
| 51 | +* [BUGFIX] Scraping: Don't log errors on empty scrapes. #15357 |
| 52 | +* [BUGFIX] UI: fix selector / series formatting for empty metric names. #15341 |
| 53 | +* [BUGFIX] PromQL: Fix stddev+stdvar aggregations to always ignore native histograms. #14941 |
| 54 | +* [BUGFIX] PromQL: Fix stddev+stdvar aggregations to treat Infinity consistently. #14941 |
| 55 | +* [BUGFIX] OTLP receiver: Preserve colons when generating metric names in suffix adding mode (this mode is always enabled, unless one uses Prometheus as a library). #15251 |
48 | 56 | * [BUGFIX] Scraping: Unit was missing when using protobuf format. #15095 |
49 | 57 | * [BUGFIX] PromQL: Only return "possible non-counter" annotation when `rate` returns points. #14910 |
50 | 58 | * [BUGFIX] TSDB: Chunks could have one unnecessary zero byte at the end. #14854 |
51 | 59 | * [BUGFIX] "superfluous response.WriteHeader call" messages in log. #14884 |
52 | 60 | * [BUGFIX] PromQL: Unary negation of native histograms. #14821 |
53 | 61 | * [BUGFIX] PromQL: Handle stale marker in native histogram series (e.g. if series goes away and comes back). #15025 |
54 | 62 | * [BUGFIX] Autoreload: Reload invalid yaml files. #14947 |
55 | | - |
56 | | -## 3.0.0-beta.0 / 2024-09-05 |
57 | | - |
58 | | -Release 3.0.0-beta.0 includes new features such as a brand new UI and UTF-8 support enabled by default. As a new major version, several breaking changes are introduced. The breaking changes are mainly around the removal of deprecated feature flags and CLI arguments, and the full list can be found below. Most users should be able to try this release out of the box without any configuration changes. |
59 | | - |
60 | | -As is traditional with a beta release, we do **not** recommend users install 3.0.0-beta on critical production systems, but we do want everyone to test it out and find bugs. |
61 | | - |
62 | | -* [CHANGE] UI: The old web UI has been replaced by a completely new one that is less cluttered and adds a few new features (PromLens-style tree view, better metrics explorer, "Explain" tab). However, it is still missing some features of the old UI (notably, exemplar display and heatmaps). To switch back to the old UI, you can use the feature flag `--enable-feature=old-ui` for the time being. #14872 |
63 | | -* [CHANGE] PromQL: Range selectors and the lookback delta are now left-open, i.e. a sample coinciding with the lower time limit is excluded rather than included. #13904 |
64 | | -* [CHANGE] Kubernetes SD: Remove support for `discovery.k8s.io/v1beta1` API version of EndpointSlice. This version is no longer served as of Kubernetes v1.25. #14365 |
65 | | -* [CHANGE] Kubernetes SD: Remove support for `networking.k8s.io/v1beta1` API version of Ingress. This version is no longer served as of Kubernetes v1.22. #14365 |
66 | | -* [CHANGE] UTF-8: Enable UTF-8 support by default. Prometheus now allows all UTF-8 characters in metric and label names. The corresponding `utf8-name` feature flag has been removed. #14705 |
67 | | -* [CHANGE] Console: Remove example files for the console feature. Users can continue using the console feature by supplying their own JavaScript and templates. #14807 |
68 | | -* [CHANGE] SD: Enable the new service discovery manager by default. This SD manager does not restart unchanged discoveries upon reloading. This makes reloads faster and reduces pressure on service discoveries' sources. The corresponding `new-service-discovery-manager` feature flag has been removed. #14770 |
69 | | -* [CHANGE] Agent mode has been promoted to stable. The feature flag `agent` has been removed. To run Prometheus in Agent mode, use the new `--agent` cmdline arg instead. #14747 |
70 | | -* [CHANGE] Remove deprecated `remote-write-receiver`,`promql-at-modifier`, and `promql-negative-offset` feature flags. #13456, #14526 |
71 | | -* [CHANGE] Remove deprecated `storage.tsdb.allow-overlapping-blocks`, `alertmanager.timeout`, and `storage.tsdb.retention` flags. #14640, #14643 |
72 | | -* [ENHANCEMENT] Move AM discovery page from "Monitoring status" to "Server status". #14875 |
73 | | -* [FEATURE] Support config reload automatically - feature flag `auto-reload-config`. #14769 |
74 | 63 | * [BUGFIX] Scrape: Do not override target parameter labels with config params. #11029 |
75 | 64 |
|
76 | 65 | ## 2.55.0 / 2024-10-22 |
|
0 commit comments