Section 3 · Remote configuration

How pipelines get assigned to collectors

Estimated time: 1 min

Attribute matching

Attribute matching is the mechanism that connects pipelines to collectors. When you create a pipeline, you define matchers, which are rules that specify which collectors should receive that pipeline based on their attributes.

Matchers determine which collectors receive a pipeline.

Attribute matching connects pipelines to collectors

How matchers work

You define…To match…
env=productionAll collectors with env attribute set to production
region=~"us-.*"All collectors in any US region

Matcher syntax

Each matcher combines an attribute name, an operator, and a value. Matchers follow the same syntax as Prometheus Alertmanager matchers, so they may look familiar.

OperatorMeaningExample
=Equalsenv=production
!=Not equalsenv!=development
=~Regex matchregion=~"us-.*"
!~Regex not matchteam!~"test-.*"

Matching rule: AND logic

When you assign multiple matchers to a pipeline, Fleet Management combines them with AND logic. All matchers must match for a collector to receive the pipeline.

Matchers definedCollector receives pipeline if…
env=prodenv is prod
env=prod, region=us-eastenv is prod AND region is us-east

This lets you be precise about which collectors receive a configuration. The more matchers you add, the narrower your matching becomes.