Slide 5 of 14

Designing your attribute schema

How to choose your attributes

Ask yourself: “What groups of collectors should receive the same configuration?”

If you want to target…You need an attribute like…
All production serversenv=production
Collectors in specific regionsregion=us-east
Collectors owned by a teamteam=platform
Collectors for a specific serviceservice=api-gateway

Start with one question

Common attribute patterns

AttributeExample valuesUse case
envproduction, staging, devEnvironment-specific configs
regionus-east, eu-west, ap-southRegion-specific collection
teamplatform, backend, dataTeam ownership
serviceapi, web, workerService-specific monitoring

Start simple. Begin with env and one or two others. Add more as needed.

Script

Now that you understand what attributes are, let’s talk about how to design them well. A little planning up front saves a lot of pain later.

Start by asking one question: “What groups of collectors should receive the same configuration?” The answer reveals the attributes needed. If all production servers should get the same metrics config, an env attribute is needed. If different regions have different collection requirements, a region attribute is needed. If teams manage their own collectors, a team attribute is needed.

The table on this slide shows common patterns that work well. Environment is the most common—production, staging, development. Region is useful for geographic targeting. Team helps with ownership and accountability. Service identifies what the collector monitors.

Start with these basics. More attributes can be added as patterns emerge from real usage.