Section 3 · Remote configuration

Common mistakes to avoid when designing attributes

Estimated time: 1 min

What not to do

Attributes should describe groups of collectors, not individual instances. Most mistakes come from ignoring that.

MistakeWhy it’s a problem
Too many attributesHard to manage, and hits the limits (22 local per API request, 100 remote per collector)
Frequently changing valuesUse remote attributes in UI instead
Sensitive informationAttributes are visible in the Fleet Management UI
Duplicating reserved attributescollector.os, collector.version, and collector.ID already exist
Inconsistent namingmyEnv vs my_env vs my-env causes confusion
Overly specific valueshostname=server-123 (use collector.ID instead)

Tips for beginners

TipWhy it helps
Start simpleBegin with env and maybe one or two others
Be consistentPick a naming convention and stick to it
Document your schemaNote down what each attribute means
Think about matchingEvery attribute should help you match pipelines to collectors