retainSeries(<tsExpression>, <filter1> [and|or [not] <filter2>] ... ) where <filterN> is: <metricName> | source="<sourceName>" | tag="<sourceTagName>" | <pointTagKey>="<pointTagValue>"
Filters the expression to display only the time series that match one or more filters, which might be any combination of metric names, source names, source tags, or point tags.
|tsExpression||Expression that describes the time series you want to filter.|
|<metricName>|source=|tag=|<pointTagKey>=||A metric, source, source tag, or point tag to filter by. You must specify at least one filter, which can be of any type. Use Boolean operators to combine multiple filters. For example, |
(source=app-1 or source=app-2) and env=dev.
retainSeries() function filters the expression to display only the time series that match the specified metric, source, source tag, point tag, or combination of these filters.
You might be able to use the
retainSeries() function to retain only the series that have the synthetic point tag that you define, for example, in conjunction with
In contrast to
filter(), this function supports matching a source tag.
In the following example, we first extract all
~sample.requests.* metrics that are in the
Then we extract from that series only the series that come from the
app-5 source. The resulting chart displays just three series.