Documentation forAppOptics

Function: integrate(set[])

Given an arbitrary number of series, performs a numerical integration on each series to return a set of equal length. This is equivalent to computing the cumulative sum over the series, where each point in the returned series is the sum of the current point and the accumulated sum of all previous points in the series.

Example:

The following expression plots the sum of AWS.EC2.CPUCreditUsage and all previous values of AWS.EC2.CPUCreditUsage which display in a given time period. The series in the example includes the optional fields period and function, which if removed will default to the metric’s native period and a summary statistic of mean.

Copy
integrate(
  sum(s("AWS.EC2.CPUCreditUsage",
    {"name": "prodvpc*"},
    { period:"60", function:"sum" }
)))

The chart below demonstrates how the integration expression (provided above) starts at the actual value of the metric and continuously climbs at the rate of the next metric value provided.

integrate-example-1

You can see how the integrate stream continues to rise with each data point from the increase from AWS.EC2.CPUCreditUsage.

The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.