Documentation forAppOptics

Function: series(metric, tag, options={})

At the lowest level of a composite's definition are a set of raw metrics. These are accessed through the special function series() that takes two arguments, a metric name and one or many tag values wrapped in curly brackets ({}).

series("foo.bar.baz", {})

Either the metric name and/or the tag value may contain the wildcard character:

series("foo.bar.*", {"name":"prod.*"})

A dynamic tag may be specified for the tag value with %. This indicates that the tag(s) will be specified at the time the composite metric is loaded into a template instrument or dashboard:

series("foo.bar.*", "%")

As calls to series() are required in every composite definition a special shorthand notation s() will be an alias to the series() function:

sum(s("foo.bar.*", {"name":"prod.*"}))

The options map may be included with any of the following keys:

  • function - Specifies which summary statistic should be used. Accepted values are: min, max, mean, sum, count. The default function, if not specified, is mean.
  • period - Specifies the interval to which returned measurements should be summarized. All measurements within each period are summarized to a single measurement and the measure_time is floored to the period. This allows you to specify granularity that is not available at the standard rollup resolutions (1s, 60s, 900s, 3600s).
sum(s("foo.bar.*", {"name":"prod.*"}, { period:"100", function:"mean" }))

Navigation Notice: When the APM Integrated Experience is enabled, AppOptics shares a common navigation and enhanced feature set with other integrated experience products. How you navigate AppOptics and access its features may vary from these instructions.

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.