Note

This release builds with Golang v1.23.3
This release builds with k8s.io/client-go: v0.31.2
This release removes kube_endpoint_address_not_ready and kube_endpoint_address_available which have been deprecated in 2022. Please use kube_endpoint_addressas a replacement.

New changes, features and fixes

• [BUGFIX] Use --track-unscheduled-pods to select unscheduled pods in Daemonset sharding by @CatherineF-dev in #2388
• [BUGFIX] Install tools so VERSION gets set by @mrueg in #2456
• [BUGFIX] Syntax errors in kube-state-metrics.libsonnet by @jeffmccune in #2454
• [BUGFIX] Set kube_job_status_failed metric even when there are no job.Status.Conditions present by @richabanker in #2485
• [BUGFIX] de-duplication of custom resource metrics by @bartlettc22 in #2502
• [BUGFIX] Configure sharding every time MetricsHandler.Run runs by @wallee94 in #2478
• [BUGFIX] Panic in util.GVRFromType for core objects by @L3n41c in #2535
• [BUGFIX] Big memory value overflow by @leiwingqueen in #2540
• [BUGFIX] Expose empty labels by @mrueg in #2539
• [BUGFIX] CustomResourceMetrics: Convert status condition Unknown to a valid value by @Haleygo in #2536
• [CHANGE] Remove deprecated endpoint address metric by @mrueg in #2527
• [FEATURE] Add new metric kube_job_status_suspended by @Indresh2410 in #2542
• [FEATURE] Move endpoint ports into address metric by @mrueg in #2503
• [ENHANCEMENT] Use concurrent map when storing metrics by @rarruda in #2510

Full Changelog

• chore: Merge release branch back to main by @mrueg in #2450
• ci: missing line break escape on sbom workflow by @ricardoapl in #2451
• fix: use --track-unscheduled-pods to select unscheduled pods in Daemonset sharding by @CatherineF-dev in #2388
• fix(Dockerfile): Install tools so VERSION gets set by @mrueg in #2456
• chore: Avoid naked return by @mrueg in #2464
• chore: Replace NewReflector with NewReflectorWithOptions func by @mrueg in #2465
• fix: syntax errors in kube-state-metrics.libsonnet by @jeffmccune in #2454
• fix: e2e test failure by @CatherineF-dev in #2467
• chore: Add unused linter by @mrueg in #2466
• build(deps): Bump github.com/prometheus/client_golang from 1.19.1 to 1.20.0 by @dependabot in #2477
• docs: Fix outdated RegistryFactory.MetricFamilyGenerators comments by @daivitran in #2479
• build(deps): Bump github.com/prometheus/client_golang from 1.20.0 to 1.20.1 by @dependabot in #2481
• build(deps): Bump github.com/jsonnet-bundler/jsonnet-bundler from 0.5.1 to 0.6.0 in /tools by @dependabot in #2484
• chore: Bump e2e kind node to 1.30 by @mrueg in #2469
• chore: Memory align structs by @mrueg in #2470
• build(deps): Bump github.com/prometheus/client_golang from 1.20.1 to 1.20.2 by @dependabot in #2486
• build(deps): Bump github.com/prometheus/common from 0.55.0 to 0.57.0 by @dependabot in #2491
• build(deps): Bump github.com/prometheus/exporter-toolkit from 0.11.0 to 0.12.0 by @dependabot in #2494
• build(deps): Bump github.com/prometheus/client_golang from 1.20.2 to 1.20.3 by @dependabot in #2496
• build(deps): Bump github.com/prometheus/common from 0.58.0 to 0.59.1 by @dependabot in #2497
• docs: fix unformatted code blocks in README by @SamuAlfageme in #2498
• fix: set kube_job_status_failed metric even when there are no job.Status.Conditions present by @richabanker in #2485
• chore: Bump go to 1.23.1 by @mrueg in #2493
• build(deps): Bump github.com/prometheus/client_golang from 1.20.3 to 1.20.4 by @dependabot in #2505
• build(deps): Bump github.com/gobuffalo/flect from 1.0.2 to 1.0.3 by @dependabot in #2506
• chore: Migrate to slog for exporter-toolkit by @mrueg in #2508
• chore: Bump to kubernetes 1.31.0 by @mrueg in #2492
• build(deps): Bump actions/checkout from 4.1.7 to 4.2.0 by @dependabot in #2515
• chore: Fix the security issue about sirupsen/logrus by @kevinwangcn in #2509
• build(deps): Bump github.com/prometheus/common from 0.59.1 to 0.60.0 by @dependabot in #2519
• build(deps): Bump actions/checkout from 4.2.0 to 4.2.1 by @dependabot in #2524
• fix: de-duplication of custom resource metrics by @bartlettc22 in #2502
• fix(discovery): configure sharding every time MetricsHandler.Run runs by @wallee94 in #2478
• fix: update govulncheck's go version to 1.23 by @mrueg in #2526
• chore: Remove deprecated endpoint address metric by @mrueg in #2527
• feat: Move endpoint ports into address metric by @mrueg in #2503
• build(deps): Bump github.com/prometheus/client_golang from 1.20.4 to 1.20.5 by @dependabot in #2530
• build(deps): Bump kubernetes-sigs/release-actions from 0.2.0 to 0.3.0 by @dependabot in #2529
• build(deps): Bump actions/checkout from 4.2.1 to 4.2.2 by @dependabot in #2532
• build(deps): Bump github.com/prometheus/common from 0.60.0 to 0.60.1 by @dependabot in #2534
• build(deps): Bump the k8s-dependencies group with 5 updates by @dependabot in #2533
• build(deps): Bump actions/setup-go from 5.0.2 to 5.1.0 by @dependabot in #2531
• fix: panic in util.GVRFromType for core objects by @L3n41c in #2535
• build(deps): Bump github.com/prometheus/exporter-toolkit from 0.13.0 to 0.13.1 by @dependabot in #2537
• build(deps): Bump github.com/fsnotify/fsnotify from 1.7.0 to 1.8.0 by @dependabot in #2543
• fix: big memory overflow by @leiwingqueen in #2540
• perf: use concurrent map when storing metrics by @rarruda in #2510
• fix: expose empty labels by @mrueg in #2539
• chore: Improve benchmarks by @mrueg in #2545
• chore: Fix broken CI by @mrueg in #2546
• feat: Add new metric kube_job_status_suspended by @Indresh2410 in #2542
• fix: Remove redundant factories array since it is not written after by @Henrywu573 in #2547
• chore: Bump versions by @mrueg in #2548
• fix(custom resource state metrics): correctly convert status condition Unknown to a valid value by @Haleygo in #2536
• chore: Cut v2.14.0 by @mrueg in #2538

New Contributors

• @jeffmccune made their first contribution in #2454
• @daivitran made their first contribution in #2479
• @SamuAlfageme made their first contribution in #2498
• @richabanker made their first contribution in https://github.co...

Note

This release builds with Golang v1.22.5.
This release builds with k8s.io/client-go: v0.30.3.
This release adds read and write timeouts for requests. The defaults might have an impact on scrapes that take a long time.

New changes and fixes

[BUGFIX] Pod autosharding: transition from labelselector to fieldselector by @pkoutsovasilis in #2347
[ENHANCEMENT] Add automatic detection of memory limits by @SuperQ in #2447

[FEATURE] Add readyz endpoint by @rexagod in #2442
[FEATURE] Add livez endpoint by @rexagod in #2418
[FEATURE] Add kube_persistentvolume_volume_mode metric by @ricardoapl in #2370
[FEATURE] Add read and write timeouts by @Pokom in #2412

Full Change log

What's Changed

• chore: Sync release-2.12 with main by @rexagod in #2360
• chore: Replace VERSION file with data.yaml by @mrueg in #2361
• docs: reorganize documentation directory structure by @ovidiutirla in #2358
• chore: use string verb to format logging messages in tests by @ovidiutirla in #2363
• build(deps): Bump github.com/prometheus/client_model from 0.6.0 to 0.6.1 by @dependabot in #2364
• build(deps): Bump github.com/prometheus/common from 0.51.1 to 0.52.2 by @dependabot in #2365
• chore: Build with go 1.22 by @mrueg in #2362
• build(deps): Bump github.com/prometheus/common from 0.52.2 to 0.52.3 by @dependabot in #2369
• build(deps): Bump github.com/prometheus/common from 0.52.3 to 0.53.0 by @dependabot in #2378
• feat: add kube_persistentvolume_volume_mode metric by @ricardoapl in #2370
• feat: Support k8s 1.30 by @mrueg in #2379
• build(deps): Bump github.com/prometheus/client_golang from 1.19.0 to 1.19.1 by @dependabot in #2389
• build: bump deps to fix CVEs by @jwilder in #2385
• build(deps): Bump the k8s-dependencies group with 5 updates by @dependabot in #2394
• chore: pin dependencies in GitHub Actions by hash by @ricardoapl in #2396
• build(deps): Bump amannn/action-semantic-pull-request from 5.4.0 to 5.5.2 by @dependabot in #2401
• build(deps): Bump github.com/hairyhenderson/gomplate/v3 from 3.11.7 to 3.11.8 in /tools by @dependabot in #2409
• build(deps): Bump github.com/spf13/viper from 1.18.2 to 1.19.0 by @dependabot in #2410
• fix(pod autosharding): transition from labelselector to fieldselector by @pkoutsovasilis in #2347
• docs: add policy for consuming and upgrading dependencies by @ricardoapl in #2402
• build(deps): Bump github.com/prometheus/common from 0.53.0 to 0.54.0 by @dependabot in #2416
• ci: generate sbom on release by @ricardoapl in #2381
• ci: least privileged GITHUB_TOKEN permissions by @ricardoapl in #2395
• build(deps): Bump the k8s-dependencies group with 6 updates by @dependabot in #2422
• fix(server): Add read and write timeouts by @Pokom in #2412
• build(deps): Bump github.com/spf13/cobra from 1.8.0 to 1.8.1 by @dependabot in #2423
• build(deps): Bump actions/checkout from 4.1.3 to 4.1.7 by @dependabot in #2425
• build(deps): Bump kubernetes-sigs/release-actions from 0.1.4 to 0.2.0 by @dependabot in #2426
• ci: publish openvex on release by @ricardoapl in #2398
• build(deps): Bump k8s.io/klog/v2 from 2.130.0 to 2.130.1 in the k8s-dependencies group by @dependabot in #2430
• feat: add livez endpoint by @rexagod in #2418
• docs: Add SSF Best practices badge and community section by @mrueg in #2411
• build(deps): Bump amannn/action-semantic-pull-request from 5.5.2 to 5.5.3 by @dependabot in #2437
• build(deps): Bump github.com/prometheus/common from 0.54.0 to 0.55.0 by @dependabot in #2438
• build(deps): Bump actions/setup-go from 5.0.1 to 5.0.2 by @dependabot in #2448
• fix: add readyz endpoint by @rexagod in #2442
• perf: Add automatic detection of memory limits by @SuperQ in #2447
• chore: add kustomization to standard example by @sanadhis in #2444
• chore: Prep release v2.13.0 by @mrueg in #2419

New Contributors

• @ovidiutirla made their first contribution in #2358
• @ricardoapl made their first contribution in #2370
• @jwilder made their first contribution in #2385
• @pkoutsovasilis made their first contribution in #2347
• @Pokom made their first contribution in #2412
• @SuperQ made their first contribution in #2447
• @sanadhis made their first contribution in #2444

Full Changelog: v2.12.0...v2.13.0

Note

• This release addresses a critical issue where scraping the exposition data for certain types caused metrics-backends to crash: #2248.
• This release builds with k8s.io/client-go: v0.29.3.

Changes

• [BUGFIX] Fallback to gauge for protobuf-based negotiations by @rexagod in #2270
• [ENHANCEMENT] Add kube_pod_container_status_last_terminated_timestampby @tetianakravchenko in #2291
• [FEATURE] Allow prefixing expandable paths by @rexagod in #2052

Note

This release builds with Golang v1.21.8.

Changes

• [ENHANCEMENT] Add OpenSSF Scorecard to README by @dalehenries in #2277
• [ENHANCEMENT] Generate OpenVX data for every release by @shafeeqes in #2276
• [ENHANCEMENT] Add restartPolicy to kube_pod_init_container_info metric by @changhyuni in #2240
• [FEATURE] Add kube_node_status_addresses metric by @stonith in #2252
• [FEATURE] Add namespace label to endpointslice metrics by @mrueg in #2266
• [FEATURE] Add opt-in kube_persistentvolume_csi_attributes metric by @machadovilaca in #2133
• [FEATURE] Add new metric kube_pod_scheduler metric by @adinhodovic in #2222
• [FEATURE] Support filtering annotations allow-list by * by @xonvanetta in #2234
• [ENHANCEMENT] Support scraping pod metrics that are still in scheduling status and have no assigned nodes by @mickeyzzc in #2217
• [FEATURE] Add backend resource info for kube_ingress_path by @rohitphatak in #2109
• [FEATURE] Add kube_secret_owner by @jrcichra in #2298

Note

• This release addresses a regression introduced in #2105.

Changes

• [BUGFIX] Remove FieldSelector from non-namespaced resources by @mrueg and @dgrisonnet in #2190
• [ENHANCEMENT] Bump Go to v1.20.8

Note

• Label and annotation metrics aren't exposed by default anymore to reduce the memory usage of the default configuration of kube-state-metrics. Before this change, they used to only include the name and namespace of the objects which is not relevant to users not opting in these metrics.

Changes

• [BUGFIX] Log no _info suffix in name only once per reading the configuration for custommetrics by @chrischdi in #2157
• [BUGFIX] Don't crash on non-existent valueFrom path values by @chihshenghuang in #2140
• [BUGFIX] Index out of range in metrics_store.SanitizeHeaders by @mrueg in #2166
• [BUGFIX] Always extract the headers but only write it when we have custommetrics by @chrischdi in #2154
• [BUGFIX] Add filtering for Lease metrics by @ntoofu in #2122
• [FEATURE] Implement kube_pod_status_initialized_time by @opeco17 in #2148
• [FEATURE] Disable labels and annotations metrics when metric-annotations-… by @opeco17 in #2145
• [FEATURE] Add webhooks client config service metrics by @dgrisonnet in #2114
• [FEATURE] Support kube_persistentvolumeclaim_deletion_timestamp by @maxime1907 in #2074
• [FEATURE] Support kube_persistentvolume_deletion_timestamp by @maxime1907 in #2075
• [FEATURE] Adds new metric kube_pod_service_account by @swarup-stripe in #2096
• [FEATURE] Add volumemode to PVC info metric by @machadovilaca in #2134
• [FEATURE] Enable metric-annotations-allowlist and metric-labels-allowlist for ResourceQuota by @opeco17 in #2175
• [FEATURE] Allow field KV general matching by @rexagod in #2067
• [FEATURE] Support hot reload for kubeconfig by @opeco17 in #2144
• [FEATURE] Add support for endpoint topology routing hints by @MarkSRobinson in #2090

New Contributors

• @venkatbvc made their first contribution in #2089
• @ntoofu made their first contribution in #2122
• @maxime1907 made their first contribution in #2074
• @swarup-stripe made their first contribution in #2096
• @dependabot made their first contribution in #2136
• @machadovilaca made their first contribution in #2134
• @david-martin made their first contribution in #2151
• @chihshenghuang made their first contribution in #2140
• @adberger made their first contribution in #2163
• @opeco17 made their first contribution in #2148
• @dfredell made their first contribution in #1988
• @MarkSRobinson made their first contribution in #2090

Full Changelog: v2.9.2...v2.10.0

What's Changed

This release does not incorporate any user-facing changes. Re-running release procedures as the process for the previous release failed. Changes are listed in v2.9.0. Also, as a side note, we are currently in the middle of revamping (and automating) the release machinery based on recent observations, and we'll try our best to not introduce anymore hiccups along the way. 🙂

Full Changelog: v2.9.1...v2.9.2

What's Changed

• Increase timeout and update cloudbuild image by @mrueg in #2083

Full Changelog: v2.9.0...v2.9.1

The changes mentioned below are only the user-facing ones. For a list of the complete set of changes, refer the changelog associated with the release tag.

Note

• The release-candidate pre-release was updated to a stable v2.9.0 tag. Going forward, release-candidate pre-releases will only be done for major releases.
• The deprecated experimental VerticalPodAutoscaler metrics are no longer supported, and have been removed. We recommend to use CustomResourceState metrics to gather metrics from custom resources like the Vertical Pod Autoscaler.
• #2004 regulated label names to adhere with OTel-Prometheus standards, so existing label names that do not follow the same may be replaced by the ones that do. Please refer to the PR for more details.

• [BUGFIX] Adhere to OTel-Prometheus standard for labels #2004 @rexagod
• [BUGFIX] Respect relative paths for label resolutions #2007 @rexagod
• [BUGFIX] Support LabelsFromPath functionality for Info-typed metrics #2048 @murphd40
• [CHANGE] Remove VerticalPodAutoscaler #2017 @mrueg
• [ENHANCEMENT] Add StatefulSet Start Ordinal metrics for KEP-3335 #1959 @pwschuurman
• [ENHANCEMENT] Add namespace label to kube_lease_renew_time #2073 @a-hilaly
• [ENHANCEMENT] Add parameters for PodSecurity #2042 @jcpunk
• [ENHANCEMENT] Add support for multi cluster prometheus alerts #2058 @jkroepke
• [ENHANCEMENT] Don't crash on non-existent path values #1998 @rexagod
• [ENHANCEMENT] Only use OpenMetrics and Text in contentType #2024 @CatherineF-dev
• [ENHANCEMENT] Update go version to 1.20.4 #2056 @RamakrishnanArun
• [FEATURE] Add support for variable VKs in CRS config #1851 @rexagod
• [FEATURE] Support quantities and percentages #1989 @mrueg
• [FEATURE] Use prometheus/exporter-toolkit landing page #2034 @mrueg

v2.8.2 / 2023-03-17

• [BUGFIX] Only use OpenMetrics and Text in contentType #2024 @CatherineF-dev

Full Changelog: v2.8.1...v2.8.2