Skip to content

Conversation

MrAlias
Copy link
Contributor

@MrAlias MrAlias commented Jan 31, 2025

Resolve #6226

Generates the v1.28.0 version of semantic conventions in the added go.opentelemetry.io/otel/semconv/v1.28.0 package.

Key differences from v1.27.0

Added to v1.28.0

  • AzNamespace
  • AzNamespaceKey
  • CloudfoundryAppID
  • CloudfoundryAppIDKey
  • CloudfoundryAppInstanceID
  • CloudfoundryAppInstanceIDKey
  • CloudfoundryAppName
  • CloudfoundryAppNameKey
  • CloudfoundryOrgID
  • CloudfoundryOrgIDKey
  • CloudfoundryOrgName
  • CloudfoundryOrgNameKey
  • CloudfoundryProcessID
  • CloudfoundryProcessIDKey
  • CloudfoundryProcessType
  • CloudfoundryProcessTypeKey
  • CloudfoundrySpaceID
  • CloudfoundrySpaceIDKey
  • CloudfoundrySpaceName
  • CloudfoundrySpaceNameKey
  • CloudfoundrySystemID
  • CloudfoundrySystemIDKey
  • CloudfoundrySystemInstanceID
  • CloudfoundrySystemInstanceIDKey
  • ContainerCPUUsageDescription
  • ContainerCPUUsageName
  • ContainerCPUUsageUnit
  • ContainerCsiPluginName
  • ContainerCsiPluginNameKey
  • ContainerCsiVolumeID
  • ContainerCsiVolumeIDKey
  • DBResponseStatusCode
  • DBResponseStatusCodeKey
  • FileAccessed
  • FileAccessedKey
  • FileAttributes
  • FileAttributesKey
  • FileChanged
  • FileChangedKey
  • FileCreated
  • FileCreatedKey
  • FileForkName
  • FileForkNameKey
  • FileGroupID
  • FileGroupIDKey
  • FileGroupName
  • FileGroupNameKey
  • FileInode
  • FileInodeKey
  • FileMode
  • FileModeKey
  • FileModified
  • FileModifiedKey
  • FileOwnerID
  • FileOwnerIDKey
  • FileOwnerName
  • FileOwnerNameKey
  • FileSymbolicLinkTargetPath
  • FileSymbolicLinkTargetPathKey
  • GenAIOpenaiRequestResponseFormatJSONObject
  • GenAIOpenaiRequestResponseFormatJSONSchema
  • GenAIOpenaiRequestResponseFormatKey
  • GenAIOpenaiRequestResponseFormatText
  • GenAIOpenaiRequestSeed
  • GenAIOpenaiRequestSeedKey
  • GenAIOpenaiRequestServiceTierAuto
  • GenAIOpenaiRequestServiceTierDefault
  • GenAIOpenaiRequestServiceTierKey
  • GenAIOpenaiResponseServiceTier
  • GenAIOpenaiResponseServiceTierKey
  • HwEnergyDescription
  • HwEnergyName
  • HwEnergyUnit
  • HwErrorsDescription
  • HwErrorsName
  • HwErrorsUnit
  • HwID
  • HwIDKey
  • HwName
  • HwNameKey
  • HwParent
  • HwParentKey
  • HwPowerDescription
  • HwPowerName
  • HwPowerUnit
  • HwStateDegraded
  • HwStateFailed
  • HwStateKey
  • HwStateOk
  • HwStatusDescription
  • HwStatusName
  • HwStatusUnit
  • HwTypeBattery
  • HwTypeCPU
  • HwTypeDiskController
  • HwTypeEnclosure
  • HwTypeFan
  • HwTypeGpu
  • HwTypeKey
  • HwTypeLogicalDisk
  • HwTypeMemory
  • HwTypeNetwork
  • HwTypePhysicalDisk
  • HwTypePowerSupply
  • HwTypeTapeDrive
  • HwTypeTemperature
  • HwTypeVoltage
  • K8SNodeCPUTimeDescription
  • K8SNodeCPUTimeName
  • K8SNodeCPUTimeUnit
  • K8SNodeCPUUsageDescription
  • K8SNodeCPUUsageName
  • K8SNodeCPUUsageUnit
  • K8SNodeMemoryUsageDescription
  • K8SNodeMemoryUsageName
  • K8SNodeMemoryUsageUnit
  • K8SPodCPUTimeDescription
  • K8SPodCPUTimeName
  • K8SPodCPUTimeUnit
  • K8SPodCPUUsageDescription
  • K8SPodCPUUsageName
  • K8SPodCPUUsageUnit
  • K8SPodMemoryUsageDescription
  • K8SPodMemoryUsageName
  • K8SPodMemoryUsageUnit
  • K8SVolumeName
  • K8SVolumeNameKey
  • K8SVolumeTypeConfigMap
  • K8SVolumeTypeDownwardAPI
  • K8SVolumeTypeEmptyDir
  • K8SVolumeTypeKey
  • K8SVolumeTypeLocal
  • K8SVolumeTypePersistentVolumeClaim
  • K8SVolumeTypeSecret
  • MessagingClientSentMessagesDescription
  • MessagingClientSentMessagesName
  • MessagingClientSentMessagesUnit
  • MessagingOperationTypeSend
  • ProcessArgsCount
  • ProcessArgsCountKey
  • ProcessExecutableBuildIDGnu
  • ProcessExecutableBuildIDGnuKey
  • ProcessExecutableBuildIDGo
  • ProcessExecutableBuildIDGoKey
  • ProcessExecutableBuildIDProfiling
  • ProcessExecutableBuildIDProfilingKey
  • ProcessTitle
  • ProcessTitleKey
  • ProcessUptimeDescription
  • ProcessUptimeName
  • ProcessUptimeUnit
  • ProcessWorkingDirectory
  • ProcessWorkingDirectoryKey
  • ProfileFrameTypeCpython
  • ProfileFrameTypeDotnet
  • ProfileFrameTypeJVM
  • ProfileFrameTypeKernel
  • ProfileFrameTypeKey
  • ProfileFrameTypeNative
  • ProfileFrameTypePHP
  • ProfileFrameTypePerl
  • ProfileFrameTypeRuby
  • ProfileFrameTypeV8JS
  • SystemDiskLimitDescription
  • SystemDiskLimitName
  • SystemDiskLimitUnit
  • SystemFilesystemLimitDescription
  • SystemFilesystemLimitName
  • SystemFilesystemLimitUnit
  • SystemFilesystemUsageDescription

Dropped deprecations

  • AndroidStateBackground
  • AndroidStateCreated
  • AndroidStateForeground
  • AndroidStateKey
  • DBCosmosDBStatusCode
  • DBCosmosDBStatusCodeKey
  • GenAICompletion
  • GenAICompletionKey
  • GenAIPrompt
  • GenAIPromptKey

Dropping the aspnetcore namespace

  • ASPNETCoreDiagnosticsExceptionResultAborted
  • ASPNETCoreDiagnosticsExceptionResultHandled
  • ASPNETCoreDiagnosticsExceptionResultKey
  • ASPNETCoreDiagnosticsExceptionResultSkipped
  • ASPNETCoreDiagnosticsExceptionResultUnhandled
  • ASPNETCoreDiagnosticsHandlerType
  • ASPNETCoreDiagnosticsHandlerTypeKey
  • ASPNETCoreRateLimitingPolicy
  • ASPNETCoreRateLimitingPolicyKey
  • ASPNETCoreRateLimitingResultAcquired
  • ASPNETCoreRateLimitingResultEndpointLimiter
  • ASPNETCoreRateLimitingResultGlobalLimiter
  • ASPNETCoreRateLimitingResultKey
  • ASPNETCoreRateLimitingResultRequestCanceled
  • ASPNETCoreRequestIsUnhandled
  • ASPNETCoreRequestIsUnhandledKey
  • ASPNETCoreRoutingIsFallback
  • ASPNETCoreRoutingIsFallbackKey
  • ASPNETCoreRoutingMatchStatusFailure
  • ASPNETCoreRoutingMatchStatusKey
  • ASPNETCoreRoutingMatchStatusSuccess
  • AspnetcoreDiagnosticsExceptionsDescription
  • AspnetcoreDiagnosticsExceptionsName
  • AspnetcoreDiagnosticsExceptionsUnit
  • AspnetcoreRateLimitingActiveRequestLeasesDescription
  • AspnetcoreRateLimitingActiveRequestLeasesName
  • AspnetcoreRateLimitingActiveRequestLeasesUnit
  • AspnetcoreRateLimitingQueuedRequestsDescription
  • AspnetcoreRateLimitingQueuedRequestsName
  • AspnetcoreRateLimitingQueuedRequestsUnit
  • AspnetcoreRateLimitingRequestLeaseDurationDescription
  • AspnetcoreRateLimitingRequestLeaseDurationName
  • AspnetcoreRateLimitingRequestLeaseDurationUnit
  • AspnetcoreRateLimitingRequestTimeInQueueDescription
  • AspnetcoreRateLimitingRequestTimeInQueueName
  • AspnetcoreRateLimitingRequestTimeInQueueUnit
  • AspnetcoreRateLimitingRequestsDescription
  • AspnetcoreRateLimitingRequestsName
  • AspnetcoreRateLimitingRequestsUnit
  • AspnetcoreRoutingMatchAttemptsDescription
  • AspnetcoreRoutingMatchAttemptsName
  • AspnetcoreRoutingMatchAttemptsUnit

Dropping the jvm namespace

  • JVMBufferPoolName
  • JVMBufferPoolNameKey
  • JVMGCAction
  • JVMGCActionKey
  • JVMGCName
  • JVMGCNameKey
  • JVMMemoryPoolName
  • JVMMemoryPoolNameKey
  • JVMMemoryTypeHeap
  • JVMMemoryTypeKey
  • JVMMemoryTypeNonHeap
  • JVMThreadDaemon
  • JVMThreadDaemonKey
  • JVMThreadStateBlocked
  • JVMThreadStateKey
  • JVMThreadStateNew
  • JVMThreadStateRunnable
  • JVMThreadStateTerminated
  • JVMThreadStateTimedWaiting
  • JVMThreadStateWaiting
  • JvmBufferCountDescription
  • JvmBufferCountName
  • JvmBufferCountUnit
  • JvmBufferMemoryLimitDescription
  • JvmBufferMemoryLimitName
  • JvmBufferMemoryLimitUnit
  • JvmBufferMemoryUsageDescription
  • JvmBufferMemoryUsageName
  • JvmBufferMemoryUsageUnit
  • JvmBufferMemoryUsedDescription
  • JvmBufferMemoryUsedName
  • JvmBufferMemoryUsedUnit
  • JvmCPUCountDescription
  • JvmCPUCountName
  • JvmCPUCountUnit
  • JvmCPURecentUtilizationDescription
  • JvmCPURecentUtilizationName
  • JvmCPURecentUtilizationUnit
  • JvmCPUTimeDescription
  • JvmCPUTimeName
  • JvmCPUTimeUnit
  • JvmClassCountDescription
  • JvmClassCountName
  • JvmClassCountUnit
  • JvmClassLoadedDescription
  • JvmClassLoadedName
  • JvmClassLoadedUnit
  • JvmClassUnloadedDescription
  • JvmClassUnloadedName
  • JvmClassUnloadedUnit
  • JvmGcDurationDescription
  • JvmGcDurationName
  • JvmGcDurationUnit
  • JvmMemoryCommittedDescription
  • JvmMemoryCommittedName
  • JvmMemoryCommittedUnit
  • JvmMemoryInitDescription
  • JvmMemoryInitName
  • JvmMemoryInitUnit
  • JvmMemoryLimitDescription
  • JvmMemoryLimitName
  • JvmMemoryLimitUnit
  • JvmMemoryUsedAfterLastGcDescription
  • JvmMemoryUsedAfterLastGcName
  • JvmMemoryUsedAfterLastGcUnit
  • JvmMemoryUsedDescription
  • JvmMemoryUsedName
  • JvmMemoryUsedUnit
  • JvmSystemCPULoad1mDescription
  • JvmSystemCPULoad1mName
  • JvmSystemCPULoad1mUnit
  • JvmSystemCPUUtilizationDescription
  • JvmSystemCPUUtilizationName
  • JvmSystemCPUUtilizationUnit
  • JvmThreadCountDescription
  • JvmThreadCountName
  • JvmThreadCountUnit

Dropping the nodejs namespace

  • NodejsEventloopDelayMaxDescription
  • NodejsEventloopDelayMaxName
  • NodejsEventloopDelayMaxUnit
  • NodejsEventloopDelayMeanDescription
  • NodejsEventloopDelayMeanName
  • NodejsEventloopDelayMeanUnit
  • NodejsEventloopDelayMinDescription
  • NodejsEventloopDelayMinName
  • NodejsEventloopDelayMinUnit
  • NodejsEventloopDelayP50Description
  • NodejsEventloopDelayP50Name
  • NodejsEventloopDelayP50Unit
  • NodejsEventloopDelayP90Description
  • NodejsEventloopDelayP90Name
  • NodejsEventloopDelayP90Unit
  • NodejsEventloopDelayP99Description
  • NodejsEventloopDelayP99Name
  • NodejsEventloopDelayP99Unit
  • NodejsEventloopDelayStddevDescription
  • NodejsEventloopDelayStddevName
  • NodejsEventloopDelayStddevUnit
  • NodejsEventloopUtilizationDescription
  • NodejsEventloopUtilizationName
  • NodejsEventloopUtilizationUnit

Dropping the v8js namespace

  • V8JSGCTypeIncremental
  • V8JSGCTypeKey
  • V8JSGCTypeMajor
  • V8JSGCTypeMinor
  • V8JSGCTypeWeakcb
  • V8JSHeapSpaceNameCodeSpace
  • V8JSHeapSpaceNameKey
  • V8JSHeapSpaceNameLargeObjectSpace
  • V8JSHeapSpaceNameMapSpace
  • V8JSHeapSpaceNameNewSpace
  • V8JSHeapSpaceNameOldSpace
  • V8jsGcDurationDescription
  • V8jsGcDurationName
  • V8jsGcDurationUnit
  • V8jsHeapSpaceAvailableSizeDescription
  • V8jsHeapSpaceAvailableSizeName
  • V8jsHeapSpaceAvailableSizeUnit
  • V8jsHeapSpacePhysicalSizeDescription
  • V8jsHeapSpacePhysicalSizeName
  • V8jsHeapSpacePhysicalSizeUnit
  • V8jsMemoryHeapLimitDescription
  • V8jsMemoryHeapLimitName
  • V8jsMemoryHeapLimitUnit
  • V8jsMemoryHeapUsedDescription
  • V8jsMemoryHeapUsedName
  • V8jsMemoryHeapUsedUnit

Fixed Acronyms/Initialisms

v1.28.0 v1.27.0
DBSystemDb2 DBSystemDB2
GenAIClientOperationDurationDescription GenAiClientOperationDurationDescription
GenAIClientOperationDurationName GenAiClientOperationDurationName
GenAIClientOperationDurationUnit GenAiClientOperationDurationUnit
GenAIClientTokenUsageDescription GenAiClientTokenUsageDescription
GenAIClientTokenUsageName GenAiClientTokenUsageName
GenAIClientTokenUsageUnit GenAiClientTokenUsageUnit
GenAIServerRequestDurationDescription GenAiServerRequestDurationDescription
GenAIServerRequestDurationName GenAiServerRequestDurationName
GenAIServerRequestDurationUnit GenAiServerRequestDurationUnit
GenAIServerTimePerOutputTokenDescription GenAiServerTimePerOutputTokenDescription
GenAIServerTimePerOutputTokenName GenAiServerTimePerOutputTokenName
GenAIServerTimePerOutputTokenUnit GenAiServerTimePerOutputTokenUnit
GenAIServerTimeToFirstTokenDescription GenAiServerTimeToFirstTokenDescription
GenAIServerTimeToFirstTokenName GenAiServerTimeToFirstTokenName
GenAIServerTimeToFirstTokenUnit GenAiServerTimeToFirstTokenUnit
GoMemoryGCGoalDescription GoMemoryGcGoalDescription
GoMemoryGCGoalName GoMemoryGcGoalName
GoMemoryGCGoalUnit GoMemoryGcGoalUnit

Build notes

Skip the dotnet namespace

The dotnet namespace is added in v1.28.0. None of the semantic conventions for this namespace are generated.

Required semantic convention changes

Related to open-telemetry/weaver#584, this was not generated with a direct copy of the semantic-conventions repository checked-out at v1.28.0.

The latest (v0.12.0) version of weaver does not work with that version of semantic-conventions. The semantic-conventions repository was updated using the following command first:

$ rm model/{telemetry/resources-experimental.yaml,service/resources-experimental.yaml,feature-flag/events.yaml}

This removes name conflicts. These name conflicts are for things we are not generating, but the still block the generation tooling when it first validates the semantic-conventions.

Copy link

codecov bot commented Jan 31, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 82.2%. Comparing base (987efa6) to head (b87bb3d).
Report is 1 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@          Coverage Diff          @@
##            main   #6236   +/-   ##
=====================================
  Coverage   82.2%   82.2%           
=====================================
  Files        273     273           
  Lines      23744   23744           
=====================================
  Hits       19537   19537           
  Misses      3858    3858           
  Partials     349     349           

Requires custom modification of the semantic-conventions repository to
avoid validation warnings:

rm model/{telemetry/resources-experimental.yaml,service/resources-experimental.yaml,feature-flag/events.yaml}
@MrAlias MrAlias added this to the v1.35.0 milestone Jan 31, 2025
@MrAlias MrAlias marked this pull request as ready for review January 31, 2025 20:48
@MrAlias MrAlias merged commit 27aaa7a into open-telemetry:main Feb 3, 2025
32 checks passed
@MrAlias MrAlias deleted the semconv-v1.28.0 branch February 3, 2025 15:27
XSAM added a commit that referenced this pull request Mar 5, 2025
## Overview

This release is the last to support [Go 1.22].
The next release will require at least [Go 1.23].

### Added

- Add `ValueFromAttribute` and `KeyValueFromAttribute` in
`go.opentelemetry.io/otel/log`. (#6180)
- Add `EventName` and `SetEventName` to `Record` in
`go.opentelemetry.io/otel/log`. (#6187)
- Add `EventName` to `RecordFactory` in
`go.opentelemetry.io/otel/log/logtest`. (#6187)
- `AssertRecordEqual` in `go.opentelemetry.io/otel/log/logtest` checks
`Record.EventName`. (#6187)
- Add `EventName` and `SetEventName` to `Record` in
`go.opentelemetry.io/otel/sdk/log`. (#6193)
- Add `EventName` to `RecordFactory` in
`go.opentelemetry.io/otel/sdk/log/logtest`. (#6193)
- Emit `Record.EventName` field in
`go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`. (#6211)
- Emit `Record.EventName` field in
`go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#6211)
- Emit `Record.EventName` field in
`go.opentelemetry.io/otel/exporters/stdout/stdoutlog` (#6210)
- The `go.opentelemetry.io/otel/semconv/v1.28.0` package.
The package contains semantic conventions from the `v1.28.0` version of
the OpenTelemetry Semantic Conventions.
See the [migration documentation](./semconv/v1.28.0/MIGRATION.md) for
information on how to upgrade from
`go.opentelemetry.io/otel/semconv/v1.27.0`(#6236)
- The `go.opentelemetry.io/otel/semconv/v1.30.0` package.
The package contains semantic conventions from the `v1.30.0` version of
the OpenTelemetry Semantic Conventions.
See the [migration documentation](./semconv/v1.30.0/MIGRATION.md) for
information on how to upgrade from
`go.opentelemetry.io/otel/semconv/v1.28.0`(#6240)
- Document the pitfalls of using `Resource` as a comparable type.
`Resource.Equal` and `Resource.Equivalent` should be used instead.
(#6272)
- Support [Go 1.24]. (#6304)
- Add `FilterProcessor` and `EnabledParameters` in
`go.opentelemetry.io/otel/sdk/log`.
It replaces
`go.opentelemetry.io/otel/sdk/log/internal/x.FilterProcessor`.
Compared to previous version it additionally gives the possibility to
filter by resource and instrumentation scope. (#6317)

### Changed

- Update `github.com/prometheus/common` to v0.62.0., which changes the
`NameValidationScheme` to `NoEscaping`. This allows metrics names to
keep original delimiters (e.g. `.`), rather than replacing with
underscores. This is controlled by the `Content-Type` header, or can be
reverted by setting `NameValidationScheme` to `LegacyValidation` in
`github.com/prometheus/common/model`. (#6198)

### Fixes

- Eliminate goroutine leak for the processor returned by
`NewSimpleSpanProcessor` when `Shutdown` is called and the passed `ctx`
is canceled and `SpanExporter.Shutdown` has not returned. (#6368)
- Eliminate goroutine leak for the processor returned by
`NewBatchSpanProcessor` when `ForceFlush` is called and the passed `ctx`
is canceled and `SpanExporter.Export` has not returned. (#6369)

[Go 1.23]: https://go.dev/doc/go1.23
[Go 1.22]: https://go.dev/doc/go1.22

---------

Co-authored-by: Robert Pająk <[email protected]>
Co-authored-by: Tyler Yahn <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Generate semconv/v1.28.0
3 participants