All notable changes to the semantic-conventions package will be documented in this file.
- feat: update semantic conventions to v1.29.0 #5356 @trentm
- Semantic Conventions v1.29.0: changelog | latest docs
@opentelemetry/semantic-conventions
(stable) changes: none@opentelemetry/semantic-conventions/incubating
(unstable) changes: 8 newly deprecated exports, 95 added exports
8 newly deprecated exports
ATTR_DB_COSMOSDB_OPERATION_TYPE // db.cosmosdb.operation_type: No replacement at this time.
ATTR_DB_QUERY_PARAMETER // (key) => `db.query.parameter.${key}`: Replaced by `db.operation.parameter`.
ATTR_PROCESS_EXECUTABLE_BUILD_ID_PROFILING // process.executable.build_id.profiling: Replaced by `process.executable.build_id.htlhash`
ATTR_VCS_REPOSITORY_CHANGE_ID // vcs.repository.change.id: Deprecated, use `vcs.change.id` instead.
ATTR_VCS_REPOSITORY_CHANGE_TITLE // vcs.repository.change.title: Deprecated, use `vcs.change.title` instead.
ATTR_VCS_REPOSITORY_REF_NAME // vcs.repository.ref.name: Deprecated, use `vcs.ref.head.name` instead.
ATTR_VCS_REPOSITORY_REF_REVISION // vcs.repository.ref.revision: Deprecated, use `vcs.ref.head.revision` instead.
ATTR_VCS_REPOSITORY_REF_TYPE // vcs.repository.ref.type: Deprecated, use `vcs.ref.head.type` instead.
95 added exports
METRIC_CONTAINER_UPTIME // container.uptime
METRIC_DB_CLIENT_COSMOSDB_ACTIVE_INSTANCE_COUNT // db.client.cosmosdb.active_instance.count
METRIC_DB_CLIENT_COSMOSDB_OPERATION_REQUEST_CHARGE // db.client.cosmosdb.operation.request_charge
METRIC_DB_CLIENT_RESPONSE_RETURNED_ROWS // db.client.response.returned_rows
METRIC_K8S_NODE_NETWORK_ERRORS // k8s.node.network.errors
METRIC_K8S_NODE_NETWORK_IO // k8s.node.network.io
METRIC_K8S_NODE_UPTIME // k8s.node.uptime
METRIC_K8S_POD_NETWORK_ERRORS // k8s.pod.network.errors
METRIC_K8S_POD_NETWORK_IO // k8s.pod.network.io
METRIC_K8S_POD_UPTIME // k8s.pod.uptime
METRIC_SYSTEM_UPTIME // system.uptime
METRIC_VCS_CHANGE_COUNT // vcs.change.count
METRIC_VCS_CHANGE_DURATION // vcs.change.duration
METRIC_VCS_CHANGE_TIME_TO_APPROVAL // vcs.change.time_to_approval
METRIC_VCS_CONTRIBUTOR_COUNT // vcs.contributor.count
METRIC_VCS_REF_COUNT // vcs.ref.count
METRIC_VCS_REF_LINES_DELTA // vcs.ref.lines_delta
METRIC_VCS_REF_REVISIONS_DELTA // vcs.ref.revisions_delta
METRIC_VCS_REF_TIME // vcs.ref.time
METRIC_VCS_REPOSITORY_COUNT // vcs.repository.count
ATTR_DB_COSMOSDB_CONSISTENCY_LEVEL // db.cosmosdb.consistency_level
DB_COSMOSDB_CONSISTENCY_LEVEL_VALUE_BOUNDED_STALENESS // "BoundedStaleness"
DB_COSMOSDB_CONSISTENCY_LEVEL_VALUE_CONSISTENT_PREFIX // "ConsistentPrefix"
DB_COSMOSDB_CONSISTENCY_LEVEL_VALUE_EVENTUAL // "Eventual"
DB_COSMOSDB_CONSISTENCY_LEVEL_VALUE_SESSION // "Session"
DB_COSMOSDB_CONSISTENCY_LEVEL_VALUE_STRONG // "Strong"
ATTR_DB_COSMOSDB_REGIONS_CONTACTED // db.cosmosdb.regions_contacted
ATTR_DB_OPERATION_PARAMETER // (key) => `db.operation.parameter.${key}`
ATTR_DB_QUERY_SUMMARY // db.query.summary
ATTR_DB_RESPONSE_RETURNED_ROWS // db.response.returned_rows
ATTR_FEATURE_FLAG_CONTEXT_ID // feature_flag.context.id
ATTR_FEATURE_FLAG_EVALUATION_ERROR_MESSAGE // feature_flag.evaluation.error.message
ATTR_FEATURE_FLAG_EVALUATION_REASON // feature_flag.evaluation.reason
FEATURE_FLAG_EVALUATION_REASON_VALUE_CACHED // "cached"
FEATURE_FLAG_EVALUATION_REASON_VALUE_DEFAULT // "default"
FEATURE_FLAG_EVALUATION_REASON_VALUE_DISABLED // "disabled"
FEATURE_FLAG_EVALUATION_REASON_VALUE_ERROR // "error"
FEATURE_FLAG_EVALUATION_REASON_VALUE_SPLIT // "split"
FEATURE_FLAG_EVALUATION_REASON_VALUE_STALE // "stale"
FEATURE_FLAG_EVALUATION_REASON_VALUE_STATIC // "static"
FEATURE_FLAG_EVALUATION_REASON_VALUE_TARGETING_MATCH // "targeting_match"
FEATURE_FLAG_EVALUATION_REASON_VALUE_UNKNOWN // "unknown"
ATTR_FEATURE_FLAG_SET_ID // feature_flag.set.id
ATTR_FEATURE_FLAG_VERSION // feature_flag.version
ATTR_GEN_AI_OPENAI_RESPONSE_SYSTEM_FINGERPRINT // gen_ai.openai.response.system_fingerprint
GEN_AI_OPERATION_NAME_VALUE_EMBEDDINGS // "embeddings"
ATTR_GEN_AI_REQUEST_ENCODING_FORMATS // gen_ai.request.encoding_formats
GEN_AI_SYSTEM_VALUE_AWS_BEDROCK // "aws.bedrock"
GEN_AI_SYSTEM_VALUE_AZ_AI_INFERENCE // "az.ai.inference"
GEN_AI_SYSTEM_VALUE_IBM_WATSONX_AI // "ibm.watsonx.ai"
ATTR_GEO_CONTINENT_CODE // geo.continent.code
GEO_CONTINENT_CODE_VALUE_AF // "AF"
GEO_CONTINENT_CODE_VALUE_AN // "AN"
GEO_CONTINENT_CODE_VALUE_AS // "AS"
GEO_CONTINENT_CODE_VALUE_EU // "EU"
GEO_CONTINENT_CODE_VALUE_NA // "NA"
GEO_CONTINENT_CODE_VALUE_OC // "OC"
GEO_CONTINENT_CODE_VALUE_SA // "SA"
ATTR_GEO_COUNTRY_ISO_CODE // geo.country.iso_code
ATTR_GEO_LOCALITY_NAME // geo.locality.name
ATTR_GEO_LOCATION_LAT // geo.location.lat
ATTR_GEO_LOCATION_LON // geo.location.lon
ATTR_GEO_POSTAL_CODE // geo.postal_code
ATTR_GEO_REGION_ISO_CODE // geo.region.iso_code
ATTR_PROCESS_EXECUTABLE_BUILD_ID_HTLHASH // process.executable.build_id.htlhash
ATTR_PROCESS_LINUX_CGROUP // process.linux.cgroup
ATTR_USER_AGENT_SYNTHETIC_TYPE // user_agent.synthetic.type
USER_AGENT_SYNTHETIC_TYPE_VALUE_BOT // "bot"
USER_AGENT_SYNTHETIC_TYPE_VALUE_TEST // "test"
ATTR_VCS_CHANGE_ID // vcs.change.id
ATTR_VCS_CHANGE_STATE // vcs.change.state
VCS_CHANGE_STATE_VALUE_CLOSED // "closed"
VCS_CHANGE_STATE_VALUE_MERGED // "merged"
VCS_CHANGE_STATE_VALUE_OPEN // "open"
VCS_CHANGE_STATE_VALUE_WIP // "wip"
ATTR_VCS_CHANGE_TITLE // vcs.change.title
ATTR_VCS_LINE_CHANGE_TYPE // vcs.line_change.type
VCS_LINE_CHANGE_TYPE_VALUE_ADDED // "added"
VCS_LINE_CHANGE_TYPE_VALUE_REMOVED // "removed"
ATTR_VCS_REF_BASE_NAME // vcs.ref.base.name
ATTR_VCS_REF_BASE_REVISION // vcs.ref.base.revision
ATTR_VCS_REF_BASE_TYPE // vcs.ref.base.type
VCS_REF_BASE_TYPE_VALUE_BRANCH // "branch"
VCS_REF_BASE_TYPE_VALUE_TAG // "tag"
ATTR_VCS_REF_HEAD_NAME // vcs.ref.head.name
ATTR_VCS_REF_HEAD_REVISION // vcs.ref.head.revision
ATTR_VCS_REF_HEAD_TYPE // vcs.ref.head.type
VCS_REF_HEAD_TYPE_VALUE_BRANCH // "branch"
VCS_REF_HEAD_TYPE_VALUE_TAG // "tag"
ATTR_VCS_REF_TYPE // vcs.ref.type
VCS_REF_TYPE_VALUE_BRANCH // "branch"
VCS_REF_TYPE_VALUE_TAG // "tag"
ATTR_VCS_REVISION_DELTA_DIRECTION // vcs.revision_delta.direction
VCS_REVISION_DELTA_DIRECTION_VALUE_AHEAD // "ahead"
VCS_REVISION_DELTA_DIRECTION_VALUE_BEHIND // "behind"
- docs: Document suggested usage of unstable semconv: copy relevant definitions into your code base. #5182 @trentm
- feat: update semantic conventions to 1.28.0 #5181 @trentm
- chore: Improve documentation on entry-points (top-level and "incubating") and on deprecations. #5025 @trentm
- chore: Update the comments of some deprecated constants to point to the currently relevant replacement constant, if any. #5160 @trentm
- chore: Minor improvements to formatting of comments. #5100 @trentm
- Version bump only
- Note: This package will now be versioned according to the version of semantic conventions being provided.
Note: This package will now be versioned according to the version of semantic conventions being provided.
- feat(semconv): update semantic conventions to 1.27 (from 1.7.0) #4690 @dyladan
- Exported names have changed to
ATTR_{name}
for attributes (e.g.ATTR_HTTP_REQUEST_METHOD
),{name}_VALUE_{value}
for enumeration values (e.g.HTTP_REQUEST_METHOD_VALUE_POST
), andMETRIC_{name}
for metrics. Exported names from previous versions are deprecated. - Import
@opentelemetry/semantic-conventions
for stable semantic conventions. Import@opentelemetry/semantic-conventions/incubating
for all semantic conventions, stable and unstable.
- Exported names have changed to