Making Semantic Conventions Work for You With OpenTelemetry Weaver

OpenTelemetry Weaver is a toolset designed to enhance the clarity and utility of telemetry data by using semantic conventions to define, validate, and evolve telemetry schemas, treating them like public APIs. This approach allows for the creation of a layered schema registry, aiding both human analysts and AI agents in understanding the attributes within a dataset. At Honeycomb, a three-layer registry is employed: the OpenTelemetry base layer for standard attributes, a Honeycomb-specific overlay for platform attributes, and an optional customer domain overlay for organization-specific attributes. This layered approach ensures that each attribute's meaning is documented and accessible, facilitating informed data analysis and decision-making. Weaver also supports schema dependencies, automatic column descriptions, and tools for deeper exploration, while offering capabilities such as live telemetry validation, type-safe SDK generation, and schema version diffing. Through these features, Weaver aims to make telemetry data more comprehensible and actionable, ultimately improving observability and analytics processes.