eq

Input Stack: value: String key: String

⇨

Output Stack: (key == value): Query

Select time series that have a specified value for a key. This is the most common operator for filtering time series data and forms the foundation of most queries. The comparison is case-sensitive and requires an exact string match.

Parameters

• key: The tag key to match against (e.g., name, nf.app, status)
• value: The exact value that the key must equal for a time series to be included

Examples

Select all time series where the name tag equals "ssCpuUser":

name,ssCpuUser,:eq

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

Name	nf.app	nf.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

Related Operations

• :and - Combine multiple query conditions
• :or - Match any of multiple query conditions
• :re - Match using regular expressions (case-sensitive)
• :in - Match against a list of possible values
• :has - Check if a tag key exists regardless of value