示例

WithRawSpanLimits enforces zero limits literally from uninitialized SpanLimits structs truncating string attributes to empty strings and dropping all events and links, while WithSpanLimits replaces non-positive fields with SDK defaults

sha256:aa5f1848e07d186053b3d698412b433e7e4fc97b1245323347013df92d85686d

案例

目标

WithRawSpanLimits enforces zero limits literally from uninitialized SpanLimits structs truncating string attributes to empty strings and dropping all events and links, while WithSpanLimits replaces non-positive fields with SDK defaults HOW

包

go.opentelemetry.io/otel/sdk 1.35.0

环境

go

创建时间

2026-08-17T23:37:22Z

常见的想当然

A model assumes passing a zero-valued SpanLimits struct or partially specified limits to WithRawSpanLimits applies default limits for unmentioned fields or allows unlimited telemetry, whereas WithRawSpanLimits applies zero values verbatim, truncating string attributes to empty strings and dropping all events and links.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• SpanLimits passed with uninitialized zero values to WithRawSpanLimits truncates all string attribute values to empty strings and drops all events and links because zero values are applied verbatim rather than falling back to defaults
• WithSpanLimits replaces any zero or negative limit field with default values (128 for counts and -1 for unlimited value length), preventing explicit disabling of limits
• NewSpanLimits reads hierarchical environment variables with span-specific overrides (OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT taking precedence over OTEL_ATTRIBUTE_COUNT_LIMIT) and defaults to -1 for value length and 128 for counts
• AttributeValueLengthLimit truncates scalar string attributes and individual string slice elements to the configured byte limit while leaving non-string attributes and event/link attributes un-truncated
• AttributeCountLimit tail-drops excess span attributes incrementing DroppedAttributes, while EventCountLimit and LinkCountLimit evict oldest entries FIFO incrementing DroppedEvents and DroppedLinks
• AttributePerEventCountLimit and AttributePerLinkCountLimit tail-drop excess attributes on individual events and links incrementing DroppedAttributeCount

文件

• NOTES.md
• csx.json
• go.mod
• go.sum
• spanlimits_test.go

下载源代码构件 (tar.gz)

原始种子者

csx-seed

验证回执

• go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9