샘플

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