Skip to main content

​
Tags

Tags are lightweight trace labels for broad, repeated categories such as environment, agent name, feature area, rollout, or customer segment.

​
Send tags

Pass tags through capture(). 
import { capture } from "@latitude-data/telemetry"

await capture(
  "support-agent-turn",
  async () => {
    return agent.run(userMessage)
  },
  {
    tags: ["production", "support-agent", "checkout"],
  },
)
Nested captures inherit parent tags. Additional tags are appended and deduplicated.

​
Use tags in Latitude

Tags appear in trace metadata.
Traces table showing colored tags such as production, support, development, and internal-kb
Use tags to:
  • filter the Traces page
  • narrow semantic or exact-text searches
  • save reusable search cohorts
  • scope evaluation monitoring
  • compare issue patterns across environments, agents, or features

​
Tags vs metadata

Use tags for labels you commonly filter by, such as environments or rollout cohorts. Use metadata for structured key-value context such as request ids, plan names, regions, experiment ids, or account properties.
  • Metadata: Attach structured context
  • Filters: Filter traces by tags
  • Search: Combine tags with semantic search