Label matching operators

These operators are used inside instant vector selectors ({...}) to match series by label.

Stack GA 9.5+ … The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 9.5 This functionality is generally available and ready for production usage. Preview in 9.4 This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Matches labels exactly equal to the provided string.

Operands

label (string)

The label name to match on, used inside a selector ({...}).

value (string)

The string or regular expression to compare the label value against.

Returns

Used inside an instant vector selector ({...}) to select an instant_vector, rather than as a standalone expression.

Example

requests_total{method="GET"}

Stack GA 9.5+ … The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 9.5 This functionality is generally available and ready for production usage. Preview in 9.4 This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Matches labels not equal to the provided string.

Operands

label (string)

The label name to match on, used inside a selector ({...}).

value (string)

The string or regular expression to compare the label value against.

Returns

Used inside an instant vector selector ({...}) to select an instant_vector, rather than as a standalone expression.

Example

requests_total{method!="DELETE"}

Stack GA 9.5+ … The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 9.5 This functionality is generally available and ready for production usage. Preview in 9.4 This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Matches labels whose value does not satisfy the provided regular expression.

Operands

label (string)

The label name to match on, used inside a selector ({...}).

value (string)

The string or regular expression to compare the label value against.

Returns

Used inside an instant vector selector ({...}) to select an instant_vector, rather than as a standalone expression.

Example

requests_total{method!~"DELETE|PUT"}

Stack GA 9.5+ … The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 9.5 This functionality is generally available and ready for production usage. Preview in 9.4 This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Matches labels whose value satisfies the provided regular expression.

Operands

label (string)

The label name to match on, used inside a selector ({...}).

value (string)

The string or regular expression to compare the label value against.

Returns

Used inside an instant vector selector ({...}) to select an instant_vector, rather than as a standalone expression.

Example

requests_total{method=~"GET|POST"}