サンプル

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