Learn about deprecated and EOL features and how to prevent potential problems.

Product versions and features move to end-of-life as part of the normal software development lifecycle, security improvements, and other factors. To support planning for upgrades, this document provides information on upcoming lifecycle changes. While every effort is made to provide sufficient notice of changes, security issues or other factors may occasionally lead to accelerated end-of-life dates.

Lifecycle Stages

To help you plan for end-of-life dates, this page uses the following terms:

  • Deprecated. Feature, component, platform, or functionality that may no longer be efficient or safe. Deprecated features are supported but no longer recommended. Wavefront eventually removes deprecated features. Bug fixes are at Wavefront’s discretion. In particular, Wavefront may require migration to the new feature in lieu of fixing a bug in a deprecated feature. Wavefront identifies deprecated features in the release notes for the release in which the feature is deprecated. For Wavefront proxy, the table below lists deprecated versions.
  • End-of-life. No longer supported. Feature, component, platform, or functionality is no longer supported and may be removed from the product at any time.

Wavefront Proxy

Upgrade to the latest GA release of the Wavefront proxy to get the latest bug fixes and performance enhancements.

The following proxy versions are scheduled to be deprecated or moved to end-of-life.

VersionCurrent StageEnd-of-Life Date
5.x, 6.x, 7.x, 8.x Deprecated TBD
4.x Deprecated Dec 31, 2020
3.24 and lower End-of-Life Jun 30, 2017

Wavefront API

VersionCurrent StageEnd-of-Life Date
2 Active TBD
1 End-of-Life Dec 31, 2017

Delta Counters

Wavefront delta counter behavior changed with Release 2020.26.

  • The original delta counter implementation was Deprecated with Release 2020.26. Wavefront changed delta counter queries to use cs() in the Wavefront Usage integration and tracing RED metrics.
  • The original delta counter implementation is End of Life March 31, 2021.

Automatic Updates and Required Changes

Wavefront updates system dashboard and integration content. However, you might have to update custom delta counters.

  • Automatic Updates. Wavefront uses delta counters in tracing RED metrics and in certain internal ~ metrics collected by Wavefront such as ~collector.points.reported. All Wavefront-provided dashboards that use these data will be updated for you.
  • User Updates. If you have cloned any Wavefront dashboards that use delta counters or have created any custom dashboards, charts, or alerts, you are responsible for updating the queries in related charts and alerts yourself.

How to Find Queries that Might Need Modification

  1. Find delta counters from the UI or using Spy.
    • From the Wavefront UI, click Browse > Delta Counters and examine your data.
    • From your Web browser, use Delta Counter Spy to view live delta counter ingestion.
  2. Search for those named counters in alerts and dashboards.
    • Search on the Alerts page to find alerts that use the counter metric.
    • Search on the All Dashboards page for dashboards. You might have to select Metrics to get the relevant result.

How to Modify the Queries

  1. Replace ts() with cs() if the query targets delta counter data. Filtering works as before, so nothing within the parentheses needs to change.
  2. Remove rate() or ratediff() functions from your delta counter queries.

    Any cs() query tracks the total increments per minute, so cs() data is already a 1-minute rate and doesn’t require the rate() function. If you do want to know the per-second rate of change, divide the result by 60.

    You do not need to do anything differently if you are using a timeWindow parameter in your rate() function. The purpose of that parameter is to account for cumulative counter resets, but delta counters do not have resets.

  3. Remove align() from your delta counter queries unless you picked an align() time window that’s larger than 1 minute.

    cs() data is always minutely aligned and raw or standard aggregations give the same results.


In the following examples, errors.count is a delta counter:

Original QueryNew QueryExplanation
ts(errors.count) cs(errors.count) In the simplest case, just change ts() to cs()
rate(ts(errors.count)) cs(errors.count) / 60 To produce per-second rate of change like the rate() function the cs() divide by 60.
ratediff(ts(errors.count)) cs(errors.count) For ratediff(), no per-second conversion is done. Remove the ratediff() function from the query.
align(1m, ts(errors.count)) cs(errors.count) Remove align() from your query unless you picked an align() time window that’s larger than 1 minute.

Background: Original and New Delta Counter Implementation

Wavefront delta counters allow you to measure the number of times something occurred over time without needing to keep track of the number of occurrences to date yourself.

At ingestion time, a delta counter must have a ∆ character at the beginning. Just like any other measurement data in Wavefront a delta counter series is uniquely identified by its name, source, and any point tags.

Example Scenario

For example, imagine we are trying to track the total number of errors that occur across lambda functions running in a given AWS region. Each invocation of the function would measure how many errors occurred during that run and would emit that to Wavefront.

If 5 errors were encountered during a given run, a Lambda running in the us-west-2 region would send: ∆errors.count 5 source=lambda region=us-west-2. Wavefront automatically aggregates any increments received for that same counter allowing you to know the total number of errors that occurred over time, across any number of lambda invocations without any function needing to keep track of that overall state!

Original Implementation

Before release 2020.26, Wavefront originally stored delta values internally as regular metrics emitted every minutes.

For the above example if the data measured across 3 minutes had been a total of: 10 errors in minute 1, 15 errors in minute 2, and 5 errors in minute 3 then if you queried ts(errors.count) for that time range you would see a monotonically increasing count showing 10, 25, 30 across those 3 minutes.

New Implementation

Starting with release 2020.26, Wavefront has a new data type specifically for storing delta counters. Data ingestion of delta counters remains unchanged, and a delta (∆) is still required to indicate a delta counter, but the data is now queried via cs() instead of ts(). The original delta counters still report minutely, but instead of maintaining a monotonically increasing count they report the total number of increments that occurred within each minute. In our example, cs(errors.count) displays values of 10, 15, and 5. See Counters and Delta Counters for details and examples.