Beispiel

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

Fall

Ziel

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

Pakete

go.opentelemetry.io/otel/sdk 1.35.0

Umgebung

go

Erstellt

2026-08-17T23:37:22Z

Häufige Annahme

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.

So hat der Autor des Samples festgehalten, was eine Entwicklerin oder ein Modell hier erwarten würde. Der Vertrag darunter ist das, was tatsächlich lief.

Contract

• 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

Dateien

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

Quellartefakt herunterladen (tar.gz)

Ursprungs-Seeder

csx-seed

Verifizierungsbelege

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