Skip to content

in

Input Stack:
values: List[String]
key: String
 ⇨ Output Stack:
(key in values): Query
 

Select time series where the value for a key matches any value in the specified list. This is more efficient than using multiple :eq conditions combined with :or when you need to match against several possible values for the same key.

Parameters

  • key: The tag key to check (e.g., name, nf.app, status)
  • values: A list of possible values to match against

Examples

Select time series where the name is either "ssCpuUser" or "ssCpuSystem":

name,(,ssCpuUser,ssCpuSystem,),:in

When matching against the sample data in the table below, the highlighted time series would be included in the result set:

Namenf.appnf.node
ssCpuUser alerttest i-0123
ssCpuSystem alerttest i-0123
ssCpuUser nccp i-0abc
ssCpuSystem nccp i-0abc
numRequests nccp i-0abc
ssCpuUser api i-0456

This is equivalent to but more efficient than: name,ssCpuUser,:eq,name,ssCpuSystem,:eq,:or

  • :eq - Check for a single specific value
  • :re - Match using regular expressions
  • :has - Check if a key exists regardless of value
  • :or - Logical OR operation