diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index d0f79927ac..c0858bd806 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -69,8 +69,8 @@
/model/signalr/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-dotnet-approver @open-telemetry/semconv-http-approvers
# Gen-AI semantic conventions
-/docs/gen-ai/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-llm-approvers
-/model/gen-ai/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-llm-approvers
+/docs/gen-ai/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-genai-approvers
+/model/gen-ai/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-genai-approvers
# Security semantic conventions
/model/dns/ @open-telemetry/specs-semconv-approvers @open-telemetry/semconv-security-approvers
diff --git a/.github/auto_assign_issue.yml b/.github/auto_assign_issue.yml
deleted file mode 100644
index 82ebdb891d..0000000000
--- a/.github/auto_assign_issue.yml
+++ /dev/null
@@ -1,18 +0,0 @@
-# Set to true to add reviewers to issues/PRs
-addReviewers: false
-
-# Set to true to add assignees to issues/PRs
-addAssignees: true
-
-# A list of assignees, overrides reviewers if set
-assignees:
- - AlexanderWert
- - arminru
- - joaopgrassi
- - jsuereth
- - reyang
-
-# A number of assignees to add to the issues/PRs
-# Set to 0 to add all of the assignees.
-# Uses numberOfReviewers if unset.
-numberOfAssignees: 1
diff --git a/.github/auto_assign_pr.yml b/.github/auto_assign_pr.yml
deleted file mode 100644
index 58d2db55b0..0000000000
--- a/.github/auto_assign_pr.yml
+++ /dev/null
@@ -1,21 +0,0 @@
-# Set to true to add reviewers to pull requests
-addReviewers: false
-
-# Set to true to add assignees to pull requests
-addAssignees: true
-
-# Set to true to add assignees from different groups to pull requests
-useAssigneeGroups: true
-
-# A list of assignees, split into different groups, to be added to pull requests (GitHub user name)
-assigneeGroups:
- maintainers:
- - AlexanderWert
- - arminru
- - joaopgrassi
- - jsuereth
- - reyang
-
-# A number of assignees added to the pull request
-# Set 0 to add all the assignees (default: 0)
-numberOfAssignees: 1
diff --git a/.github/workflows/auto-assign-issue.yml b/.github/workflows/auto-assign-issue.yml
deleted file mode 100644
index df28e16159..0000000000
--- a/.github/workflows/auto-assign-issue.yml
+++ /dev/null
@@ -1,12 +0,0 @@
-name: 'Auto Assign Issue'
-on:
- issues:
- types: [opened]
-jobs:
- run:
- runs-on: ubuntu-latest
- steps:
- - uses: bubkoo/auto-assign@d5c3a5711d7fd917f7fbd746e9c6fc044f29009f
- with:
- CONFIG_FILE: ".github/auto_assign_issue.yml"
- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/auto-assign-pr.yml b/.github/workflows/auto-assign-pr.yml
deleted file mode 100644
index 694e4fea22..0000000000
--- a/.github/workflows/auto-assign-pr.yml
+++ /dev/null
@@ -1,14 +0,0 @@
-name: 'Auto Assign PR'
-on:
- pull_request_target:
- types: [opened, ready_for_review]
-
-jobs:
- add-owner:
- runs-on: ubuntu-latest
- steps:
- - name: run
- uses: kentaro-m/auto-assign-action@v1.1.1
- with:
- configuration-path: ".github/auto_assign_pr.yml"
- repo-token: '${{ secrets.GITHUB_TOKEN }}'
diff --git a/Makefile b/Makefile
index 26e7a2cf83..1860a86e8f 100644
--- a/Makefile
+++ b/Makefile
@@ -140,7 +140,6 @@ attribute-registry-generation:
--templates=/home/weaver/templates \
markdown \
/home/weaver/target/attributes-registry/
- npm run fix:format
# Check if current markdown tables differ from the ones that would be generated from YAML definitions (weaver).
.PHONY: table-check
@@ -178,7 +177,7 @@ check: misspell markdownlint check-format markdown-toc compatibility-check markd
# Attempt to fix issues / regenerate tables.
.PHONY: fix
-fix: table-generation attribute-registry-generation misspell-correction fix-format markdown-toc
+fix: table-generation attribute-registry-generation misspell-correction markdown-toc
@echo "All autofixes complete"
.PHONY: install-tools
diff --git a/docs/attributes-registry/android.md b/docs/attributes-registry/android.md
index 1155f6d794..4870e52fe3 100644
--- a/docs/attributes-registry/android.md
+++ b/docs/attributes-registry/android.md
@@ -13,24 +13,24 @@
The Android platform on which the Android application is running.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `android.os.api_level` | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` |  |
## Deprecated Android Attributes
This document defines attributes that represents an occurrence of a lifecycle transition on the Android platform.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `android.state` | string | Deprecated use the `device.app.lifecycle` event definition including `android.state` as a payload field instead. [1] | `created`; `background`; `foreground` | 
Replaced by `device.app.lifecycle`. |
**[1]:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), and from which the `OS identifiers` are derived.
`android.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `background` | Any time after Activity.onPause() or, if the app has no Activity, Context.stopService() has been called when the app was in the foreground state. |  |
-| `created` | Any time before Activity.onResume() or, if the app has no Activity, Context.startService() has been called in the app for the first time. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `background` | Any time after Activity.onPause() or, if the app has no Activity, Context.stopService() has been called when the app was in the foreground state. |  |
+| `created` | Any time before Activity.onResume() or, if the app has no Activity, Context.startService() has been called in the app for the first time. |  |
| `foreground` | Any time after Activity.onResume() or, if the app has no Activity, Context.startService() has been called when the app was in either the created or background states. |  |
diff --git a/docs/attributes-registry/artifact.md b/docs/attributes-registry/artifact.md
index 00da022d28..e4b2b72ece 100644
--- a/docs/attributes-registry/artifact.md
+++ b/docs/attributes-registry/artifact.md
@@ -10,15 +10,15 @@
This group describes attributes specific to artifacts. Artifacts are files or other immutable objects that are intended for distribution. This definition aligns directly with the [SLSA](https://slsa.dev/spec/v1.0/terminology#package-model) package model.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `artifact.attestation.filename` | string | The provenance filename of the built attestation which directly relates to the build artifact filename. This filename SHOULD accompany the artifact at publish time. See the [SLSA Relationship](https://slsa.dev/spec/v1.0/distributing-provenance#relationship-between-artifacts-and-attestations) specification for more information. | `golang-binary-amd64-v0.1.0.attestation`; `docker-image-amd64-v0.1.0.intoto.json1`; `release-1.tar.gz.attestation`; `file-name-package.tar.gz.intoto.json1` |  |
-| `artifact.attestation.hash` | string | The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), of the built attestation. Some envelopes in the software attestation space also refer to this as the [digest](https://github.com/in-toto/attestation/blob/main/spec/README.md#in-toto-attestation-framework-spec). | `1b31dfcd5b7f9267bf2ff47651df1cfb9147b9e4df1f335accf65b4cda498408` |  |
-| `artifact.attestation.id` | string | The id of the build [software attestation](https://slsa.dev/attestation-model). | `123` |  |
-| `artifact.filename` | string | The human readable file name of the artifact, typically generated during build and release processes. Often includes the package name and version in the file name. [1] | `golang-binary-amd64-v0.1.0`; `docker-image-amd64-v0.1.0`; `release-1.tar.gz`; `file-name-package.tar.gz` |  |
-| `artifact.hash` | string | The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), often found in checksum.txt on a release of the artifact and used to verify package integrity. [2] | `9ff4c52759e2c4ac70b7d517bc7fcdc1cda631ca0045271ddd1b192544f8a3e9` |  |
-| `artifact.purl` | string | The [Package URL](https://github.com/package-url/purl-spec) of the [package artifact](https://slsa.dev/spec/v1.0/terminology#package-model) provides a standard way to identify and locate the packaged artifact. | `pkg:github/package-url/purl-spec@1209109710924`; `pkg:npm/foo@12.12.3` |  |
-| `artifact.version` | string | The version of the artifact. | `v0.1.0`; `1.2.1`; `122691-build` |  |
+| `artifact.attestation.hash` | string | The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), of the built attestation. Some envelopes in the software attestation space also refer to this as the [digest](https://github.com/in-toto/attestation/blob/main/spec/README.md#in-toto-attestation-framework-spec). | `1b31dfcd5b7f9267bf2ff47651df1cfb9147b9e4df1f335accf65b4cda498408` |  |
+| `artifact.attestation.id` | string | The id of the build [software attestation](https://slsa.dev/attestation-model). | `123` |  |
+| `artifact.filename` | string | The human readable file name of the artifact, typically generated during build and release processes. Often includes the package name and version in the file name. [1] | `golang-binary-amd64-v0.1.0`; `docker-image-amd64-v0.1.0`; `release-1.tar.gz`; `file-name-package.tar.gz` |  |
+| `artifact.hash` | string | The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), often found in checksum.txt on a release of the artifact and used to verify package integrity. [2] | `9ff4c52759e2c4ac70b7d517bc7fcdc1cda631ca0045271ddd1b192544f8a3e9` |  |
+| `artifact.purl` | string | The [Package URL](https://github.com/package-url/purl-spec) of the [package artifact](https://slsa.dev/spec/v1.0/terminology#package-model) provides a standard way to identify and locate the packaged artifact. | `pkg:github/package-url/purl-spec@1209109710924`; `pkg:npm/foo@12.12.3` |  |
+| `artifact.version` | string | The version of the artifact. | `v0.1.0`; `1.2.1`; `122691-build` |  |
**[1]:** This file name can also act as the [Package Name](https://slsa.dev/spec/v1.0/terminology#package-model)
in cases where the package ecosystem maps accordingly.
diff --git a/docs/attributes-registry/aspnetcore.md b/docs/attributes-registry/aspnetcore.md
index f92995ac2e..30ef935ff6 100644
--- a/docs/attributes-registry/aspnetcore.md
+++ b/docs/attributes-registry/aspnetcore.md
@@ -10,37 +10,37 @@
ASP.NET Core attributes
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | ---------------------------------------------------------- |
-| `aspnetcore.diagnostics.exception.result` | string | ASP.NET Core exception middleware handling result | `handled`; `unhandled` |  |
-| `aspnetcore.diagnostics.handler.type` | string | Full type name of the [`IExceptionHandler`](https://learn.microsoft.com/dotnet/api/microsoft.aspnetcore.diagnostics.iexceptionhandler) implementation that handled the exception. | `Contoso.MyHandler` |  |
-| `aspnetcore.rate_limiting.policy` | string | Rate limiting policy name. | `fixed`; `sliding`; `token` |  |
-| `aspnetcore.rate_limiting.result` | string | Rate-limiting result, shows whether the lease was acquired or contains a rejection reason | `acquired`; `request_canceled` |  |
-| `aspnetcore.request.is_unhandled` | boolean | Flag indicating if request was handled by the application pipeline. | `true` |  |
-| `aspnetcore.routing.is_fallback` | boolean | A value that indicates whether the matched route is a fallback route. | `true` |  |
-| `aspnetcore.routing.match_status` | string | Match result - success or failure | `success`; `failure` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `aspnetcore.diagnostics.exception.result` | string | ASP.NET Core exception middleware handling result | `handled`; `unhandled` |  |
+| `aspnetcore.diagnostics.handler.type` | string | Full type name of the [`IExceptionHandler`](https://learn.microsoft.com/dotnet/api/microsoft.aspnetcore.diagnostics.iexceptionhandler) implementation that handled the exception. | `Contoso.MyHandler` |  |
+| `aspnetcore.rate_limiting.policy` | string | Rate limiting policy name. | `fixed`; `sliding`; `token` |  |
+| `aspnetcore.rate_limiting.result` | string | Rate-limiting result, shows whether the lease was acquired or contains a rejection reason | `acquired`; `request_canceled` |  |
+| `aspnetcore.request.is_unhandled` | boolean | Flag indicating if request was handled by the application pipeline. | `true` |  |
+| `aspnetcore.routing.is_fallback` | boolean | A value that indicates whether the matched route is a fallback route. | `true` |  |
+| `aspnetcore.routing.match_status` | string | Match result - success or failure | `success`; `failure` |  |
`aspnetcore.diagnostics.exception.result` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----------- | ---------------------------------------------------------------- | ---------------------------------------------------------- |
-| `aborted` | Exception handling didn't run because the request was aborted. |  |
-| `handled` | Exception was handled by the exception handling middleware. |  |
-| `skipped` | Exception handling was skipped because the response had started. |  |
-| `unhandled` | Exception was not handled by the exception handling middleware. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `aborted` | Exception handling didn't run because the request was aborted. |  |
+| `handled` | Exception was handled by the exception handling middleware. |  |
+| `skipped` | Exception handling was skipped because the response had started. |  |
+| `unhandled` | Exception was not handled by the exception handling middleware. |  |
`aspnetcore.rate_limiting.result` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------------ | -------------------------------------------------- | ---------------------------------------------------------- |
-| `acquired` | Lease was acquired |  |
+| Value | Description | Stability |
+|---|---|---|
+| `acquired` | Lease was acquired |  |
| `endpoint_limiter` | Lease request was rejected by the endpoint limiter |  |
-| `global_limiter` | Lease request was rejected by the global limiter |  |
-| `request_canceled` | Lease request was canceled |  |
+| `global_limiter` | Lease request was rejected by the global limiter |  |
+| `request_canceled` | Lease request was canceled |  |
`aspnetcore.routing.match_status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | --------------- | ---------------------------------------------------------- |
-| `failure` | Match failed |  |
+| Value | Description | Stability |
+|---|---|---|
+| `failure` | Match failed |  |
| `success` | Match succeeded |  |
diff --git a/docs/attributes-registry/aws.md b/docs/attributes-registry/aws.md
index cb1f78b8d4..90ca3fa8f3 100644
--- a/docs/attributes-registry/aws.md
+++ b/docs/attributes-registry/aws.md
@@ -18,74 +18,74 @@
This document defines generic attributes for AWS services.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `aws.request_id` | string | The AWS request ID as returned in the response headers `x-amz-request-id` or `x-amz-requestid`. | `79b9da39-b7ae-508a-a6bc-864b2829c622`; `C9ER4AJX75574TDJ` |  |
## Amazon DynamoDB Attributes
This document defines attributes for AWS DynamoDB.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `aws.dynamodb.attribute_definitions` | string[] | The JSON-serialized value of each item in the `AttributeDefinitions` request field. | `["{ \"AttributeName\": \"string\", \"AttributeType\": \"string\" }"]` |  |
-| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `["lives", "id"]` |  |
-| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. | |  |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]` |  |
-| `aws.dynamodb.count` | int | The value of the `Count` response parameter. | `10` |  |
-| `aws.dynamodb.exclusive_start_table` | string | The value of the `ExclusiveStartTableName` request parameter. | `Users`; `CatsTable` |  |
-| `aws.dynamodb.global_secondary_index_updates` | string[] | The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field. | `["{ \"Create\": { \"IndexName\": \"string\", \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }"]` |  |
-| `aws.dynamodb.global_secondary_indexes` | string[] | The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field | `["{ \"IndexName\": \"string\", \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }"]` |  |
-| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` |  |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` |  |
-| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` |  |
-| `aws.dynamodb.local_secondary_indexes` | string[] | The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field. | `["{ \"IndexArn\": \"string\", \"IndexName\": \"string\", \"IndexSizeBytes\": number, \"ItemCount\": number, \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" } }"]` |  |
-| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` |  |
-| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` |  |
-| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` |  |
-| `aws.dynamodb.scan_forward` | boolean | The value of the `ScanIndexForward` request parameter. | |  |
-| `aws.dynamodb.scanned_count` | int | The value of the `ScannedCount` response parameter. | `50` |  |
-| `aws.dynamodb.segment` | int | The value of the `Segment` request parameter. | `10` |  |
-| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` |  |
-| `aws.dynamodb.table_count` | int | The number of items in the `TableNames` response parameter. | `20` |  |
-| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `["Users", "Cats"]` |  |
-| `aws.dynamodb.total_segments` | int | The value of the `TotalSegments` request parameter. | `100` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `aws.dynamodb.attribute_definitions` | string[] | The JSON-serialized value of each item in the `AttributeDefinitions` request field. | `["{ \"AttributeName\": \"string\", \"AttributeType\": \"string\" }"]` |  |
+| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `["lives", "id"]` |  |
+| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. | |  |
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]` |  |
+| `aws.dynamodb.count` | int | The value of the `Count` response parameter. | `10` |  |
+| `aws.dynamodb.exclusive_start_table` | string | The value of the `ExclusiveStartTableName` request parameter. | `Users`; `CatsTable` |  |
+| `aws.dynamodb.global_secondary_index_updates` | string[] | The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field. | `["{ \"Create\": { \"IndexName\": \"string\", \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }"]` |  |
+| `aws.dynamodb.global_secondary_indexes` | string[] | The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field | `["{ \"IndexName\": \"string\", \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }"]` |  |
+| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` |  |
+| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` |  |
+| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` |  |
+| `aws.dynamodb.local_secondary_indexes` | string[] | The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field. | `["{ \"IndexArn\": \"string\", \"IndexName\": \"string\", \"IndexSizeBytes\": number, \"ItemCount\": number, \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" } }"]` |  |
+| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` |  |
+| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` |  |
+| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` |  |
+| `aws.dynamodb.scan_forward` | boolean | The value of the `ScanIndexForward` request parameter. | |  |
+| `aws.dynamodb.scanned_count` | int | The value of the `ScannedCount` response parameter. | `50` |  |
+| `aws.dynamodb.segment` | int | The value of the `Segment` request parameter. | `10` |  |
+| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` |  |
+| `aws.dynamodb.table_count` | int | The number of items in the `TableNames` response parameter. | `20` |  |
+| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `["Users", "Cats"]` |  |
+| `aws.dynamodb.total_segments` | int | The value of the `TotalSegments` request parameter. | `100` |  |
## Amazon ECS Attributes
This document defines attributes for AWS Elastic Container Service (ECS).
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `aws.ecs.cluster.arn` | string | The ARN of an [ECS cluster](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/clusters.html). | `arn:aws:ecs:us-west-2:123456789123:cluster/my-cluster` |  |
-| `aws.ecs.container.arn` | string | The Amazon Resource Name (ARN) of an [ECS container instance](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_instances.html). | `arn:aws:ecs:us-west-1:123456789123:container/32624152-9086-4f0e-acae-1a75b14fe4d9` |  |
-| `aws.ecs.launchtype` | string | The [launch type](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) for an ECS task. | `ec2`; `fargate` |  |
-| `aws.ecs.task.arn` | string | The ARN of a running [ECS task](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids). | `arn:aws:ecs:us-west-1:123456789123:task/10838bed-421f-43ef-870a-f43feacbbb5b`; `arn:aws:ecs:us-west-1:123456789123:task/my-cluster/task-id/23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbd` |  |
-| `aws.ecs.task.family` | string | The family name of the [ECS task definition](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) used to create the ECS task. | `opentelemetry-family` |  |
-| `aws.ecs.task.id` | string | The ID of a running ECS task. The ID MUST be extracted from `task.arn`. | `10838bed-421f-43ef-870a-f43feacbbb5b`; `23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbd` |  |
-| `aws.ecs.task.revision` | string | The revision for the task definition used to create the ECS task. | `8`; `26` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `aws.ecs.cluster.arn` | string | The ARN of an [ECS cluster](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/clusters.html). | `arn:aws:ecs:us-west-2:123456789123:cluster/my-cluster` |  |
+| `aws.ecs.container.arn` | string | The Amazon Resource Name (ARN) of an [ECS container instance](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_instances.html). | `arn:aws:ecs:us-west-1:123456789123:container/32624152-9086-4f0e-acae-1a75b14fe4d9` |  |
+| `aws.ecs.launchtype` | string | The [launch type](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) for an ECS task. | `ec2`; `fargate` |  |
+| `aws.ecs.task.arn` | string | The ARN of a running [ECS task](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids). | `arn:aws:ecs:us-west-1:123456789123:task/10838bed-421f-43ef-870a-f43feacbbb5b`; `arn:aws:ecs:us-west-1:123456789123:task/my-cluster/task-id/23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbd` |  |
+| `aws.ecs.task.family` | string | The family name of the [ECS task definition](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) used to create the ECS task. | `opentelemetry-family` |  |
+| `aws.ecs.task.id` | string | The ID of a running ECS task. The ID MUST be extracted from `task.arn`. | `10838bed-421f-43ef-870a-f43feacbbb5b`; `23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbd` |  |
+| `aws.ecs.task.revision` | string | The revision for the task definition used to create the ECS task. | `8`; `26` |  |
`aws.ecs.launchtype` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | ----------- | ---------------------------------------------------------------- |
-| `ec2` | ec2 |  |
-| `fargate` | fargate |  |
+| Value | Description | Stability |
+|---|---|---|
+| `ec2` | ec2 |  |
+| `fargate` | fargate |  |
## Amazon EKS Attributes
This document defines attributes for AWS Elastic Kubernetes Service (EKS).
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | -------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `aws.eks.cluster.arn` | string | The ARN of an EKS cluster. | `arn:aws:ecs:us-west-2:123456789123:cluster/my-cluster` |  |
## Amazon Lambda Attributes
This document defines attributes for AWS Lambda.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `aws.lambda.invoked_arn` | string | The full invoked ARN as provided on the `Context` passed to the function (`Lambda-Runtime-Invoked-Function-Arn` header on the `/runtime/invocation/next` applicable). [1] | `arn:aws:lambda:us-east-1:123456:function:myfunction:myalias` |  |
**[1]:** This may be different from `cloud.resource_id` if an alias is involved.
@@ -94,12 +94,12 @@ This document defines attributes for AWS Lambda.
This document defines attributes for AWS Logs.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `aws.log.group.arns` | string[] | The Amazon Resource Name(s) (ARN) of the AWS log group(s). [2] | `["arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:*"]` |  |
-| `aws.log.group.names` | string[] | The name(s) of the AWS log group(s) an application is writing to. [3] | `["/aws/lambda/my-function", "opentelemetry-service"]` |  |
-| `aws.log.stream.arns` | string[] | The ARN(s) of the AWS log stream(s). [4] | `["arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:log-stream:logs/main/10838bed-421f-43ef-870a-f43feacbbb5b"]` |  |
-| `aws.log.stream.names` | string[] | The name(s) of the AWS log stream(s) an application is writing to. | `["logs/main/10838bed-421f-43ef-870a-f43feacbbb5b"]` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `aws.log.group.arns` | string[] | The Amazon Resource Name(s) (ARN) of the AWS log group(s). [2] | `["arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:*"]` |  |
+| `aws.log.group.names` | string[] | The name(s) of the AWS log group(s) an application is writing to. [3] | `["/aws/lambda/my-function", "opentelemetry-service"]` |  |
+| `aws.log.stream.arns` | string[] | The ARN(s) of the AWS log stream(s). [4] | `["arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:log-stream:logs/main/10838bed-421f-43ef-870a-f43feacbbb5b"]` |  |
+| `aws.log.stream.names` | string[] | The name(s) of the AWS log stream(s) an application is writing to. | `["logs/main/10838bed-421f-43ef-870a-f43feacbbb5b"]` |  |
**[2]:** See the [log group ARN format documentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-access-control-overview-cwl.html#CWL_ARN_Format).
@@ -111,14 +111,14 @@ This document defines attributes for AWS Logs.
This document defines attributes for AWS S3.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `aws.s3.bucket` | string | The S3 bucket name the request refers to. Corresponds to the `--bucket` parameter of the [S3 API](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) operations. [5] | `some-bucket-name` |  |
-| `aws.s3.copy_source` | string | The source object (in the form `bucket`/`key`) for the copy operation. [6] | `someFile.yml` |  |
-| `aws.s3.delete` | string | The delete request container that specifies the objects to be deleted. [7] | `Objects=[{Key=string,VersionId=string},{Key=string,VersionId=string}],Quiet=boolean` |  |
-| `aws.s3.key` | string | The S3 object key the request refers to. Corresponds to the `--key` parameter of the [S3 API](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) operations. [8] | `someFile.yml` |  |
-| `aws.s3.part_number` | int | The part number of the part being uploaded in a multipart-upload operation. This is a positive integer between 1 and 10,000. [9] | `3456` |  |
-| `aws.s3.upload_id` | string | Upload ID that identifies the multipart upload. [10] | `dfRtDYWFbkRONycy.Yxwh66Yjlx.cph0gtNBtJ` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `aws.s3.bucket` | string | The S3 bucket name the request refers to. Corresponds to the `--bucket` parameter of the [S3 API](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) operations. [5] | `some-bucket-name` |  |
+| `aws.s3.copy_source` | string | The source object (in the form `bucket`/`key`) for the copy operation. [6] | `someFile.yml` |  |
+| `aws.s3.delete` | string | The delete request container that specifies the objects to be deleted. [7] | `Objects=[{Key=string,VersionId=string},{Key=string,VersionId=string}],Quiet=boolean` |  |
+| `aws.s3.key` | string | The S3 object key the request refers to. Corresponds to the `--key` parameter of the [S3 API](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) operations. [8] | `someFile.yml` |  |
+| `aws.s3.part_number` | int | The part number of the part being uploaded in a multipart-upload operation. This is a positive integer between 1 and 10,000. [9] | `3456` |  |
+| `aws.s3.upload_id` | string | Upload ID that identifies the multipart upload. [10] | `dfRtDYWFbkRONycy.Yxwh66Yjlx.cph0gtNBtJ` |  |
**[5]:** The `bucket` attribute is applicable to all S3 operations that reference a bucket, i.e. that require the bucket name as a mandatory parameter.
This applies to almost all S3 operations except `list-buckets`.
diff --git a/docs/attributes-registry/azure.md b/docs/attributes-registry/azure.md
index 278423c541..78cd3a030d 100644
--- a/docs/attributes-registry/azure.md
+++ b/docs/attributes-registry/azure.md
@@ -10,7 +10,7 @@
This document defines generic attributes for Azure SDK.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `az.namespace` | string | [Azure Resource Provider Namespace](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers) as recognized by the client. | `Microsoft.Storage`; `Microsoft.KeyVault`; `Microsoft.ServiceBus` |  |
-| `az.service_request_id` | string | The unique identifier of the service request. It's generated by the Azure service and returned with the response. | `00000000-0000-0000-0000-000000000000` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `az.namespace` | string | [Azure Resource Provider Namespace](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers) as recognized by the client. | `Microsoft.Storage`; `Microsoft.KeyVault`; `Microsoft.ServiceBus` |  |
+| `az.service_request_id` | string | The unique identifier of the service request. It's generated by the Azure service and returned with the response. | `00000000-0000-0000-0000-000000000000` |  |
diff --git a/docs/attributes-registry/browser.md b/docs/attributes-registry/browser.md
index b206ee787f..2e16e99669 100644
--- a/docs/attributes-registry/browser.md
+++ b/docs/attributes-registry/browser.md
@@ -10,12 +10,12 @@
The web browser attributes
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------ | -------- | ----------------------------------------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------- |
-| `browser.brands` | string[] | Array of brand name and version separated by a space [1] | `[" Not A;Brand 99", "Chromium 99", "Chrome 99"]` |  |
-| `browser.language` | string | Preferred language of the user using the browser [2] | `en`; `en-US`; `fr`; `fr-FR` |  |
-| `browser.mobile` | boolean | A boolean that is true if the browser is running on a mobile device [3] | |  |
-| `browser.platform` | string | The platform on which the browser is running [4] | `Windows`; `macOS`; `Android` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `browser.brands` | string[] | Array of brand name and version separated by a space [1] | `[" Not A;Brand 99", "Chromium 99", "Chrome 99"]` |  |
+| `browser.language` | string | Preferred language of the user using the browser [2] | `en`; `en-US`; `fr`; `fr-FR` |  |
+| `browser.mobile` | boolean | A boolean that is true if the browser is running on a mobile device [3] | |  |
+| `browser.platform` | string | The platform on which the browser is running [4] | `Windows`; `macOS`; `Android` |  |
**[1]:** This value is intended to be taken from the [UA client hints API](https://wicg.github.io/ua-client-hints/#interface) (`navigator.userAgentData.brands`).
diff --git a/docs/attributes-registry/cicd.md b/docs/attributes-registry/cicd.md
index 444adae487..42afe6ee44 100644
--- a/docs/attributes-registry/cicd.md
+++ b/docs/attributes-registry/cicd.md
@@ -8,21 +8,21 @@
## CICD Pipeline Attributes
-This group describes attributes specific to pipelines within a Continuous Integration and Continuous Deployment (CI/CD) system. A [pipeline]() in this case is a series of steps that are performed in order to deliver a new version of software. This aligns with the [Britannica](https://www.britannica.com/dictionary/pipeline) definition of a pipeline where a **pipeline** is the system for developing and producing something. In the context of CI/CD, a pipeline produces or delivers software.
+This group describes attributes specific to pipelines within a Continuous Integration and Continuous Deployment (CI/CD) system. A [pipeline](https://en.wikipedia.org/wiki/Pipeline_(computing)) in this case is a series of steps that are performed in order to deliver a new version of software. This aligns with the [Britannica](https://www.britannica.com/dictionary/pipeline) definition of a pipeline where a **pipeline** is the system for developing and producing something. In the context of CI/CD, a pipeline produces or delivers software.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `cicd.pipeline.name` | string | The human readable name of the pipeline within a CI/CD system. | `Build and Test`; `Lint`; `Deploy Go Project`; `deploy_to_environment` |  |
-| `cicd.pipeline.run.id` | string | The unique identifier of a pipeline run within a CI/CD system. | `120912` |  |
-| `cicd.pipeline.task.name` | string | The human readable name of a task within a pipeline. Task here most closely aligns with a [computing process]() in a pipeline. Other terms for tasks include commands, steps, and procedures. | `Run GoLang Linter`; `Go Build`; `go-test`; `deploy_binary` |  |
-| `cicd.pipeline.task.run.id` | string | The unique identifier of a task run within a pipeline. | `12097` |  |
-| `cicd.pipeline.task.run.url.full` | string | The [URL](https://en.wikipedia.org/wiki/URL) of the pipeline run providing the complete address in order to locate and identify the pipeline run. | `https://github.com/open-telemetry/semantic-conventions/actions/runs/9753949763/job/26920038674?pr=1075` |  |
-| `cicd.pipeline.task.type` | string | The type of the task within a pipeline. | `build`; `test`; `deploy` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `cicd.pipeline.name` | string | The human readable name of the pipeline within a CI/CD system. | `Build and Test`; `Lint`; `Deploy Go Project`; `deploy_to_environment` |  |
+| `cicd.pipeline.run.id` | string | The unique identifier of a pipeline run within a CI/CD system. | `120912` |  |
+| `cicd.pipeline.task.name` | string | The human readable name of a task within a pipeline. Task here most closely aligns with a [computing process](https://en.wikipedia.org/wiki/Pipeline_(computing)) in a pipeline. Other terms for tasks include commands, steps, and procedures. | `Run GoLang Linter`; `Go Build`; `go-test`; `deploy_binary` |  |
+| `cicd.pipeline.task.run.id` | string | The unique identifier of a task run within a pipeline. | `12097` |  |
+| `cicd.pipeline.task.run.url.full` | string | The [URL](https://en.wikipedia.org/wiki/URL) of the pipeline run providing the complete address in order to locate and identify the pipeline run. | `https://github.com/open-telemetry/semantic-conventions/actions/runs/9753949763/job/26920038674?pr=1075` |  |
+| `cicd.pipeline.task.type` | string | The type of the task within a pipeline. | `build`; `test`; `deploy` |  |
`cicd.pipeline.task.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ----------- | ---------------------------------------------------------------- |
-| `build` | build |  |
-| `deploy` | deploy |  |
-| `test` | test |  |
+| Value | Description | Stability |
+|---|---|---|
+| `build` | build |  |
+| `deploy` | deploy |  |
+| `test` | test |  |
diff --git a/docs/attributes-registry/client.md b/docs/attributes-registry/client.md
index 72bd25cedb..a46409ad0a 100644
--- a/docs/attributes-registry/client.md
+++ b/docs/attributes-registry/client.md
@@ -10,11 +10,11 @@
These attributes may be used to describe the client in a connection-based network interaction where there is one side that initiates the connection (the client is the side that initiates the connection). This covers all TCP network interactions since TCP is connection-based and one side initiates the connection (an exception is made for peer-to-peer communication over TCP where the "user-facing" surface of the protocol / API doesn't expose a clear notion of client and server). This also covers UDP network interactions where one side initiates the interaction, e.g. QUIC (HTTP/3) and DNS.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `client.address` | string | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `client.example.com`; `10.1.2.80`; `/tmp/my.sock` |  |
-| `client.port` | int | Client port number. [2] | `65123` |  |
+| `client.port` | int | Client port number. [2] | `65123` |  |
-**[1]:** When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries, for example proxies, if it's available.
+**[1]:** When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries, for example proxies, if it's available.
-**[2]:** When observed from the server side, and when communicating through an intermediary, `client.port` SHOULD represent the client port behind any intermediaries, for example proxies, if it's available.
+**[2]:** When observed from the server side, and when communicating through an intermediary, `client.port` SHOULD represent the client port behind any intermediaries, for example proxies, if it's available.
diff --git a/docs/attributes-registry/cloud.md b/docs/attributes-registry/cloud.md
index c3851711f9..fdaf4919e2 100644
--- a/docs/attributes-registry/cloud.md
+++ b/docs/attributes-registry/cloud.md
@@ -10,14 +10,14 @@
A cloud environment (e.g. GCP, Azure, AWS).
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `cloud.account.id` | string | The cloud account ID the resource is assigned to. | `111111111111`; `opentelemetry` |  |
-| `cloud.availability_zone` | string | Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running. [1] | `us-east-1c` |  |
-| `cloud.platform` | string | The cloud platform in use. [2] | `alibaba_cloud_ecs`; `alibaba_cloud_fc`; `alibaba_cloud_openshift` |  |
-| `cloud.provider` | string | Name of the cloud provider. | `alibaba_cloud`; `aws`; `azure` |  |
-| `cloud.region` | string | The geographical region the resource is running. [3] | `us-central1`; `us-east-1` |  |
-| `cloud.resource_id` | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [4] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `cloud.account.id` | string | The cloud account ID the resource is assigned to. | `111111111111`; `opentelemetry` |  |
+| `cloud.availability_zone` | string | Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running. [1] | `us-east-1c` |  |
+| `cloud.platform` | string | The cloud platform in use. [2] | `alibaba_cloud_ecs`; `alibaba_cloud_fc`; `alibaba_cloud_openshift` |  |
+| `cloud.provider` | string | Name of the cloud provider. | `alibaba_cloud`; `aws`; `azure` |  |
+| `cloud.region` | string | The geographical region the resource is running. [3] | `us-central1`; `us-east-1` |  |
+| `cloud.resource_id` | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [4] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` |  |
**[1]:** Availability zones are called "zones" on Alibaba Cloud and Google Cloud.
@@ -38,52 +38,52 @@ The following well-known definitions MUST be used if you set this attribute and
multiple different aliases.
- **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
- **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
- _not_ the function app, having the form
+ *not* the function app, having the form
`/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/`.
This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share
a TracerProvider.
`cloud.platform` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------------------------- | ---------------------------------------------- | ---------------------------------------------------------------- |
-| `alibaba_cloud_ecs` | Alibaba Cloud Elastic Compute Service |  |
-| `alibaba_cloud_fc` | Alibaba Cloud Function Compute |  |
-| `alibaba_cloud_openshift` | Red Hat OpenShift on Alibaba Cloud |  |
-| `aws_app_runner` | AWS App Runner |  |
-| `aws_ec2` | AWS Elastic Compute Cloud |  |
-| `aws_ecs` | AWS Elastic Container Service |  |
-| `aws_eks` | AWS Elastic Kubernetes Service |  |
-| `aws_elastic_beanstalk` | AWS Elastic Beanstalk |  |
-| `aws_lambda` | AWS Lambda |  |
-| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) |  |
-| `azure_aks` | Azure Kubernetes Service |  |
-| `azure_app_service` | Azure App Service |  |
-| `azure_container_apps` | Azure Container Apps |  |
-| `azure_container_instances` | Azure Container Instances |  |
-| `azure_functions` | Azure Functions |  |
-| `azure_openshift` | Azure Red Hat OpenShift |  |
-| `azure_vm` | Azure Virtual Machines |  |
-| `gcp_app_engine` | Google Cloud App Engine (GAE) |  |
-| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) |  |
-| `gcp_cloud_functions` | Google Cloud Functions (GCF) |  |
-| `gcp_cloud_run` | Google Cloud Run |  |
-| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) |  |
-| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) |  |
-| `gcp_openshift` | Red Hat OpenShift on Google Cloud |  |
-| `ibm_cloud_openshift` | Red Hat OpenShift on IBM Cloud |  |
-| `tencent_cloud_cvm` | Tencent Cloud Cloud Virtual Machine (CVM) |  |
-| `tencent_cloud_eks` | Tencent Cloud Elastic Kubernetes Service (EKS) |  |
-| `tencent_cloud_scf` | Tencent Cloud Serverless Cloud Function (SCF) |  |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud_ecs` | Alibaba Cloud Elastic Compute Service |  |
+| `alibaba_cloud_fc` | Alibaba Cloud Function Compute |  |
+| `alibaba_cloud_openshift` | Red Hat OpenShift on Alibaba Cloud |  |
+| `aws_app_runner` | AWS App Runner |  |
+| `aws_ec2` | AWS Elastic Compute Cloud |  |
+| `aws_ecs` | AWS Elastic Container Service |  |
+| `aws_eks` | AWS Elastic Kubernetes Service |  |
+| `aws_elastic_beanstalk` | AWS Elastic Beanstalk |  |
+| `aws_lambda` | AWS Lambda |  |
+| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) |  |
+| `azure_aks` | Azure Kubernetes Service |  |
+| `azure_app_service` | Azure App Service |  |
+| `azure_container_apps` | Azure Container Apps |  |
+| `azure_container_instances` | Azure Container Instances |  |
+| `azure_functions` | Azure Functions |  |
+| `azure_openshift` | Azure Red Hat OpenShift |  |
+| `azure_vm` | Azure Virtual Machines |  |
+| `gcp_app_engine` | Google Cloud App Engine (GAE) |  |
+| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) |  |
+| `gcp_cloud_functions` | Google Cloud Functions (GCF) |  |
+| `gcp_cloud_run` | Google Cloud Run |  |
+| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) |  |
+| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) |  |
+| `gcp_openshift` | Red Hat OpenShift on Google Cloud |  |
+| `ibm_cloud_openshift` | Red Hat OpenShift on IBM Cloud |  |
+| `tencent_cloud_cvm` | Tencent Cloud Cloud Virtual Machine (CVM) |  |
+| `tencent_cloud_eks` | Tencent Cloud Elastic Kubernetes Service (EKS) |  |
+| `tencent_cloud_scf` | Tencent Cloud Serverless Cloud Function (SCF) |  |
`cloud.provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------------- | ---------------------------- | ---------------------------------------------------------------- |
-| `alibaba_cloud` | Alibaba Cloud |  |
-| `aws` | Amazon Web Services |  |
-| `azure` | Microsoft Azure |  |
-| `gcp` | Google Cloud Platform |  |
-| `heroku` | Heroku Platform as a Service |  |
-| `ibm_cloud` | IBM Cloud |  |
-| `tencent_cloud` | Tencent Cloud |  |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud` | Alibaba Cloud |  |
+| `aws` | Amazon Web Services |  |
+| `azure` | Microsoft Azure |  |
+| `gcp` | Google Cloud Platform |  |
+| `heroku` | Heroku Platform as a Service |  |
+| `ibm_cloud` | IBM Cloud |  |
+| `tencent_cloud` | Tencent Cloud |  |
diff --git a/docs/attributes-registry/cloudevents.md b/docs/attributes-registry/cloudevents.md
index e15b1c67e1..efb8584763 100644
--- a/docs/attributes-registry/cloudevents.md
+++ b/docs/attributes-registry/cloudevents.md
@@ -10,10 +10,10 @@
This document defines attributes for CloudEvents.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `cloudevents.event_id` | string | The [event_id](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#id) uniquely identifies the event. | `123e4567-e89b-12d3-a456-426614174000`; `0001` |  |
-| `cloudevents.event_source` | string | The [source](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#source-1) identifies the context in which an event happened. | `https://github.com/cloudevents`; `/cloudevents/spec/pull/123`; `my-service` |  |
-| `cloudevents.event_spec_version` | string | The [version of the CloudEvents specification](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#specversion) which the event uses. | `1.0` |  |
-| `cloudevents.event_subject` | string | The [subject](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#subject) of the event in the context of the event producer (identified by source). | `mynewfile.jpg` |  |
-| `cloudevents.event_type` | string | The [event_type](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#type) contains a value describing the type of event related to the originating occurrence. | `com.github.pull_request.opened`; `com.example.object.deleted.v2` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `cloudevents.event_id` | string | The [event_id](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#id) uniquely identifies the event. | `123e4567-e89b-12d3-a456-426614174000`; `0001` |  |
+| `cloudevents.event_source` | string | The [source](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#source-1) identifies the context in which an event happened. | `https://github.com/cloudevents`; `/cloudevents/spec/pull/123`; `my-service` |  |
+| `cloudevents.event_spec_version` | string | The [version of the CloudEvents specification](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#specversion) which the event uses. | `1.0` |  |
+| `cloudevents.event_subject` | string | The [subject](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#subject) of the event in the context of the event producer (identified by source). | `mynewfile.jpg` |  |
+| `cloudevents.event_type` | string | The [event_type](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#type) contains a value describing the type of event related to the originating occurrence. | `com.github.pull_request.opened`; `com.example.object.deleted.v2` |  |
diff --git a/docs/attributes-registry/cloudfoundry.md b/docs/attributes-registry/cloudfoundry.md
index d7e49dcfd6..4253a8bf10 100644
--- a/docs/attributes-registry/cloudfoundry.md
+++ b/docs/attributes-registry/cloudfoundry.md
@@ -10,19 +10,19 @@
CloudFoundry resource attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------ | -------------------------------------- | ---------------------------------------------------------------- |
-| `cloudfoundry.app.id` | string | The guid of the application. [1] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
-| `cloudfoundry.app.instance.id` | string | The index of the application instance. 0 when just one instance is active. [2] | `0`; `1` |  |
-| `cloudfoundry.app.name` | string | The name of the application. [3] | `my-app-name` |  |
-| `cloudfoundry.org.id` | string | The guid of the CloudFoundry org the application is running in. [4] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
-| `cloudfoundry.org.name` | string | The name of the CloudFoundry organization the app is running in. [5] | `my-org-name` |  |
-| `cloudfoundry.process.id` | string | The UID identifying the process. [6] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
-| `cloudfoundry.process.type` | string | The type of process. [7] | `web` |  |
-| `cloudfoundry.space.id` | string | The guid of the CloudFoundry space the application is running in. [8] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
-| `cloudfoundry.space.name` | string | The name of the CloudFoundry space the application is running in. [9] | `my-space-name` |  |
-| `cloudfoundry.system.id` | string | A guid or another name describing the event source. [10] | `cf/gorouter` |  |
-| `cloudfoundry.system.instance.id` | string | A guid describing the concrete instance of the event source. [11] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `cloudfoundry.app.id` | string | The guid of the application. [1] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
+| `cloudfoundry.app.instance.id` | string | The index of the application instance. 0 when just one instance is active. [2] | `0`; `1` |  |
+| `cloudfoundry.app.name` | string | The name of the application. [3] | `my-app-name` |  |
+| `cloudfoundry.org.id` | string | The guid of the CloudFoundry org the application is running in. [4] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
+| `cloudfoundry.org.name` | string | The name of the CloudFoundry organization the app is running in. [5] | `my-org-name` |  |
+| `cloudfoundry.process.id` | string | The UID identifying the process. [6] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
+| `cloudfoundry.process.type` | string | The type of process. [7] | `web` |  |
+| `cloudfoundry.space.id` | string | The guid of the CloudFoundry space the application is running in. [8] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
+| `cloudfoundry.space.name` | string | The name of the CloudFoundry space the application is running in. [9] | `my-space-name` |  |
+| `cloudfoundry.system.id` | string | A guid or another name describing the event source. [10] | `cf/gorouter` |  |
+| `cloudfoundry.system.instance.id` | string | A guid describing the concrete instance of the event source. [11] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
**[1]:** Application instrumentation should use the value from environment
variable `VCAP_APPLICATION.application_id`. This is the same value as
diff --git a/docs/attributes-registry/code.md b/docs/attributes-registry/code.md
index 32650b383f..8621728ce4 100644
--- a/docs/attributes-registry/code.md
+++ b/docs/attributes-registry/code.md
@@ -10,11 +10,11 @@
These attributes allow to report this unit of code and therefore to provide more context about the span.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
-| `code.column` | int | The column number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `16` |  |
-| `code.filepath` | string | The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). | `/usr/local/MyApplication/content_root/app/index.php` |  |
-| `code.function` | string | The method or function name, or equivalent (usually rightmost part of the code unit's name). | `serveRequest` |  |
-| `code.lineno` | int | The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `42` |  |
-| `code.namespace` | string | The "namespace" within which `code.function` is defined. Usually the qualified class or module name, such that `code.namespace` + some separator + `code.function` form a unique identifier for the code unit. | `com.example.MyHttpService` |  |
-| `code.stacktrace` | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `code.column` | int | The column number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `16` |  |
+| `code.filepath` | string | The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). | `/usr/local/MyApplication/content_root/app/index.php` |  |
+| `code.function` | string | The method or function name, or equivalent (usually rightmost part of the code unit's name). | `serveRequest` |  |
+| `code.lineno` | int | The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `42` |  |
+| `code.namespace` | string | The "namespace" within which `code.function` is defined. Usually the qualified class or module name, such that `code.namespace` + some separator + `code.function` form a unique identifier for the code unit. | `com.example.MyHttpService` |  |
+| `code.stacktrace` | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` |  |
diff --git a/docs/attributes-registry/container.md b/docs/attributes-registry/container.md
index d8e861d78d..439b079184 100644
--- a/docs/attributes-registry/container.md
+++ b/docs/attributes-registry/container.md
@@ -13,21 +13,21 @@
A container instance.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `container.command` | string | The command used to run the container (i.e. the command name). [1] | `otelcontribcol` |  |
-| `container.command_args` | string[] | All the command arguments (including the command/executable itself) run by the container. | `["otelcontribcol", "--config", "config.yaml"]` |  |
-| `container.command_line` | string | The full command run by the container as a single string representing the full command. | `otelcontribcol --config config.yaml` |  |
-| `container.csi.plugin.name` | string | The name of the CSI ([Container Storage Interface](https://github.com/container-storage-interface/spec)) plugin used by the volume. [2] | `pd.csi.storage.gke.io` |  |
-| `container.csi.volume.id` | string | The unique volume ID returned by the CSI ([Container Storage Interface](https://github.com/container-storage-interface/spec)) plugin. [3] | `projects/my-gcp-project/zones/my-gcp-zone/disks/my-gcp-disk` |  |
-| `container.id` | string | Container ID. Usually a UUID, as for example used to [identify Docker containers](https://docs.docker.com/engine/containers/run/#container-identification). The UUID might be abbreviated. | `a3bf90e006b2` |  |
-| `container.image.id` | string | Runtime specific image identifier. Usually a hash algorithm followed by a UUID. [4] | `sha256:19c92d0a00d1b66d897bceaa7319bee0dd38a10a851c60bcec9474aa3f01e50f` |  |
-| `container.image.name` | string | Name of the image the container was built on. | `gcr.io/opentelemetry/operator` |  |
-| `container.image.repo_digests` | string[] | Repo digests of the container image as provided by the container runtime. [5] | `["example@sha256:afcc7f1ac1b49db317a7196c902e61c6c3c4607d63599ee1a82d702d249a0ccb", "internal.registry.example.com:5000/example@sha256:b69959407d21e8a062e0416bf13405bb2b71ed7a84dde4158ebafacfa06f5578"]` |  |
-| `container.image.tags` | string[] | Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageInspect). Should be only the `` section of the full name for example from `registry.example.com/my-org/my-image:`. | `["v1.27.1", "3.5.7-0"]` |  |
-| `container.label.` | string | Container labels, `` being the label name, the value being the label value. | `container.label.app=nginx` |  |
-| `container.name` | string | Container name used by container runtime. | `opentelemetry-autoconf` |  |
-| `container.runtime` | string | The container runtime managing this container. | `docker`; `containerd`; `rkt` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `container.command` | string | The command used to run the container (i.e. the command name). [1] | `otelcontribcol` |  |
+| `container.command_args` | string[] | All the command arguments (including the command/executable itself) run by the container. | `["otelcontribcol", "--config", "config.yaml"]` |  |
+| `container.command_line` | string | The full command run by the container as a single string representing the full command. | `otelcontribcol --config config.yaml` |  |
+| `container.csi.plugin.name` | string | The name of the CSI ([Container Storage Interface](https://github.com/container-storage-interface/spec)) plugin used by the volume. [2] | `pd.csi.storage.gke.io` |  |
+| `container.csi.volume.id` | string | The unique volume ID returned by the CSI ([Container Storage Interface](https://github.com/container-storage-interface/spec)) plugin. [3] | `projects/my-gcp-project/zones/my-gcp-zone/disks/my-gcp-disk` |  |
+| `container.id` | string | Container ID. Usually a UUID, as for example used to [identify Docker containers](https://docs.docker.com/engine/containers/run/#container-identification). The UUID might be abbreviated. | `a3bf90e006b2` |  |
+| `container.image.id` | string | Runtime specific image identifier. Usually a hash algorithm followed by a UUID. [4] | `sha256:19c92d0a00d1b66d897bceaa7319bee0dd38a10a851c60bcec9474aa3f01e50f` |  |
+| `container.image.name` | string | Name of the image the container was built on. | `gcr.io/opentelemetry/operator` |  |
+| `container.image.repo_digests` | string[] | Repo digests of the container image as provided by the container runtime. [5] | `["example@sha256:afcc7f1ac1b49db317a7196c902e61c6c3c4607d63599ee1a82d702d249a0ccb", "internal.registry.example.com:5000/example@sha256:b69959407d21e8a062e0416bf13405bb2b71ed7a84dde4158ebafacfa06f5578"]` |  |
+| `container.image.tags` | string[] | Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageInspect). Should be only the `` section of the full name for example from `registry.example.com/my-org/my-image:`. | `["v1.27.1", "3.5.7-0"]` |  |
+| `container.label.` | string | Container labels, `` being the label name, the value being the label value. | `container.label.app=nginx` |  |
+| `container.name` | string | Container name used by container runtime. | `opentelemetry-autoconf` |  |
+| `container.runtime` | string | The container runtime managing this container. | `docker`; `containerd`; `rkt` |  |
**[1]:** If using embedded credentials or sensitive data, it is recommended to remove them to prevent potential leakage.
@@ -45,15 +45,15 @@ The ID is assigned by the container runtime and can vary in different environmen
Describes deprecated container attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | ------------------------------------------ | --------------------------- | --------------------------------------------------------------------------------------------- |
-| `container.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `user`; `kernel` | 
Replaced by `cpu.mode` |
-| `container.labels.` | string | Deprecated, use `container.label` instead. | `container.label.app=nginx` | 
Replaced by `container.label`. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `container.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `user`; `kernel` | 
Replaced by `cpu.mode` |
+| `container.labels.` | string | Deprecated, use `container.label` instead. | `container.label.app=nginx` | 
Replaced by `container.label`. |
`container.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `kernel` | When tasks of the cgroup are in kernel mode (Linux). When all container processes are in kernel mode (Windows). |  |
-| `system` | When CPU is used by the system (host OS) |  |
-| `user` | When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows). |  |
+| `system` | When CPU is used by the system (host OS) |  |
+| `user` | When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows). |  |
diff --git a/docs/attributes-registry/cpu.md b/docs/attributes-registry/cpu.md
index 93402b94ac..70ea4139de 100644
--- a/docs/attributes-registry/cpu.md
+++ b/docs/attributes-registry/cpu.md
@@ -10,19 +10,19 @@
Attributes specific to a cpu instance.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------ | ------ | ------------------- | ---------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `cpu.mode` | string | The mode of the CPU | `user`; `system` |  |
`cpu.mode` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----------- | ----------- | ---------------------------------------------------------------- |
-| `idle` | idle |  |
-| `interrupt` | interrupt |  |
-| `iowait` | iowait |  |
-| `kernel` | kernel |  |
-| `nice` | nice |  |
-| `steal` | steal |  |
-| `system` | system |  |
-| `user` | user |  |
+| Value | Description | Stability |
+|---|---|---|
+| `idle` | idle |  |
+| `interrupt` | interrupt |  |
+| `iowait` | iowait |  |
+| `kernel` | kernel |  |
+| `nice` | nice |  |
+| `steal` | steal |  |
+| `system` | system |  |
+| `user` | user |  |
diff --git a/docs/attributes-registry/db.md b/docs/attributes-registry/db.md
index 34e4ebc837..101c111191 100644
--- a/docs/attributes-registry/db.md
+++ b/docs/attributes-registry/db.md
@@ -17,19 +17,19 @@
This group defines the attributes used to describe telemetry in the context of databases.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `db.client.connection.pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation SHOULD use a combination of parameters that would make the name unique, for example, combining attributes `server.address`, `server.port`, and `db.namespace`, formatted as `server.address:server.port/db.namespace`. Instrumentations that generate connection pool name following different patterns SHOULD document it. | `myDataSource` |  |
-| `db.client.connection.state` | string | The state of a connection in the pool | `idle` |  |
-| `db.collection.name` | string | The name of a collection (table, container) within the database. [1] | `public.users`; `customers` |  |
-| `db.namespace` | string | The name of the database, fully qualified within the server address and port. [2] | `customers`; `test.users` |  |
-| `db.operation.batch.size` | int | The number of queries included in a batch operation. [3] | `2`; `3`; `4` |  |
-| `db.operation.name` | string | The name of the operation or command being executed. [4] | `findAndModify`; `HMSET`; `SELECT` |  |
-| `db.query.parameter.` | string | A query parameter used in `db.query.text`, with `` being the parameter name, and the attribute value being a string representation of the parameter value. [5] | `someval`; `55` |  |
-| `db.query.summary` | string | Low cardinality representation of a database query text. [6] | `SELECT wuser_table`; `INSERT shipping_details SELECT orders`; `get user by id` |  |
-| `db.query.text` | string | The database query being executed. [7] | `SELECT * FROM wuser_table where username = ?`; `SET mykey ?` |  |
-| `db.response.status_code` | string | Database response status code. [8] | `102`; `ORA-17002`; `08P01`; `404` |  |
-| `db.system` | string | The database management system (DBMS) product as identified by the client instrumentation. [9] | `other_sql`; `adabas`; `cache` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.client.connection.pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation SHOULD use a combination of parameters that would make the name unique, for example, combining attributes `server.address`, `server.port`, and `db.namespace`, formatted as `server.address:server.port/db.namespace`. Instrumentations that generate connection pool name following different patterns SHOULD document it. | `myDataSource` |  |
+| `db.client.connection.state` | string | The state of a connection in the pool | `idle` |  |
+| `db.collection.name` | string | The name of a collection (table, container) within the database. [1] | `public.users`; `customers` |  |
+| `db.namespace` | string | The name of the database, fully qualified within the server address and port. [2] | `customers`; `test.users` |  |
+| `db.operation.batch.size` | int | The number of queries included in a batch operation. [3] | `2`; `3`; `4` |  |
+| `db.operation.name` | string | The name of the operation or command being executed. [4] | `findAndModify`; `HMSET`; `SELECT` |  |
+| `db.query.parameter.` | string | A query parameter used in `db.query.text`, with `` being the parameter name, and the attribute value being a string representation of the parameter value. [5] | `someval`; `55` |  |
+| `db.query.summary` | string | Low cardinality representation of a database query text. [6] | `SELECT wuser_table`; `INSERT shipping_details SELECT orders`; `get user by id` |  |
+| `db.query.text` | string | The database query being executed. [7] | `SELECT * FROM wuser_table where username = ?`; `SET mykey ?` |  |
+| `db.response.status_code` | string | Database response status code. [8] | `102`; `ORA-17002`; `08P01`; `404` |  |
+| `db.system` | string | The database management system (DBMS) product as identified by the client instrumentation. [9] | `other_sql`; `adabas`; `cache` |  |
**[1]:** It is RECOMMENDED to capture the value as provided by the application without attempting to do any case normalization.
@@ -92,147 +92,147 @@ This attribute has stability level RELEASE CANDIDATE.
`db.client.connection.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | ----------- | ---------------------------------------------------------------- |
-| `idle` | idle |  |
-| `used` | used |  |
+| Value | Description | Stability |
+|---|---|---|
+| `idle` | idle |  |
+| `used` | used |  |
`db.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
-| `adabas` | Adabas (Adaptable Database System) |  |
-| `cache` | Deprecated, use `intersystems_cache` instead. | 
Replaced by `intersystems_cache`. |
-| `cassandra` | Apache Cassandra |  |
-| `clickhouse` | ClickHouse |  |
-| `cloudscape` | Deprecated, use `other_sql` instead. | 
Replaced by `other_sql`. |
-| `cockroachdb` | CockroachDB |  |
-| `coldfusion` | Deprecated, no replacement at this time. | 
Removed. |
-| `cosmosdb` | Microsoft Azure Cosmos DB |  |
-| `couchbase` | Couchbase |  |
-| `couchdb` | CouchDB |  |
-| `db2` | IBM Db2 |  |
-| `derby` | Apache Derby |  |
-| `dynamodb` | Amazon DynamoDB |  |
-| `edb` | EnterpriseDB |  |
-| `elasticsearch` | Elasticsearch |  |
-| `filemaker` | FileMaker |  |
-| `firebird` | Firebird |  |
-| `firstsql` | Deprecated, use `other_sql` instead. | 
Replaced by `other_sql`. |
-| `geode` | Apache Geode |  |
-| `h2` | H2 |  |
-| `hanadb` | SAP HANA |  |
-| `hbase` | Apache HBase |  |
-| `hive` | Apache Hive |  |
-| `hsqldb` | HyperSQL DataBase |  |
-| `influxdb` | InfluxDB |  |
-| `informix` | Informix |  |
-| `ingres` | Ingres |  |
-| `instantdb` | InstantDB |  |
-| `interbase` | InterBase |  |
-| `intersystems_cache` | InterSystems Caché |  |
-| `mariadb` | MariaDB (This value has stability level RELEASE CANDIDATE) |  |
-| `maxdb` | SAP MaxDB |  |
-| `memcached` | Memcached |  |
-| `mongodb` | MongoDB |  |
-| `mssql` | Microsoft SQL Server (This value has stability level RELEASE CANDIDATE) |  |
-| `mssqlcompact` | Deprecated, Microsoft SQL Server Compact is discontinued. | 
Removed, use `other_sql` instead. |
-| `mysql` | MySQL (This value has stability level RELEASE CANDIDATE) |  |
-| `neo4j` | Neo4j |  |
-| `netezza` | Netezza |  |
-| `opensearch` | OpenSearch |  |
-| `oracle` | Oracle Database |  |
-| `other_sql` | Some other SQL database. Fallback only. See notes. |  |
-| `pervasive` | Pervasive PSQL |  |
-| `pointbase` | PointBase |  |
-| `postgresql` | PostgreSQL (This value has stability level RELEASE CANDIDATE) |  |
-| `progress` | Progress Database |  |
-| `redis` | Redis |  |
-| `redshift` | Amazon Redshift |  |
-| `spanner` | Cloud Spanner |  |
-| `sqlite` | SQLite |  |
-| `sybase` | Sybase |  |
-| `teradata` | Teradata |  |
-| `trino` | Trino |  |
-| `vertica` | Vertica |  |
+| Value | Description | Stability |
+|---|---|---|
+| `adabas` | Adabas (Adaptable Database System) |  |
+| `cache` | Deprecated, use `intersystems_cache` instead. | 
Replaced by `intersystems_cache`. |
+| `cassandra` | Apache Cassandra |  |
+| `clickhouse` | ClickHouse |  |
+| `cloudscape` | Deprecated, use `other_sql` instead. | 
Replaced by `other_sql`. |
+| `cockroachdb` | CockroachDB |  |
+| `coldfusion` | Deprecated, no replacement at this time. | 
Removed. |
+| `cosmosdb` | Microsoft Azure Cosmos DB |  |
+| `couchbase` | Couchbase |  |
+| `couchdb` | CouchDB |  |
+| `db2` | IBM Db2 |  |
+| `derby` | Apache Derby |  |
+| `dynamodb` | Amazon DynamoDB |  |
+| `edb` | EnterpriseDB |  |
+| `elasticsearch` | Elasticsearch |  |
+| `filemaker` | FileMaker |  |
+| `firebird` | Firebird |  |
+| `firstsql` | Deprecated, use `other_sql` instead. | 
Replaced by `other_sql`. |
+| `geode` | Apache Geode |  |
+| `h2` | H2 |  |
+| `hanadb` | SAP HANA |  |
+| `hbase` | Apache HBase |  |
+| `hive` | Apache Hive |  |
+| `hsqldb` | HyperSQL DataBase |  |
+| `influxdb` | InfluxDB |  |
+| `informix` | Informix |  |
+| `ingres` | Ingres |  |
+| `instantdb` | InstantDB |  |
+| `interbase` | InterBase |  |
+| `intersystems_cache` | InterSystems Caché |  |
+| `mariadb` | MariaDB (This value has stability level RELEASE CANDIDATE) |  |
+| `maxdb` | SAP MaxDB |  |
+| `memcached` | Memcached |  |
+| `mongodb` | MongoDB |  |
+| `mssql` | Microsoft SQL Server (This value has stability level RELEASE CANDIDATE) |  |
+| `mssqlcompact` | Deprecated, Microsoft SQL Server Compact is discontinued. | 
Removed, use `other_sql` instead. |
+| `mysql` | MySQL (This value has stability level RELEASE CANDIDATE) |  |
+| `neo4j` | Neo4j |  |
+| `netezza` | Netezza |  |
+| `opensearch` | OpenSearch |  |
+| `oracle` | Oracle Database |  |
+| `other_sql` | Some other SQL database. Fallback only. See notes. |  |
+| `pervasive` | Pervasive PSQL |  |
+| `pointbase` | PointBase |  |
+| `postgresql` | PostgreSQL (This value has stability level RELEASE CANDIDATE) |  |
+| `progress` | Progress Database |  |
+| `redis` | Redis |  |
+| `redshift` | Amazon Redshift |  |
+| `spanner` | Cloud Spanner |  |
+| `sqlite` | SQLite |  |
+| `sybase` | Sybase |  |
+| `teradata` | Teradata |  |
+| `trino` | Trino |  |
+| `vertica` | Vertica |  |
## Cassandra Attributes
This group defines attributes for Cassandra.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
-| `db.cassandra.consistency_level` | string | The consistency level of the query. Based on consistency values from [CQL](https://docs.datastax.com/en/cassandra-oss/3.0/cassandra/dml/dmlConfigConsistency.html). | `all`; `each_quorum`; `quorum` |  |
-| `db.cassandra.coordinator.dc` | string | The data center of the coordinating node for a query. | `us-west-2` |  |
-| `db.cassandra.coordinator.id` | string | The ID of the coordinating node for a query. | `be13faa2-8574-4d71-926d-27f16cf8a7af` |  |
-| `db.cassandra.idempotence` | boolean | Whether or not the query is idempotent. | |  |
-| `db.cassandra.page_size` | int | The fetch size used for paging, i.e. how many rows will be returned at once. | `5000` |  |
-| `db.cassandra.speculative_execution_count` | int | The number of times a query was speculatively executed. Not set or `0` if the query was not executed speculatively. | `0`; `2` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.cassandra.consistency_level` | string | The consistency level of the query. Based on consistency values from [CQL](https://docs.datastax.com/en/cassandra-oss/3.0/cassandra/dml/dmlConfigConsistency.html). | `all`; `each_quorum`; `quorum` |  |
+| `db.cassandra.coordinator.dc` | string | The data center of the coordinating node for a query. | `us-west-2` |  |
+| `db.cassandra.coordinator.id` | string | The ID of the coordinating node for a query. | `be13faa2-8574-4d71-926d-27f16cf8a7af` |  |
+| `db.cassandra.idempotence` | boolean | Whether or not the query is idempotent. | |  |
+| `db.cassandra.page_size` | int | The fetch size used for paging, i.e. how many rows will be returned at once. | `5000` |  |
+| `db.cassandra.speculative_execution_count` | int | The number of times a query was speculatively executed. Not set or `0` if the query was not executed speculatively. | `0`; `2` |  |
`db.cassandra.consistency_level` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------- | ------------ | ---------------------------------------------------------------- |
-| `all` | all |  |
-| `any` | any |  |
-| `each_quorum` | each_quorum |  |
-| `local_one` | local_one |  |
+| Value | Description | Stability |
+|---|---|---|
+| `all` | all |  |
+| `any` | any |  |
+| `each_quorum` | each_quorum |  |
+| `local_one` | local_one |  |
| `local_quorum` | local_quorum |  |
| `local_serial` | local_serial |  |
-| `one` | one |  |
-| `quorum` | quorum |  |
-| `serial` | serial |  |
-| `three` | three |  |
-| `two` | two |  |
+| `one` | one |  |
+| `quorum` | quorum |  |
+| `serial` | serial |  |
+| `three` | three |  |
+| `two` | two |  |
## Azure Cosmos DB Attributes
This group defines attributes for Azure Cosmos DB.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------------------ | ------ | --------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
-| `db.cosmosdb.client_id` | string | Unique Cosmos client instance id. | `3ba4827d-4422-483f-b59f-85b74211c11d` |  |
-| `db.cosmosdb.connection_mode` | string | Cosmos client connection mode. | `gateway`; `direct` |  |
-| `db.cosmosdb.operation_type` | string | Cosmos DB Operation Type. | `batch`; `create`; `delete` |  |
-| `db.cosmosdb.request_charge` | double | RU consumed for that operation | `46.18`; `1.0` |  |
-| `db.cosmosdb.request_content_length` | int | Request payload size in bytes | |  |
-| `db.cosmosdb.sub_status_code` | int | Cosmos DB sub status code. | `1000`; `1002` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.cosmosdb.client_id` | string | Unique Cosmos client instance id. | `3ba4827d-4422-483f-b59f-85b74211c11d` |  |
+| `db.cosmosdb.connection_mode` | string | Cosmos client connection mode. | `gateway`; `direct` |  |
+| `db.cosmosdb.operation_type` | string | Cosmos DB Operation Type. | `batch`; `create`; `delete` |  |
+| `db.cosmosdb.request_charge` | double | RU consumed for that operation | `46.18`; `1.0` |  |
+| `db.cosmosdb.request_content_length` | int | Request payload size in bytes | |  |
+| `db.cosmosdb.sub_status_code` | int | Cosmos DB sub status code. | `1000`; `1002` |  |
`db.cosmosdb.connection_mode` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | ------------------------------- | ---------------------------------------------------------------- |
-| `direct` | Direct connection. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `direct` | Direct connection. |  |
| `gateway` | Gateway (HTTP) connections mode |  |
`db.cosmosdb.operation_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------------- | ------------------ | ---------------------------------------------------------------- |
-| `batch` | batch |  |
-| `create` | create |  |
-| `delete` | delete |  |
-| `execute` | execute |  |
+| Value | Description | Stability |
+|---|---|---|
+| `batch` | batch |  |
+| `create` | create |  |
+| `delete` | delete |  |
+| `execute` | execute |  |
| `execute_javascript` | execute_javascript |  |
-| `head` | head |  |
-| `head_feed` | head_feed |  |
-| `invalid` | invalid |  |
-| `patch` | patch |  |
-| `query` | query |  |
-| `query_plan` | query_plan |  |
-| `read` | read |  |
-| `read_feed` | read_feed |  |
-| `replace` | replace |  |
-| `upsert` | upsert |  |
+| `head` | head |  |
+| `head_feed` | head_feed |  |
+| `invalid` | invalid |  |
+| `patch` | patch |  |
+| `query` | query |  |
+| `query_plan` | query_plan |  |
+| `read` | read |  |
+| `read_feed` | read_feed |  |
+| `replace` | replace |  |
+| `upsert` | upsert |  |
## Elasticsearch Attributes
This group defines attributes for Elasticsearch.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `db.elasticsearch.node.name` | string | Represents the human-readable identifier of the node/instance to which a request was routed. | `instance-0000000001` |  |
-| `db.elasticsearch.path_parts.` | string | A dynamic value in the url path. [10] | `db.elasticsearch.path_parts.index=test-index`; `db.elasticsearch.path_parts.doc_id=123` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.elasticsearch.node.name` | string | Represents the human-readable identifier of the node/instance to which a request was routed. | `instance-0000000001` |  |
+| `db.elasticsearch.path_parts.` | string | A dynamic value in the url path. [10] | `db.elasticsearch.path_parts.index=test-index`; `db.elasticsearch.path_parts.doc_id=123` |  |
**[10]:** Many Elasticsearch url paths allow dynamic values. These SHOULD be recorded in span attributes in the format `db.elasticsearch.path_parts.`, where `` is the url path part name. The implementation SHOULD reference the [elasticsearch schema](https://raw.githubusercontent.com/elastic/elasticsearch-specification/main/output/schema/schema.json) in order to map the path part values to their names.
@@ -240,45 +240,45 @@ This group defines attributes for Elasticsearch.
"Describes deprecated db attributes."
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `db.cassandra.table` | string | Deprecated, use `db.collection.name` instead. | `mytable` | 
Replaced by `db.collection.name`. |
-| `db.connection_string` | string | Deprecated, use `server.address`, `server.port` attributes instead. | `Server=(localdb)\v11.0;Integrated Security=true;` | 
Replaced by `server.address` and `server.port`. |
-| `db.cosmosdb.container` | string | Deprecated, use `db.collection.name` instead. | `mytable` | 
Replaced by `db.collection.name`. |
-| `db.cosmosdb.status_code` | int | Deprecated, use `db.response.status_code` instead. | `200`; `201` | 
Replaced by `db.response.status_code`. |
-| `db.elasticsearch.cluster.name` | string | Deprecated, use `db.namespace` instead. | `e9106fc68e3044f0b1475b04bf4ffd5f` | 
Replaced by `db.namespace`. |
-| `db.instance.id` | string | Deprecated, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. | `mysql-e26b99z.example.com` | 
Deprecated, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. |
-| `db.jdbc.driver_classname` | string | Removed, no replacement at this time. | `org.postgresql.Driver`; `com.microsoft.sqlserver.jdbc.SQLServerDriver` | 
Removed as not used. |
-| `db.mongodb.collection` | string | Deprecated, use `db.collection.name` instead. | `mytable` | 
Replaced by `db.collection.name`. |
-| `db.mssql.instance_name` | string | Deprecated, SQL Server instance is now populated as a part of `db.namespace` attribute. | `MSSQLSERVER` | 
Deprecated, no replacement at this time. |
-| `db.name` | string | Deprecated, use `db.namespace` instead. | `customers`; `main` | 
Replaced by `db.namespace`. |
-| `db.operation` | string | Deprecated, use `db.operation.name` instead. | `findAndModify`; `HMSET`; `SELECT` | 
Replaced by `db.operation.name`. |
-| `db.redis.database_index` | int | Deprecated, use `db.namespace` instead. | `0`; `1`; `15` | 
Replaced by `db.namespace`. |
-| `db.sql.table` | string | Deprecated, use `db.collection.name` instead. | `mytable` | 
Replaced by `db.collection.name`. |
-| `db.statement` | string | The database statement being executed. | `SELECT * FROM wuser_table`; `SET mykey "WuValue"` | 
Replaced by `db.query.text`. |
-| `db.user` | string | Deprecated, no replacement at this time. | `readonly_user`; `reporting_user` | 
No replacement at this time. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.cassandra.table` | string | Deprecated, use `db.collection.name` instead. | `mytable` | 
Replaced by `db.collection.name`. |
+| `db.connection_string` | string | Deprecated, use `server.address`, `server.port` attributes instead. | `Server=(localdb)\v11.0;Integrated Security=true;` | 
Replaced by `server.address` and `server.port`. |
+| `db.cosmosdb.container` | string | Deprecated, use `db.collection.name` instead. | `mytable` | 
Replaced by `db.collection.name`. |
+| `db.cosmosdb.status_code` | int | Deprecated, use `db.response.status_code` instead. | `200`; `201` | 
Replaced by `db.response.status_code`. |
+| `db.elasticsearch.cluster.name` | string | Deprecated, use `db.namespace` instead. | `e9106fc68e3044f0b1475b04bf4ffd5f` | 
Replaced by `db.namespace`. |
+| `db.instance.id` | string | Deprecated, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. | `mysql-e26b99z.example.com` | 
Deprecated, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. |
+| `db.jdbc.driver_classname` | string | Removed, no replacement at this time. | `org.postgresql.Driver`; `com.microsoft.sqlserver.jdbc.SQLServerDriver` | 
Removed as not used. |
+| `db.mongodb.collection` | string | Deprecated, use `db.collection.name` instead. | `mytable` | 
Replaced by `db.collection.name`. |
+| `db.mssql.instance_name` | string | Deprecated, SQL Server instance is now populated as a part of `db.namespace` attribute. | `MSSQLSERVER` | 
Deprecated, no replacement at this time. |
+| `db.name` | string | Deprecated, use `db.namespace` instead. | `customers`; `main` | 
Replaced by `db.namespace`. |
+| `db.operation` | string | Deprecated, use `db.operation.name` instead. | `findAndModify`; `HMSET`; `SELECT` | 
Replaced by `db.operation.name`. |
+| `db.redis.database_index` | int | Deprecated, use `db.namespace` instead. | `0`; `1`; `15` | 
Replaced by `db.namespace`. |
+| `db.sql.table` | string | Deprecated, use `db.collection.name` instead. | `mytable` | 
Replaced by `db.collection.name`. |
+| `db.statement` | string | The database statement being executed. | `SELECT * FROM wuser_table`; `SET mykey "WuValue"` | 
Replaced by `db.query.text`. |
+| `db.user` | string | Deprecated, no replacement at this time. | `readonly_user`; `reporting_user` | 
No replacement at this time. |
## Deprecated Database Metrics
"Describes deprecated db metrics attributes."
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------ |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `db.client.connections.pool.name` | string | Deprecated, use `db.client.connection.pool.name` instead. | `myDataSource` | 
Replaced by `db.client.connection.pool.name`. |
-| `db.client.connections.state` | string | Deprecated, use `db.client.connection.state` instead. | `idle` | 
Replaced by `db.client.connection.state`. |
-| `pool.name` | string | Deprecated, use `db.client.connection.pool.name` instead. | `myDataSource` | 
Replaced by `db.client.connection.pool.name`. |
-| `state` | string | Deprecated, use `db.client.connection.state` instead. | `idle` | 
Replaced by `db.client.connection.state`. |
+| `db.client.connections.state` | string | Deprecated, use `db.client.connection.state` instead. | `idle` | 
Replaced by `db.client.connection.state`. |
+| `pool.name` | string | Deprecated, use `db.client.connection.pool.name` instead. | `myDataSource` | 
Replaced by `db.client.connection.pool.name`. |
+| `state` | string | Deprecated, use `db.client.connection.state` instead. | `idle` | 
Replaced by `db.client.connection.state`. |
`db.client.connections.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | ----------- | ---------------------------------------------------------------- |
-| `idle` | idle |  |
-| `used` | used |  |
+| Value | Description | Stability |
+|---|---|---|
+| `idle` | idle |  |
+| `used` | used |  |
`state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | ----------- | ---------------------------------------------------------------- |
-| `idle` | idle |  |
-| `used` | used |  |
+| Value | Description | Stability |
+|---|---|---|
+| `idle` | idle |  |
+| `used` | used |  |
diff --git a/docs/attributes-registry/deployment.md b/docs/attributes-registry/deployment.md
index 923281c3d7..d687d2b880 100644
--- a/docs/attributes-registry/deployment.md
+++ b/docs/attributes-registry/deployment.md
@@ -13,12 +13,12 @@
This document defines attributes for software deployments.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | ---------------------------------------------------------------- |
-| `deployment.environment.name` | string | Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier). [1] | `staging`; `production` |  |
-| `deployment.id` | string | The id of the deployment. | `1208` |  |
-| `deployment.name` | string | The name of the deployment. | `deploy my app`; `deploy-frontend` |  |
-| `deployment.status` | string | The status of the deployment. | `failed`; `succeeded` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `deployment.environment.name` | string | Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier). [1] | `staging`; `production` |  |
+| `deployment.id` | string | The id of the deployment. | `1208` |  |
+| `deployment.name` | string | The name of the deployment. | `deploy my app`; `deploy-frontend` |  |
+| `deployment.status` | string | The status of the deployment. | `failed`; `succeeded` |  |
**[1]:** `deployment.environment.name` does not affect the uniqueness constraints defined through
the `service.namespace`, `service.name` and `service.instance.id` resource attributes.
@@ -30,15 +30,15 @@ considered to be identifying the same service:
`deployment.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----------- | ----------- | ---------------------------------------------------------------- |
-| `failed` | failed |  |
-| `succeeded` | succeeded |  |
+| Value | Description | Stability |
+|---|---|---|
+| `failed` | failed |  |
+| `succeeded` | succeeded |  |
## Deployment Deprecated Attributes
"Describes deprecated deployment attributes."
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------ | ------ | -------------------------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `deployment.environment` | string | 'Deprecated, use `deployment.environment.name` instead.' | `staging`; `production` | 
Deprecated, use `deployment.environment.name` instead. |
diff --git a/docs/attributes-registry/destination.md b/docs/attributes-registry/destination.md
index fd05b323fe..bf537414ab 100644
--- a/docs/attributes-registry/destination.md
+++ b/docs/attributes-registry/destination.md
@@ -10,9 +10,9 @@
These attributes may be used to describe the receiver of a network exchange/packet. These should be used when there is no client/server relationship between the two sides, or when that relationship is unknown. This covers low-level network interactions (e.g. packet tracing) where you don't know if there was a connection or which side initiated it. This also covers unidirectional UDP flows and peer-to-peer communication where the "user-facing" surface of the protocol / API doesn't expose a clear notion of client and server.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `destination.address` | string | Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `destination.example.com`; `10.1.2.80`; `/tmp/my.sock` |  |
-| `destination.port` | int | Destination port number | `3389`; `2888` |  |
+| `destination.port` | int | Destination port number | `3389`; `2888` |  |
**[1]:** When observed from the source side, and when communicating through an intermediary, `destination.address` SHOULD represent the destination address behind any intermediaries, for example proxies, if it's available.
diff --git a/docs/attributes-registry/device.md b/docs/attributes-registry/device.md
index 39d55013e6..283cfc60a6 100644
--- a/docs/attributes-registry/device.md
+++ b/docs/attributes-registry/device.md
@@ -10,12 +10,12 @@
Describes device attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------- | ------ | ----------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
-| `device.id` | string | A unique identifier representing the device [1] | `2ab2916d-a51f-4ac8-80ee-45ac31a28092` |  |
-| `device.manufacturer` | string | The name of the device manufacturer [2] | `Apple`; `Samsung` |  |
-| `device.model.identifier` | string | The model identifier for the device [3] | `iPhone3,4`; `SM-G920F` |  |
-| `device.model.name` | string | The marketing name for the device model [4] | `iPhone 6s Plus`; `Samsung Galaxy S6` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `device.id` | string | A unique identifier representing the device [1] | `2ab2916d-a51f-4ac8-80ee-45ac31a28092` |  |
+| `device.manufacturer` | string | The name of the device manufacturer [2] | `Apple`; `Samsung` |  |
+| `device.model.identifier` | string | The model identifier for the device [3] | `iPhone3,4`; `SM-G920F` |  |
+| `device.model.name` | string | The marketing name for the device model [4] | `iPhone 6s Plus`; `Samsung Galaxy S6` |  |
**[1]:** The device identifier MUST only be defined using the values outlined below. This value is not an advertising identifier and MUST NOT be used as such. On iOS (Swift or Objective-C), this value MUST be equal to the [vendor identifier](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). On Android (Java or Kotlin), this value MUST be equal to the Firebase Installation ID or a globally unique UUID which is persisted across sessions in your application. More information can be found [here](https://developer.android.com/training/articles/user-data-ids) on best practices and exact implementation details. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply, ensure you do your own due diligence.
diff --git a/docs/attributes-registry/disk.md b/docs/attributes-registry/disk.md
index 34890a9026..3bd1c7ce5f 100644
--- a/docs/attributes-registry/disk.md
+++ b/docs/attributes-registry/disk.md
@@ -10,13 +10,13 @@
These attributes may be used for any disk related operation.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------- | ------ | -------------------------------- | -------- | ---------------------------------------------------------------- |
-| `disk.io.direction` | string | The disk IO operation direction. | `read` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `disk.io.direction` | string | The disk IO operation direction. | `read` |  |
`disk.io.direction` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------- | ----------- | ---------------------------------------------------------------- |
-| `read` | read |  |
-| `write` | write |  |
+| Value | Description | Stability |
+|---|---|---|
+| `read` | read |  |
+| `write` | write |  |
diff --git a/docs/attributes-registry/dns.md b/docs/attributes-registry/dns.md
index 37648581df..52088b6e6b 100644
--- a/docs/attributes-registry/dns.md
+++ b/docs/attributes-registry/dns.md
@@ -10,8 +10,8 @@
This document defines the shared attributes used to report a DNS query.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------- | ------ | --------------------------- | ------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `dns.question.name` | string | The name being queried. [1] | `www.example.com`; `opentelemetry.io` |  |
**[1]:** If the name field contains non-printable characters (below 32 or above 126), those characters should be represented as escaped base 10 integers (\DDD). Back slashes and quotes should be escaped. Tabs, carriage returns, and line feeds should be converted to \t, \r, and \n respectively.
diff --git a/docs/attributes-registry/dotnet.md b/docs/attributes-registry/dotnet.md
index 0ba37a5ea1..0e806cbc49 100644
--- a/docs/attributes-registry/dotnet.md
+++ b/docs/attributes-registry/dotnet.md
@@ -10,16 +10,16 @@
This document defines .NET related attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `dotnet.gc.heap.generation` | string | Name of the garbage collector managed heap generation. | `gen0`; `gen1`; `gen2` |  |
`dotnet.gc.heap.generation` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | ------------------ | ---------------------------------------------------------------- |
-| `gen0` | Generation 0 |  |
-| `gen1` | Generation 1 |  |
-| `gen2` | Generation 2 |  |
-| `loh` | Large Object Heap |  |
-| `poh` | Pinned Object Heap |  |
+| Value | Description | Stability |
+|---|---|---|
+| `gen0` | Generation 0 |  |
+| `gen1` | Generation 1 |  |
+| `gen2` | Generation 2 |  |
+| `loh` | Large Object Heap |  |
+| `poh` | Pinned Object Heap |  |
diff --git a/docs/attributes-registry/enduser.md b/docs/attributes-registry/enduser.md
index f7b78bc201..a8df586a66 100644
--- a/docs/attributes-registry/enduser.md
+++ b/docs/attributes-registry/enduser.md
@@ -10,8 +10,8 @@
Describes deprecated enduser attributes. Complete enduser namespace has been deprecated
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------- | ------ | ---------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------- |
-| `enduser.id` | string | Deprecated, use `user.id` instead. | `username` | 
Replaced by `user.id` attribute. |
-| `enduser.role` | string | Deprecated, use `user.roles` instead. | `admin` | 
Replaced by `user.roles` attribute. |
-| `enduser.scope` | string | Deprecated, no replacement at this time. | `read:message, write:files` | 
Removed. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `enduser.id` | string | Deprecated, use `user.id` instead. | `username` | 
Replaced by `user.id` attribute. |
+| `enduser.role` | string | Deprecated, use `user.roles` instead. | `admin` | 
Replaced by `user.roles` attribute. |
+| `enduser.scope` | string | Deprecated, no replacement at this time. | `read:message, write:files` | 
Removed. |
diff --git a/docs/attributes-registry/error.md b/docs/attributes-registry/error.md
index 6964e345b0..80e6bdba72 100644
--- a/docs/attributes-registry/error.md
+++ b/docs/attributes-registry/error.md
@@ -10,8 +10,8 @@
This document defines the shared attributes used to report an error.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------ | ------ | -------------------------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `error.type` | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` |  |
**[1]:** The `error.type` SHOULD be predictable, and SHOULD have low cardinality.
@@ -36,6 +36,6 @@ it's RECOMMENDED to:
`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
diff --git a/docs/attributes-registry/event.md b/docs/attributes-registry/event.md
index 85a75d438d..f0856ff2e7 100644
--- a/docs/attributes-registry/event.md
+++ b/docs/attributes-registry/event.md
@@ -10,8 +10,8 @@
Attributes for Events represented using Log Records.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------ | ------ | ----------------------------------------- | --------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `event.name` | string | Identifies the class / type of event. [1] | `browser.mouse.click`; `device.app.lifecycle` |  |
**[1]:** Event names are subject to the same rules as [attribute names](/docs/general/attribute-naming.md). Notably, event names are namespaced to avoid collisions and provide a clean separation of semantics for events in separate domains like browser, mobile, and kubernetes.
diff --git a/docs/attributes-registry/exception.md b/docs/attributes-registry/exception.md
index ecda0cdb5b..84ad81270d 100644
--- a/docs/attributes-registry/exception.md
+++ b/docs/attributes-registry/exception.md
@@ -10,12 +10,12 @@
This document defines the shared attributes used to report a single exception associated with a span or log.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
-| `exception.escaped` | boolean | SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span. [1] | |  |
-| `exception.message` | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` |  |
-| `exception.stacktrace` | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `Exception in thread "main" java.lang.RuntimeException: Test exception\n at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` |  |
-| `exception.type` | string | The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. | `java.net.ConnectException`; `OSError` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `exception.escaped` | boolean | SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span. [1] | |  |
+| `exception.message` | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` |  |
+| `exception.stacktrace` | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `Exception in thread "main" java.lang.RuntimeException: Test exception\n at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` |  |
+| `exception.type` | string | The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. | `java.net.ConnectException`; `OSError` |  |
**[1]:** An exception is considered to have escaped (or left) the scope of a span,
if that span is ended while the exception is still logically "in flight".
diff --git a/docs/attributes-registry/faas.md b/docs/attributes-registry/faas.md
index d05f7f199e..a38c8ebffc 100644
--- a/docs/attributes-registry/faas.md
+++ b/docs/attributes-registry/faas.md
@@ -10,26 +10,26 @@
FaaS attributes
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------- |
-| `faas.coldstart` | boolean | A boolean that is true if the serverless function is executed for the first time (aka cold-start). | |  |
-| `faas.cron` | string | A string containing the schedule period as [Cron Expression](https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm). | `0/5 * * * ? *` |  |
-| `faas.document.collection` | string | The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name. | `myBucketName`; `myDbName` |  |
-| `faas.document.name` | string | The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name. | `myFile.txt`; `myTableName` |  |
-| `faas.document.operation` | string | Describes the type of the operation that was performed on the data. | `insert`; `edit`; `delete` |  |
-| `faas.document.time` | string | A string containing the time when the data was accessed in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` |  |
-| `faas.instance` | string | The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version. [1] | `2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de` |  |
-| `faas.invocation_id` | string | The invocation ID of the current function invocation. | `af9d5aa4-a685-4c5f-a22b-444f80b3cc28` |  |
-| `faas.invoked_name` | string | The name of the invoked function. [2] | `my-function` |  |
-| `faas.invoked_provider` | string | The cloud provider of the invoked function. [3] | `alibaba_cloud`; `aws`; `azure` |  |
-| `faas.invoked_region` | string | The cloud region of the invoked function. [4] | `eu-central-1` |  |
-| `faas.max_memory` | int | The amount of memory available to the serverless function converted to Bytes. [5] | `134217728` |  |
-| `faas.name` | string | The name of the single function that this runtime instance executes. [6] | `my-function`; `myazurefunctionapp/some-function-name` |  |
-| `faas.time` | string | A string containing the function invocation time in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` |  |
-| `faas.trigger` | string | Type of the trigger which caused this function invocation. | `datasource`; `http`; `pubsub` |  |
-| `faas.version` | string | The immutable version of the function being executed. [7] | `26`; `pinkfroid-00002` |  |
-
-**[1]:** \* **AWS Lambda:** Use the (full) log stream name.
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `faas.coldstart` | boolean | A boolean that is true if the serverless function is executed for the first time (aka cold-start). | |  |
+| `faas.cron` | string | A string containing the schedule period as [Cron Expression](https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm). | `0/5 * * * ? *` |  |
+| `faas.document.collection` | string | The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name. | `myBucketName`; `myDbName` |  |
+| `faas.document.name` | string | The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name. | `myFile.txt`; `myTableName` |  |
+| `faas.document.operation` | string | Describes the type of the operation that was performed on the data. | `insert`; `edit`; `delete` |  |
+| `faas.document.time` | string | A string containing the time when the data was accessed in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` |  |
+| `faas.instance` | string | The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version. [1] | `2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de` |  |
+| `faas.invocation_id` | string | The invocation ID of the current function invocation. | `af9d5aa4-a685-4c5f-a22b-444f80b3cc28` |  |
+| `faas.invoked_name` | string | The name of the invoked function. [2] | `my-function` |  |
+| `faas.invoked_provider` | string | The cloud provider of the invoked function. [3] | `alibaba_cloud`; `aws`; `azure` |  |
+| `faas.invoked_region` | string | The cloud region of the invoked function. [4] | `eu-central-1` |  |
+| `faas.max_memory` | int | The amount of memory available to the serverless function converted to Bytes. [5] | `134217728` |  |
+| `faas.name` | string | The name of the single function that this runtime instance executes. [6] | `my-function`; `myazurefunctionapp/some-function-name` |  |
+| `faas.time` | string | A string containing the function invocation time in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` |  |
+| `faas.trigger` | string | Type of the trigger which caused this function invocation. | `datasource`; `http`; `pubsub` |  |
+| `faas.version` | string | The immutable version of the function being executed. [7] | `26`; `pinkfroid-00002` |  |
+
+**[1]:** - **AWS Lambda:** Use the (full) log stream name.
**[2]:** SHOULD be equal to the `faas.name` resource attribute of the invoked function.
@@ -49,7 +49,7 @@ For some cloud providers, the above definition is ambiguous. The following
definition of function name MUST be used for this attribute
(and consequently the span name) for the listed cloud providers/products:
-- **Azure:** The full name `/`, i.e., function app name
+- **Azure:** The full name `/`, i.e., function app name
followed by a forward slash followed by the function name (this form
can also be seen in the resource JSON for the function).
This means that a span attribute MUST be used, as an Azure function
@@ -68,28 +68,28 @@ definition of function name MUST be used for this attribute
`faas.document.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ----------------------------- | ---------------------------------------------------------------- |
-| `delete` | When an object is deleted. |  |
-| `edit` | When an object is modified. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `delete` | When an object is deleted. |  |
+| `edit` | When an object is modified. |  |
| `insert` | When a new object is created. |  |
`faas.invoked_provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------------- | --------------------- | ---------------------------------------------------------------- |
-| `alibaba_cloud` | Alibaba Cloud |  |
-| `aws` | Amazon Web Services |  |
-| `azure` | Microsoft Azure |  |
-| `gcp` | Google Cloud Platform |  |
-| `tencent_cloud` | Tencent Cloud |  |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud` | Alibaba Cloud |  |
+| `aws` | Amazon Web Services |  |
+| `azure` | Microsoft Azure |  |
+| `gcp` | Google Cloud Platform |  |
+| `tencent_cloud` | Tencent Cloud |  |
`faas.trigger` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------ | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
-| `http` | To provide an answer to an inbound HTTP request |  |
-| `other` | If none of the others apply |  |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
-| `timer` | A function is scheduled to be executed regularly |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `other` | If none of the others apply |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
diff --git a/docs/attributes-registry/feature-flag.md b/docs/attributes-registry/feature-flag.md
index 6c5244edab..91e0be7a53 100644
--- a/docs/attributes-registry/feature-flag.md
+++ b/docs/attributes-registry/feature-flag.md
@@ -10,11 +10,11 @@
This document defines attributes for Feature Flags.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------- | ------------------- | ---------------------------------------------------------------- |
-| `feature_flag.key` | string | The unique identifier of the feature flag. | `logo-color` |  |
-| `feature_flag.provider_name` | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` |  |
-| `feature_flag.variant` | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `feature_flag.key` | string | The unique identifier of the feature flag. | `logo-color` |  |
+| `feature_flag.provider_name` | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` |  |
+| `feature_flag.variant` | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` |  |
**[1]:** A semantic identifier, commonly referred to as a variant, provides a means
for referring to a value without including the value itself. This can
diff --git a/docs/attributes-registry/file.md b/docs/attributes-registry/file.md
index efc9a488ed..243dc8ef1f 100644
--- a/docs/attributes-registry/file.md
+++ b/docs/attributes-registry/file.md
@@ -10,26 +10,26 @@
Describes file attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `file.accessed` | string | Time when the file was last accessed, in ISO 8601 format. [1] | `2021-01-01T12:00:00Z` |  |
-| `file.attributes` | string[] | Array of file attributes. [2] | `["readonly", "hidden"]` |  |
-| `file.changed` | string | Time when the file attributes or metadata was last changed, in ISO 8601 format. [3] | `2021-01-01T12:00:00Z` |  |
-| `file.created` | string | Time when the file was created, in ISO 8601 format. [4] | `2021-01-01T12:00:00Z` |  |
-| `file.directory` | string | Directory where the file is located. It should include the drive letter, when appropriate. | `/home/user`; `C:\Program Files\MyApp` |  |
-| `file.extension` | string | File extension, excluding the leading dot. [5] | `png`; `gz` |  |
-| `file.fork_name` | string | Name of the fork. A fork is additional data associated with a filesystem object. [6] | `Zone.Identifer` |  |
-| `file.group.id` | string | Primary Group ID (GID) of the file. | `1000` |  |
-| `file.group.name` | string | Primary group name of the file. | `users` |  |
-| `file.inode` | string | Inode representing the file in the filesystem. | `256383` |  |
-| `file.mode` | string | Mode of the file in octal representation. | `0640` |  |
-| `file.modified` | string | Time when the file content was last modified, in ISO 8601 format. | `2021-01-01T12:00:00Z` |  |
-| `file.name` | string | Name of the file including the extension, without the directory. | `example.png` |  |
-| `file.owner.id` | string | The user ID (UID) or security identifier (SID) of the file owner. | `1000` |  |
-| `file.owner.name` | string | Username of the file owner. | `root` |  |
-| `file.path` | string | Full path to the file, including the file name. It should include the drive letter, when appropriate. | `/home/alice/example.png`; `C:\Program Files\MyApp\myapp.exe` |  |
-| `file.size` | int | File size in bytes. | |  |
-| `file.symbolic_link.target_path` | string | Path to the target of a symbolic link. [7] | `/usr/bin/python3` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `file.accessed` | string | Time when the file was last accessed, in ISO 8601 format. [1] | `2021-01-01T12:00:00Z` |  |
+| `file.attributes` | string[] | Array of file attributes. [2] | `["readonly", "hidden"]` |  |
+| `file.changed` | string | Time when the file attributes or metadata was last changed, in ISO 8601 format. [3] | `2021-01-01T12:00:00Z` |  |
+| `file.created` | string | Time when the file was created, in ISO 8601 format. [4] | `2021-01-01T12:00:00Z` |  |
+| `file.directory` | string | Directory where the file is located. It should include the drive letter, when appropriate. | `/home/user`; `C:\Program Files\MyApp` |  |
+| `file.extension` | string | File extension, excluding the leading dot. [5] | `png`; `gz` |  |
+| `file.fork_name` | string | Name of the fork. A fork is additional data associated with a filesystem object. [6] | `Zone.Identifer` |  |
+| `file.group.id` | string | Primary Group ID (GID) of the file. | `1000` |  |
+| `file.group.name` | string | Primary group name of the file. | `users` |  |
+| `file.inode` | string | Inode representing the file in the filesystem. | `256383` |  |
+| `file.mode` | string | Mode of the file in octal representation. | `0640` |  |
+| `file.modified` | string | Time when the file content was last modified, in ISO 8601 format. | `2021-01-01T12:00:00Z` |  |
+| `file.name` | string | Name of the file including the extension, without the directory. | `example.png` |  |
+| `file.owner.id` | string | The user ID (UID) or security identifier (SID) of the file owner. | `1000` |  |
+| `file.owner.name` | string | Username of the file owner. | `root` |  |
+| `file.path` | string | Full path to the file, including the file name. It should include the drive letter, when appropriate. | `/home/alice/example.png`; `C:\Program Files\MyApp\myapp.exe` |  |
+| `file.size` | int | File size in bytes. | |  |
+| `file.symbolic_link.target_path` | string | Path to the target of a symbolic link. [7] | `/usr/bin/python3` |  |
**[1]:** This attribute might not be supported by some file systems — NFS, FAT32, in embedded OS, etc.
diff --git a/docs/attributes-registry/gcp.md b/docs/attributes-registry/gcp.md
index 94bac87ec2..0ad397c713 100644
--- a/docs/attributes-registry/gcp.md
+++ b/docs/attributes-registry/gcp.md
@@ -14,8 +14,8 @@
Attributes for Google Cloud client libraries.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------ | ----------------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `gcp.client.service` | string | Identifies the Google Cloud service for which the official client library is intended. [1] | `appengine`; `run`; `firestore`; `alloydb`; `spanner` |  |
**[1]:** Intended to be a stable identifier for Google Cloud client libraries that is uniform across implementation languages. The value should be derived from the canonical service domain for the service; for example, 'foo.googleapis.com' should result in a value of 'foo'.
@@ -24,16 +24,16 @@ Attributes for Google Cloud client libraries.
This document defines attributes for Google Cloud Run.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------- |
-| `gcp.cloud_run.job.execution` | string | The name of the Cloud Run [execution](https://cloud.google.com/run/docs/managing/job-executions) being run for the Job, as set by the [`CLOUD_RUN_EXECUTION`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `job-name-xxxx`; `sample-job-mdw84` |  |
-| `gcp.cloud_run.job.task_index` | int | The index for a task within an execution as provided by the [`CLOUD_RUN_TASK_INDEX`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `0`; `1` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `gcp.cloud_run.job.execution` | string | The name of the Cloud Run [execution](https://cloud.google.com/run/docs/managing/job-executions) being run for the Job, as set by the [`CLOUD_RUN_EXECUTION`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `job-name-xxxx`; `sample-job-mdw84` |  |
+| `gcp.cloud_run.job.task_index` | int | The index for a task within an execution as provided by the [`CLOUD_RUN_TASK_INDEX`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `0`; `1` |  |
## GCP - Google Compute Engine (GCE) Attributes
This document defines attributes for Google Compute Engine (GCE).
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `gcp.gce.instance.hostname` | string | The hostname of a GCE instance. This is the full value of the default or [custom hostname](https://cloud.google.com/compute/docs/instances/custom-hostname-vm). | `my-host1234.example.com`; `sample-vm.us-west1-b.c.my-project.internal` |  |
-| `gcp.gce.instance.name` | string | The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). | `instance-1`; `my-vm-name` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `gcp.gce.instance.hostname` | string | The hostname of a GCE instance. This is the full value of the default or [custom hostname](https://cloud.google.com/compute/docs/instances/custom-hostname-vm). | `my-host1234.example.com`; `sample-vm.us-west1-b.c.my-project.internal` |  |
+| `gcp.gce.instance.name` | string | The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). | `instance-1`; `my-vm-name` |  |
diff --git a/docs/attributes-registry/gen-ai.md b/docs/attributes-registry/gen-ai.md
index 844a947bdf..814464f3f1 100644
--- a/docs/attributes-registry/gen-ai.md
+++ b/docs/attributes-registry/gen-ai.md
@@ -14,24 +14,24 @@
This document defines the attributes used to describe telemetry in the context of Generative Artificial Intelligence (GenAI) Models requests and responses.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------------ | -------- | ------------------------------------------------------------------------------------------------ | -------------------------------- | ---------------------------------------------------------------- |
-| `gen_ai.operation.name` | string | The name of the operation being performed. [1] | `chat`; `text_completion` |  |
-| `gen_ai.request.frequency_penalty` | double | The frequency penalty setting for the GenAI request. | `0.1` |  |
-| `gen_ai.request.max_tokens` | int | The maximum number of tokens the model generates for a request. | `100` |  |
-| `gen_ai.request.model` | string | The name of the GenAI model a request is being made to. | `gpt-4` |  |
-| `gen_ai.request.presence_penalty` | double | The presence penalty setting for the GenAI request. | `0.1` |  |
-| `gen_ai.request.stop_sequences` | string[] | List of sequences that the model will use to stop generating further tokens. | `["forest", "lived"]` |  |
-| `gen_ai.request.temperature` | double | The temperature setting for the GenAI request. | `0.0` |  |
-| `gen_ai.request.top_k` | double | The top_k sampling setting for the GenAI request. | `1.0` |  |
-| `gen_ai.request.top_p` | double | The top_p sampling setting for the GenAI request. | `1.0` |  |
-| `gen_ai.response.finish_reasons` | string[] | Array of reasons the model stopped generating tokens, corresponding to each generation received. | `["stop"]`; `["stop", "length"]` |  |
-| `gen_ai.response.id` | string | The unique identifier for the completion. | `chatcmpl-123` |  |
-| `gen_ai.response.model` | string | The name of the model that generated the response. | `gpt-4-0613` |  |
-| `gen_ai.system` | string | The Generative AI product as identified by the client or server instrumentation. [2] | `openai` |  |
-| `gen_ai.token.type` | string | The type of token being counted. | `input`; `output` |  |
-| `gen_ai.usage.input_tokens` | int | The number of tokens used in the GenAI input (prompt). | `100` |  |
-| `gen_ai.usage.output_tokens` | int | The number of tokens used in the GenAI response (completion). | `180` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `gen_ai.operation.name` | string | The name of the operation being performed. [1] | `chat`; `text_completion` |  |
+| `gen_ai.request.frequency_penalty` | double | The frequency penalty setting for the GenAI request. | `0.1` |  |
+| `gen_ai.request.max_tokens` | int | The maximum number of tokens the model generates for a request. | `100` |  |
+| `gen_ai.request.model` | string | The name of the GenAI model a request is being made to. | `gpt-4` |  |
+| `gen_ai.request.presence_penalty` | double | The presence penalty setting for the GenAI request. | `0.1` |  |
+| `gen_ai.request.stop_sequences` | string[] | List of sequences that the model will use to stop generating further tokens. | `["forest", "lived"]` |  |
+| `gen_ai.request.temperature` | double | The temperature setting for the GenAI request. | `0.0` |  |
+| `gen_ai.request.top_k` | double | The top_k sampling setting for the GenAI request. | `1.0` |  |
+| `gen_ai.request.top_p` | double | The top_p sampling setting for the GenAI request. | `1.0` |  |
+| `gen_ai.response.finish_reasons` | string[] | Array of reasons the model stopped generating tokens, corresponding to each generation received. | `["stop"]`; `["stop", "length"]` |  |
+| `gen_ai.response.id` | string | The unique identifier for the completion. | `chatcmpl-123` |  |
+| `gen_ai.response.model` | string | The name of the model that generated the response. | `gpt-4-0613` |  |
+| `gen_ai.system` | string | The Generative AI product as identified by the client or server instrumentation. [2] | `openai` |  |
+| `gen_ai.token.type` | string | The type of token being counted. | `input`; `output` |  |
+| `gen_ai.usage.input_tokens` | int | The number of tokens used in the GenAI input (prompt). | `100` |  |
+| `gen_ai.usage.output_tokens` | int | The number of tokens used in the GenAI response (completion). | `180` |  |
**[1]:** If one of the predefined values applies, but specific system uses a different name it's RECOMMENDED to document it in the semantic conventions for specific GenAI system and use system-specific name in the instrumentation. If a different name is not documented, instrumentation libraries SHOULD use applicable predefined value.
@@ -47,61 +47,61 @@ If none of these options apply, the `gen_ai.system` SHOULD be set to `_OTHER`.
`gen_ai.operation.name` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `chat` | Chat completion operation such as [OpenAI Chat API](https://platform.openai.com/docs/api-reference/chat) |  |
+| Value | Description | Stability |
+|---|---|---|
+| `chat` | Chat completion operation such as [OpenAI Chat API](https://platform.openai.com/docs/api-reference/chat) |  |
| `text_completion` | Text completions operation such as [OpenAI Completions API (Legacy)](https://platform.openai.com/docs/api-reference/completions) |  |
`gen_ai.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----------------- | ------------------ | ---------------------------------------------------------------- |
-| `anthropic` | Anthropic |  |
+| Value | Description | Stability |
+|---|---|---|
+| `anthropic` | Anthropic |  |
| `az.ai.inference` | Azure AI Inference |  |
-| `cohere` | Cohere |  |
-| `openai` | OpenAI |  |
-| `vertex_ai` | Vertex AI |  |
+| `cohere` | Cohere |  |
+| `openai` | OpenAI |  |
+| `vertex_ai` | Vertex AI |  |
`gen_ai.token.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ------------------------------------------ | ---------------------------------------------------------------- |
-| `input` | Input tokens (prompt, input, etc.) |  |
+| Value | Description | Stability |
+|---|---|---|
+| `input` | Input tokens (prompt, input, etc.) |  |
| `output` | Output tokens (completion, response, etc.) |  |
## OpenAI Attributes
Thie group defines attributes for OpenAI.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------- | ------------------ | ---------------------------------------------------------------- |
-| `gen_ai.openai.request.response_format` | string | The response format that is requested. | `json` |  |
-| `gen_ai.openai.request.seed` | int | Requests with same seed value more likely to return same result. | `100` |  |
-| `gen_ai.openai.request.service_tier` | string | The service tier requested. May be a specific tier, detault, or auto. | `auto`; `default` |  |
-| `gen_ai.openai.response.service_tier` | string | The service tier used for the response. | `scale`; `detault` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `gen_ai.openai.request.response_format` | string | The response format that is requested. | `json` |  |
+| `gen_ai.openai.request.seed` | int | Requests with same seed value more likely to return same result. | `100` |  |
+| `gen_ai.openai.request.service_tier` | string | The service tier requested. May be a specific tier, detault, or auto. | `auto`; `default` |  |
+| `gen_ai.openai.response.service_tier` | string | The service tier used for the response. | `scale`; `detault` |  |
`gen_ai.openai.request.response_format` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------- | --------------------------- | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `json_object` | JSON object response format |  |
| `json_schema` | JSON schema response format |  |
-| `text` | Text response format |  |
+| `text` | Text response format |  |
`gen_ai.openai.request.service_tier` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | -------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `auto` | The system will utilize scale tier credits until they are exhausted. |  |
-| `default` | The system will utilize the default scale tier. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `auto` | The system will utilize scale tier credits until they are exhausted. |  |
+| `default` | The system will utilize the default scale tier. |  |
## Deprecated GenAI Attributes
Describes deprecated `gen_ai` attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------ | ------ | --------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
-| `gen_ai.completion` | string | Deprecated, use Event API to report completions contents. | `[{'role': 'assistant', 'content': 'The capital of France is Paris.'}]` | 
Removed, no replacement at this time. |
-| `gen_ai.prompt` | string | Deprecated, use Event API to report prompt contents. | `[{'role': 'user', 'content': 'What is the capital of France?'}]` | 
Removed, no replacement at this time. |
-| `gen_ai.usage.completion_tokens` | int | Deprecated, use `gen_ai.usage.output_tokens` instead. | `42` | 
Replaced by `gen_ai.usage.output_tokens` attribute. |
-| `gen_ai.usage.prompt_tokens` | int | Deprecated, use `gen_ai.usage.input_tokens` instead. | `42` | 
Replaced by `gen_ai.usage.input_tokens` attribute. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `gen_ai.completion` | string | Deprecated, use Event API to report completions contents. | `[{'role': 'assistant', 'content': 'The capital of France is Paris.'}]` | 
Removed, no replacement at this time. |
+| `gen_ai.prompt` | string | Deprecated, use Event API to report prompt contents. | `[{'role': 'user', 'content': 'What is the capital of France?'}]` | 
Removed, no replacement at this time. |
+| `gen_ai.usage.completion_tokens` | int | Deprecated, use `gen_ai.usage.output_tokens` instead. | `42` | 
Replaced by `gen_ai.usage.output_tokens` attribute. |
+| `gen_ai.usage.prompt_tokens` | int | Deprecated, use `gen_ai.usage.input_tokens` instead. | `42` | 
Replaced by `gen_ai.usage.input_tokens` attribute. |
diff --git a/docs/attributes-registry/go.md b/docs/attributes-registry/go.md
index b69ccb1d7c..d27bca24ce 100644
--- a/docs/attributes-registry/go.md
+++ b/docs/attributes-registry/go.md
@@ -10,15 +10,15 @@
This document defines Go related attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------ | ------ | ------------------- | ---------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `go.memory.type` | string | The type of memory. | `other`; `stack` |  |
`go.memory.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `other` | Memory used by the Go runtime, excluding other categories of memory usage described in this enumeration. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `other` | Memory used by the Go runtime, excluding other categories of memory usage described in this enumeration. |  |
| `stack` | Memory allocated from the heap that is reserved for stack space, whether or not it is currently in-use. [1] |  |
**[1]:** Computed from `/memory/classes/heap/stacks:bytes`.
diff --git a/docs/attributes-registry/graphql.md b/docs/attributes-registry/graphql.md
index eb95667975..1b08f50c53 100644
--- a/docs/attributes-registry/graphql.md
+++ b/docs/attributes-registry/graphql.md
@@ -10,18 +10,18 @@
This document defines attributes for GraphQL.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------ | ------ | ----------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------- |
-| `graphql.document` | string | The GraphQL document being executed. [1] | `query findBookById { bookById(id: ?) { name } }` |  |
-| `graphql.operation.name` | string | The name of the operation being executed. | `findBookById` |  |
-| `graphql.operation.type` | string | The type of the operation being executed. | `query`; `mutation`; `subscription` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `graphql.document` | string | The GraphQL document being executed. [1] | `query findBookById { bookById(id: ?) { name } }` |  |
+| `graphql.operation.name` | string | The name of the operation being executed. | `findBookById` |  |
+| `graphql.operation.type` | string | The type of the operation being executed. | `query`; `mutation`; `subscription` |  |
**[1]:** The value may be sanitized to exclude sensitive information.
`graphql.operation.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------- | -------------------- | ---------------------------------------------------------------- |
-| `mutation` | GraphQL mutation |  |
-| `query` | GraphQL query |  |
+| Value | Description | Stability |
+|---|---|---|
+| `mutation` | GraphQL mutation |  |
+| `query` | GraphQL query |  |
| `subscription` | GraphQL subscription |  |
diff --git a/docs/attributes-registry/hardware.md b/docs/attributes-registry/hardware.md
index ae560f23d1..45b5a2d1f3 100644
--- a/docs/attributes-registry/hardware.md
+++ b/docs/attributes-registry/hardware.md
@@ -10,39 +10,39 @@
Attributes for hardware.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------- |
-| `hw.id` | string | An identifier for the hardware component, unique within the monitored host | `win32battery_battery_testsysa33_1` |  |
-| `hw.name` | string | An easily-recognizable name for the hardware component | `eth0` |  |
-| `hw.parent` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |  |
-| `hw.state` | string | The current state of the component | `ok`; `degraded`; `failed` |  |
-| `hw.type` | string | Type of the component [1] | `battery`; `cpu`; `disk_controller` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `hw.id` | string | An identifier for the hardware component, unique within the monitored host | `win32battery_battery_testsysa33_1` |  |
+| `hw.name` | string | An easily-recognizable name for the hardware component | `eth0` |  |
+| `hw.parent` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |  |
+| `hw.state` | string | The current state of the component | `ok`; `degraded`; `failed` |  |
+| `hw.type` | string | Type of the component [1] | `battery`; `cpu`; `disk_controller` |  |
**[1]:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
`hw.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------- | ----------- | ---------------------------------------------------------------- |
-| `degraded` | Degraded |  |
-| `failed` | Failed |  |
-| `ok` | Ok |  |
+| Value | Description | Stability |
+|---|---|---|
+| `degraded` | Degraded |  |
+| `failed` | Failed |  |
+| `ok` | Ok |  |
`hw.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----------------- | --------------- | ---------------------------------------------------------------- |
-| `battery` | Battery |  |
-| `cpu` | CPU |  |
+| Value | Description | Stability |
+|---|---|---|
+| `battery` | Battery |  |
+| `cpu` | CPU |  |
| `disk_controller` | Disk controller |  |
-| `enclosure` | Enclosure |  |
-| `fan` | Fan |  |
-| `gpu` | GPU |  |
-| `logical_disk` | Logical disk |  |
-| `memory` | Memory |  |
-| `network` | Network |  |
-| `physical_disk` | Physical disk |  |
-| `power_supply` | Power supply |  |
-| `tape_drive` | Tape drive |  |
-| `temperature` | Temperature |  |
-| `voltage` | Voltage |  |
+| `enclosure` | Enclosure |  |
+| `fan` | Fan |  |
+| `gpu` | GPU |  |
+| `logical_disk` | Logical disk |  |
+| `memory` | Memory |  |
+| `network` | Network |  |
+| `physical_disk` | Physical disk |  |
+| `power_supply` | Power supply |  |
+| `tape_drive` | Tape drive |  |
+| `temperature` | Temperature |  |
+| `voltage` | Voltage |  |
diff --git a/docs/attributes-registry/heroku.md b/docs/attributes-registry/heroku.md
index 498d7cde7b..3380e4753f 100644
--- a/docs/attributes-registry/heroku.md
+++ b/docs/attributes-registry/heroku.md
@@ -10,8 +10,8 @@
This document defines attributes for the Android platform on which the Android application is running.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------- | --------------------------------------- | ---------------------------------------------------------------- |
-| `heroku.app.id` | string | Unique identifier for the application | `2daa2797-e42b-4624-9322-ec3f968df4da` |  |
-| `heroku.release.commit` | string | Commit hash for the current release | `e6134959463efd8966b20e75b913cafe3f5ec` |  |
-| `heroku.release.creation_timestamp` | string | Time and date the release was created | `2022-10-23T18:00:42Z` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `heroku.app.id` | string | Unique identifier for the application | `2daa2797-e42b-4624-9322-ec3f968df4da` |  |
+| `heroku.release.commit` | string | Commit hash for the current release | `e6134959463efd8966b20e75b913cafe3f5ec` |  |
+| `heroku.release.creation_timestamp` | string | Time and date the release was created | `2022-10-23T18:00:42Z` |  |
diff --git a/docs/attributes-registry/host.md b/docs/attributes-registry/host.md
index f4bd839f4f..f3cec69aae 100644
--- a/docs/attributes-registry/host.md
+++ b/docs/attributes-registry/host.md
@@ -10,23 +10,23 @@
A host is defined as a computing instance. For example, physical servers, virtual machines, switches or disk array.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `host.arch` | string | The CPU architecture the host system is running on. | `amd64`; `arm32`; `arm64` |  |
-| `host.cpu.cache.l2.size` | int | The amount of level 2 memory cache available to the processor (in Bytes). | `12288000` |  |
-| `host.cpu.family` | string | Family or generation of the CPU. | `6`; `PA-RISC 1.1e` |  |
-| `host.cpu.model.id` | string | Model identifier. It provides more granular information about the CPU, distinguishing it from other CPUs within the same family. | `6`; `9000/778/B180L` |  |
-| `host.cpu.model.name` | string | Model designation of the processor. | `11th Gen Intel(R) Core(TM) i7-1185G7 @ 3.00GHz` |  |
-| `host.cpu.stepping` | string | Stepping or core revisions. | `1`; `r1p1` |  |
-| `host.cpu.vendor.id` | string | Processor manufacturer identifier. A maximum 12-character string. [1] | `GenuineIntel` |  |
-| `host.id` | string | Unique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For non-containerized systems, this should be the `machine-id`. See the table below for the sources to use to determine the `machine-id` based on operating system. | `fdbf79e8af94cb7f9e8df36789187052` |  |
-| `host.image.id` | string | VM image ID or host OS image ID. For Cloud, this value is from the provider. | `ami-07b06b442921831e5` |  |
-| `host.image.name` | string | Name of the VM image or OS install the host was instantiated from. | `infra-ami-eks-worker-node-7d4ec78312`; `CentOS-8-x86_64-1905` |  |
-| `host.image.version` | string | The version string of the VM image or host OS as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `0.1` |  |
-| `host.ip` | string[] | Available IP addresses of the host, excluding loopback interfaces. [2] | `["192.168.1.140", "fe80::abc2:4a28:737a:609e"]` |  |
-| `host.mac` | string[] | Available MAC addresses of the host, excluding loopback interfaces. [3] | `["AC-DE-48-23-45-67", "AC-DE-48-23-45-67-01-9F"]` |  |
-| `host.name` | string | Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. | `opentelemetry-test` |  |
-| `host.type` | string | Type of host. For Cloud, this must be the machine type. | `n1-standard-1` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `host.arch` | string | The CPU architecture the host system is running on. | `amd64`; `arm32`; `arm64` |  |
+| `host.cpu.cache.l2.size` | int | The amount of level 2 memory cache available to the processor (in Bytes). | `12288000` |  |
+| `host.cpu.family` | string | Family or generation of the CPU. | `6`; `PA-RISC 1.1e` |  |
+| `host.cpu.model.id` | string | Model identifier. It provides more granular information about the CPU, distinguishing it from other CPUs within the same family. | `6`; `9000/778/B180L` |  |
+| `host.cpu.model.name` | string | Model designation of the processor. | `11th Gen Intel(R) Core(TM) i7-1185G7 @ 3.00GHz` |  |
+| `host.cpu.stepping` | string | Stepping or core revisions. | `1`; `r1p1` |  |
+| `host.cpu.vendor.id` | string | Processor manufacturer identifier. A maximum 12-character string. [1] | `GenuineIntel` |  |
+| `host.id` | string | Unique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For non-containerized systems, this should be the `machine-id`. See the table below for the sources to use to determine the `machine-id` based on operating system. | `fdbf79e8af94cb7f9e8df36789187052` |  |
+| `host.image.id` | string | VM image ID or host OS image ID. For Cloud, this value is from the provider. | `ami-07b06b442921831e5` |  |
+| `host.image.name` | string | Name of the VM image or OS install the host was instantiated from. | `infra-ami-eks-worker-node-7d4ec78312`; `CentOS-8-x86_64-1905` |  |
+| `host.image.version` | string | The version string of the VM image or host OS as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `0.1` |  |
+| `host.ip` | string[] | Available IP addresses of the host, excluding loopback interfaces. [2] | `["192.168.1.140", "fe80::abc2:4a28:737a:609e"]` |  |
+| `host.mac` | string[] | Available MAC addresses of the host, excluding loopback interfaces. [3] | `["AC-DE-48-23-45-67", "AC-DE-48-23-45-67-01-9F"]` |  |
+| `host.name` | string | Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. | `opentelemetry-test` |  |
+| `host.type` | string | Type of host. For Cloud, this must be the machine type. | `n1-standard-1` |  |
**[1]:** [CPUID](https://wiki.osdev.org/CPUID) command returns the vendor ID string in EBX, EDX and ECX registers. Writing these to memory in this order results in a 12-character string.
@@ -36,13 +36,13 @@ A host is defined as a computing instance. For example, physical servers, virtua
`host.arch` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------- | ------------------ | ---------------------------------------------------------------- |
-| `amd64` | AMD64 |  |
-| `arm32` | ARM32 |  |
-| `arm64` | ARM64 |  |
-| `ia64` | Itanium |  |
-| `ppc32` | 32-bit PowerPC |  |
-| `ppc64` | 64-bit PowerPC |  |
+| Value | Description | Stability |
+|---|---|---|
+| `amd64` | AMD64 |  |
+| `arm32` | ARM32 |  |
+| `arm64` | ARM64 |  |
+| `ia64` | Itanium |  |
+| `ppc32` | 32-bit PowerPC |  |
+| `ppc64` | 64-bit PowerPC |  |
| `s390x` | IBM z/Architecture |  |
-| `x86` | 32-bit x86 |  |
+| `x86` | 32-bit x86 |  |
diff --git a/docs/attributes-registry/http.md b/docs/attributes-registry/http.md
index d15e29481f..57953b39be 100644
--- a/docs/attributes-registry/http.md
+++ b/docs/attributes-registry/http.md
@@ -13,20 +13,20 @@
This document defines semantic convention attributes in the HTTP namespace.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `http.connection.state` | string | State of the HTTP connection in the HTTP connection pool. | `active`; `idle` |  |
-| `http.request.body.size` | int | The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size. | `3495` |  |
-| | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [1] | `http.request.header.content-type=["application/json"]`; `http.request.header.x-forwarded-for=["1.2.3.4", "1.2.3.5"]` |  |
-| `http.request.method` | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` |  |
-| `http.request.method_original` | string | Original HTTP method sent by the client in the request line. | `GeT`; `ACL`; `foo` |  |
-| `http.request.resend_count` | int | The ordinal number of request resending attempt (for any reason, including redirects). [3] | `3` |  |
-| `http.request.size` | int | The total size of the request in bytes. This should be the total number of bytes sent over the wire, including the request line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and request body if any. | `1437` |  |
-| `http.response.body.size` | int | The size of the response payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size. | `3495` |  |
-| | string[] | HTTP response headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [4] | `http.response.header.content-type=["application/json"]`; `http.response.header.my-custom-header=["abc", "def"]` |  |
-| `http.response.size` | int | The total size of the response in bytes. This should be the total number of bytes sent over the wire, including the status line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and response body and trailers if any. | `1437` |  |
-| `http.response.status_code` | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` |  |
-| `http.route` | string | The matched route, that is, the path template in the format used by the respective server framework. [5] | `/users/:userID?`; `{controller}/{action}/{id?}` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `http.connection.state` | string | State of the HTTP connection in the HTTP connection pool. | `active`; `idle` |  |
+| `http.request.body.size` | int | The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size. | `3495` |  |
+| | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [1] | `http.request.header.content-type=["application/json"]`; `http.request.header.x-forwarded-for=["1.2.3.4", "1.2.3.5"]` |  |
+| `http.request.method` | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` |  |
+| `http.request.method_original` | string | Original HTTP method sent by the client in the request line. | `GeT`; `ACL`; `foo` |  |
+| `http.request.resend_count` | int | The ordinal number of request resending attempt (for any reason, including redirects). [3] | `3` |  |
+| `http.request.size` | int | The total size of the request in bytes. This should be the total number of bytes sent over the wire, including the request line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and request body if any. | `1437` |  |
+| `http.response.body.size` | int | The size of the response payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size. | `3495` |  |
+| | string[] | HTTP response headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [4] | `http.response.header.content-type=["application/json"]`; `http.response.header.my-custom-header=["abc", "def"]` |  |
+| `http.response.size` | int | The total size of the response in bytes. This should be the total number of bytes sent over the wire, including the status line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and response body and trailers if any. | `1437` |  |
+| `http.response.status_code` | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` |  |
+| `http.route` | string | The matched route, that is, the path template in the format used by the respective server framework. [5] | `/users/:userID?`; `{controller}/{action}/{id?}` |  |
**[1]:** Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all request headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
The `User-Agent` header is already captured in the `user_agent.original` attribute. Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
@@ -58,54 +58,54 @@ SHOULD include the [application root](/docs/http/http-spans.md#http-server-defin
`http.connection.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ------------- | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `active` | active state. |  |
-| `idle` | idle state. |  |
+| `idle` | idle state. |  |
`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | ------------------------------------------------------------------- | ---------------------------------------------------------- |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
-| `CONNECT` | CONNECT method. |  |
-| `DELETE` | DELETE method. |  |
-| `GET` | GET method. |  |
-| `HEAD` | HEAD method. |  |
-| `OPTIONS` | OPTIONS method. |  |
-| `PATCH` | PATCH method. |  |
-| `POST` | POST method. |  |
-| `PUT` | PUT method. |  |
-| `TRACE` | TRACE method. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
## Deprecated HTTP Attributes
Describes deprecated HTTP attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `http.client_ip` | string | Deprecated, use `client.address` instead. | `83.164.160.102` | 
Replaced by `client.address`. |
-| `http.flavor` | string | Deprecated, use `network.protocol.name` instead. | `1.0`; `1.1`; `2.0` | 
Replaced by `network.protocol.name`. |
-| `http.host` | string | Deprecated, use one of `server.address`, `client.address` or `http.request.header.host` instead, depending on the usage. | `www.example.org` | 
Replaced by one of `server.address`, `client.address` or `http.request.header.host`, depending on the usage. |
-| `http.method` | string | Deprecated, use `http.request.method` instead. | `GET`; `POST`; `HEAD` | 
Replaced by `http.request.method`. |
-| `http.request_content_length` | int | Deprecated, use `http.request.header.` instead. | `3495` | 
Replaced by `http.request.header.`. |
-| `http.request_content_length_uncompressed` | int | Deprecated, use `http.request.body.size` instead. | `5493` | 
Replaced by `http.request.body.size`. |
-| `http.response_content_length` | int | Deprecated, use `http.response.header.` instead. | `3495` | 
Replaced by `http.response.header.`. |
-| `http.response_content_length_uncompressed` | int | Deprecated, use `http.response.body.size` instead. | `5493` | 
Replace by `http.response.body.size`. |
-| `http.scheme` | string | Deprecated, use `url.scheme` instead. | `http`; `https` | 
Replaced by `url.scheme` instead. |
-| `http.server_name` | string | Deprecated, use `server.address` instead. | `example.com` | 
Replaced by `server.address`. |
-| `http.status_code` | int | Deprecated, use `http.response.status_code` instead. | `200` | 
Replaced by `http.response.status_code`. |
-| `http.target` | string | Deprecated, use `url.path` and `url.query` instead. | `/search?q=OpenTelemetry#SemConv` | 
Split to `url.path` and `url.query. |
-| `http.url` | string | Deprecated, use `url.full` instead. | `https://www.foo.bar/search?q=OpenTelemetry#SemConv` | 
Replaced by `url.full`. |
-| `http.user_agent` | string | Deprecated, use `user_agent.original` instead. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1` | 
Replaced by `user_agent.original`. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `http.client_ip` | string | Deprecated, use `client.address` instead. | `83.164.160.102` | 
Replaced by `client.address`. |
+| `http.flavor` | string | Deprecated, use `network.protocol.name` instead. | `1.0`; `1.1`; `2.0` | 
Replaced by `network.protocol.name`. |
+| `http.host` | string | Deprecated, use one of `server.address`, `client.address` or `http.request.header.host` instead, depending on the usage. | `www.example.org` | 
Replaced by one of `server.address`, `client.address` or `http.request.header.host`, depending on the usage. |
+| `http.method` | string | Deprecated, use `http.request.method` instead. | `GET`; `POST`; `HEAD` | 
Replaced by `http.request.method`. |
+| `http.request_content_length` | int | Deprecated, use `http.request.header.` instead. | `3495` | 
Replaced by `http.request.header.`. |
+| `http.request_content_length_uncompressed` | int | Deprecated, use `http.request.body.size` instead. | `5493` | 
Replaced by `http.request.body.size`. |
+| `http.response_content_length` | int | Deprecated, use `http.response.header.` instead. | `3495` | 
Replaced by `http.response.header.`. |
+| `http.response_content_length_uncompressed` | int | Deprecated, use `http.response.body.size` instead. | `5493` | 
Replace by `http.response.body.size`. |
+| `http.scheme` | string | Deprecated, use `url.scheme` instead. | `http`; `https` | 
Replaced by `url.scheme` instead. |
+| `http.server_name` | string | Deprecated, use `server.address` instead. | `example.com` | 
Replaced by `server.address`. |
+| `http.status_code` | int | Deprecated, use `http.response.status_code` instead. | `200` | 
Replaced by `http.response.status_code`. |
+| `http.target` | string | Deprecated, use `url.path` and `url.query` instead. | `/search?q=OpenTelemetry#SemConv` | 
Split to `url.path` and `url.query. |
+| `http.url` | string | Deprecated, use `url.full` instead. | `https://www.foo.bar/search?q=OpenTelemetry#SemConv` | 
Replaced by `url.full`. |
+| `http.user_agent` | string | Deprecated, use `user_agent.original` instead. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1` | 
Replaced by `user_agent.original`. |
`http.flavor` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | -------------- | ---------------------------------------------------------------- |
-| `1.0` | HTTP/1.0 |  |
-| `1.1` | HTTP/1.1 |  |
-| `2.0` | HTTP/2 |  |
-| `3.0` | HTTP/3 |  |
+| Value | Description | Stability |
+|---|---|---|
+| `1.0` | HTTP/1.0 |  |
+| `1.1` | HTTP/1.1 |  |
+| `2.0` | HTTP/2 |  |
+| `3.0` | HTTP/3 |  |
| `QUIC` | QUIC protocol. |  |
| `SPDY` | SPDY protocol. |  |
diff --git a/docs/attributes-registry/ios.md b/docs/attributes-registry/ios.md
index a8dc68b90f..a847e932eb 100644
--- a/docs/attributes-registry/ios.md
+++ b/docs/attributes-registry/ios.md
@@ -10,18 +10,18 @@
The iOS platform on which the iOS application is running.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `ios.state` | string | Deprecated use the `device.app.lifecycle` event definition including `ios.state` as a payload field instead. [1] | `active`; `inactive`; `background` | 
Moved to a payload field of `device.app.lifecycle`. |
**[1]:** The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate#1656902), and from which the `OS terminology` column values are derived.
`ios.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------ | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `active` | The app has become `active`. Associated with UIKit notification `applicationDidBecomeActive`. |  |
-| `background` | The app is now in the background. This value is associated with UIKit notification `applicationDidEnterBackground`. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `active` | The app has become `active`. Associated with UIKit notification `applicationDidBecomeActive`. |  |
+| `background` | The app is now in the background. This value is associated with UIKit notification `applicationDidEnterBackground`. |  |
| `foreground` | The app is now in the foreground. This value is associated with UIKit notification `applicationWillEnterForeground`. |  |
-| `inactive` | The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. |  |
-| `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. |  |
+| `inactive` | The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. |  |
+| `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. |  |
diff --git a/docs/attributes-registry/jvm.md b/docs/attributes-registry/jvm.md
index 67d9426004..8a3d4e459c 100644
--- a/docs/attributes-registry/jvm.md
+++ b/docs/attributes-registry/jvm.md
@@ -10,38 +10,38 @@
This document defines Java Virtual machine related attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | ------- | ----------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------- |
-| `jvm.buffer.pool.name` | string | Name of the buffer pool. [1] | `mapped`; `direct` |  |
-| `jvm.gc.action` | string | Name of the garbage collector action. [2] | `end of minor GC`; `end of major GC` |  |
-| `jvm.gc.name` | string | Name of the garbage collector. [3] | `G1 Young Generation`; `G1 Old Generation` |  |
-| `jvm.memory.pool.name` | string | Name of the memory pool. [4] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` |  |
-| `jvm.memory.type` | string | The type of memory. | `heap`; `non_heap` |  |
-| `jvm.thread.daemon` | boolean | Whether the thread is daemon or not. | |  |
-| `jvm.thread.state` | string | State of the thread. | `runnable`; `blocked` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `jvm.buffer.pool.name` | string | Name of the buffer pool. [1] | `mapped`; `direct` |  |
+| `jvm.gc.action` | string | Name of the garbage collector action. [2] | `end of minor GC`; `end of major GC` |  |
+| `jvm.gc.name` | string | Name of the garbage collector. [3] | `G1 Young Generation`; `G1 Old Generation` |  |
+| `jvm.memory.pool.name` | string | Name of the memory pool. [4] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` |  |
+| `jvm.memory.type` | string | The type of memory. | `heap`; `non_heap` |  |
+| `jvm.thread.daemon` | boolean | Whether the thread is daemon or not. | |  |
+| `jvm.thread.state` | string | State of the thread. | `runnable`; `blocked` |  |
-**[1]:** Pool names are generally obtained via [BufferPoolMXBean#getName()]().
+**[1]:** Pool names are generally obtained via [BufferPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/BufferPoolMXBean.html#getName()).
-**[2]:** Garbage collector action is generally obtained via [GarbageCollectionNotificationInfo#getGcAction()]().
+**[2]:** Garbage collector action is generally obtained via [GarbageCollectionNotificationInfo#getGcAction()](https://docs.oracle.com/en/java/javase/11/docs/api/jdk.management/com/sun/management/GarbageCollectionNotificationInfo.html#getGcAction()).
-**[3]:** Garbage collector name is generally obtained via [GarbageCollectionNotificationInfo#getGcName()]().
+**[3]:** Garbage collector name is generally obtained via [GarbageCollectionNotificationInfo#getGcName()](https://docs.oracle.com/en/java/javase/11/docs/api/jdk.management/com/sun/management/GarbageCollectionNotificationInfo.html#getGcName()).
-**[4]:** Pool names are generally obtained via [MemoryPoolMXBean#getName()]().
+**[4]:** Pool names are generally obtained via [MemoryPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/MemoryPoolMXBean.html#getName()).
`jvm.memory.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------- | --------------- | ---------------------------------------------------------- |
-| `heap` | Heap memory. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `heap` | Heap memory. |  |
| `non_heap` | Non-heap memory |  |
`jvm.thread.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
-| `blocked` | A thread that is blocked waiting for a monitor lock is in this state. |  |
-| `new` | A thread that has not yet started is in this state. |  |
-| `runnable` | A thread executing in the Java virtual machine is in this state. |  |
-| `terminated` | A thread that has exited is in this state. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `blocked` | A thread that is blocked waiting for a monitor lock is in this state. |  |
+| `new` | A thread that has not yet started is in this state. |  |
+| `runnable` | A thread executing in the Java virtual machine is in this state. |  |
+| `terminated` | A thread that has exited is in this state. |  |
| `timed_waiting` | A thread that is waiting for another thread to perform an action for up to a specified waiting time is in this state. |  |
-| `waiting` | A thread that is waiting indefinitely for another thread to perform a particular action is in this state. |  |
+| `waiting` | A thread that is waiting indefinitely for another thread to perform a particular action is in this state. |  |
diff --git a/docs/attributes-registry/k8s.md b/docs/attributes-registry/k8s.md
index a1e1a093e7..dcda4ed00a 100644
--- a/docs/attributes-registry/k8s.md
+++ b/docs/attributes-registry/k8s.md
@@ -13,34 +13,34 @@
Kubernetes resource attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `k8s.cluster.name` | string | The name of the cluster. | `opentelemetry-cluster` |  |
-| `k8s.cluster.uid` | string | A pseudo-ID for the cluster, set to the UID of the `kube-system` namespace. [1] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
-| `k8s.container.name` | string | The name of the Container from Pod specification, must be unique within a Pod. Container runtime usually uses different globally unique name (`container.name`). | `redis` |  |
-| `k8s.container.restart_count` | int | Number of times the container was restarted. This attribute can be used to identify a particular container (running or stopped) within a container spec. | |  |
-| `k8s.container.status.last_terminated_reason` | string | Last terminated reason of the Container. | `Evicted`; `Error` |  |
-| `k8s.cronjob.name` | string | The name of the CronJob. | `opentelemetry` |  |
-| `k8s.cronjob.uid` | string | The UID of the CronJob. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
-| `k8s.daemonset.name` | string | The name of the DaemonSet. | `opentelemetry` |  |
-| `k8s.daemonset.uid` | string | The UID of the DaemonSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
-| `k8s.deployment.name` | string | The name of the Deployment. | `opentelemetry` |  |
-| `k8s.deployment.uid` | string | The UID of the Deployment. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
-| `k8s.job.name` | string | The name of the Job. | `opentelemetry` |  |
-| `k8s.job.uid` | string | The UID of the Job. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
-| `k8s.namespace.name` | string | The name of the namespace that the pod is running in. | `default` |  |
-| `k8s.node.name` | string | The name of the Node. | `node-1` |  |
-| `k8s.node.uid` | string | The UID of the Node. | `1eb3a0c6-0477-4080-a9cb-0cb7db65c6a2` |  |
-| `k8s.pod.annotation.` | string | The annotation key-value pairs placed on the Pod, the `` being the annotation name, the value being the annotation value. | `k8s.pod.annotation.kubernetes.io/enforce-mountable-secrets=true`; `k8s.pod.annotation.mycompany.io/arch=x64`; `k8s.pod.annotation.data=` |  |
-| `k8s.pod.label.` | string | The label key-value pairs placed on the Pod, the `` being the label name, the value being the label value. | `k8s.pod.label.app=my-app`; `k8s.pod.label.mycompany.io/arch=x64`; `k8s.pod.label.data=` |  |
-| `k8s.pod.name` | string | The name of the Pod. | `opentelemetry-pod-autoconf` |  |
-| `k8s.pod.uid` | string | The UID of the Pod. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
-| `k8s.replicaset.name` | string | The name of the ReplicaSet. | `opentelemetry` |  |
-| `k8s.replicaset.uid` | string | The UID of the ReplicaSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
-| `k8s.statefulset.name` | string | The name of the StatefulSet. | `opentelemetry` |  |
-| `k8s.statefulset.uid` | string | The UID of the StatefulSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
-| `k8s.volume.name` | string | The name of the K8s volume. | `volume0` |  |
-| `k8s.volume.type` | string | The type of the K8s volume. | `emptyDir`; `persistentVolumeClaim` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `k8s.cluster.name` | string | The name of the cluster. | `opentelemetry-cluster` |  |
+| `k8s.cluster.uid` | string | A pseudo-ID for the cluster, set to the UID of the `kube-system` namespace. [1] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
+| `k8s.container.name` | string | The name of the Container from Pod specification, must be unique within a Pod. Container runtime usually uses different globally unique name (`container.name`). | `redis` |  |
+| `k8s.container.restart_count` | int | Number of times the container was restarted. This attribute can be used to identify a particular container (running or stopped) within a container spec. | |  |
+| `k8s.container.status.last_terminated_reason` | string | Last terminated reason of the Container. | `Evicted`; `Error` |  |
+| `k8s.cronjob.name` | string | The name of the CronJob. | `opentelemetry` |  |
+| `k8s.cronjob.uid` | string | The UID of the CronJob. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.daemonset.name` | string | The name of the DaemonSet. | `opentelemetry` |  |
+| `k8s.daemonset.uid` | string | The UID of the DaemonSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.deployment.name` | string | The name of the Deployment. | `opentelemetry` |  |
+| `k8s.deployment.uid` | string | The UID of the Deployment. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.job.name` | string | The name of the Job. | `opentelemetry` |  |
+| `k8s.job.uid` | string | The UID of the Job. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.namespace.name` | string | The name of the namespace that the pod is running in. | `default` |  |
+| `k8s.node.name` | string | The name of the Node. | `node-1` |  |
+| `k8s.node.uid` | string | The UID of the Node. | `1eb3a0c6-0477-4080-a9cb-0cb7db65c6a2` |  |
+| `k8s.pod.annotation.` | string | The annotation key-value pairs placed on the Pod, the `` being the annotation name, the value being the annotation value. | `k8s.pod.annotation.kubernetes.io/enforce-mountable-secrets=true`; `k8s.pod.annotation.mycompany.io/arch=x64`; `k8s.pod.annotation.data=` |  |
+| `k8s.pod.label.` | string | The label key-value pairs placed on the Pod, the `` being the label name, the value being the label value. | `k8s.pod.label.app=my-app`; `k8s.pod.label.mycompany.io/arch=x64`; `k8s.pod.label.data=` |  |
+| `k8s.pod.name` | string | The name of the Pod. | `opentelemetry-pod-autoconf` |  |
+| `k8s.pod.uid` | string | The UID of the Pod. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.replicaset.name` | string | The name of the ReplicaSet. | `opentelemetry` |  |
+| `k8s.replicaset.uid` | string | The UID of the ReplicaSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.statefulset.name` | string | The name of the StatefulSet. | `opentelemetry` |  |
+| `k8s.statefulset.uid` | string | The UID of the StatefulSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.volume.name` | string | The name of the K8s volume. | `volume0` |  |
+| `k8s.volume.type` | string | The type of the K8s volume. | `emptyDir`; `persistentVolumeClaim` |  |
**[1]:** K8s doesn't have support for obtaining a cluster ID. If this is ever
added, we will recommend collecting the `k8s.cluster.uid` through the
@@ -67,19 +67,19 @@ conflict.
`k8s.volume.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `configMap` | A [configMap](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#configmap) volume |  |
-| `downwardAPI` | A [downwardAPI](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#downwardapi) volume |  |
-| `emptyDir` | An [emptyDir](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#emptydir) volume |  |
-| `local` | A [local](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#local) volume |  |
+| Value | Description | Stability |
+|---|---|---|
+| `configMap` | A [configMap](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#configmap) volume |  |
+| `downwardAPI` | A [downwardAPI](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#downwardapi) volume |  |
+| `emptyDir` | An [emptyDir](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#emptydir) volume |  |
+| `local` | A [local](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#local) volume |  |
| `persistentVolumeClaim` | A [persistentVolumeClaim](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#persistentvolumeclaim) volume |  |
-| `secret` | A [secret](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#secret) volume |  |
+| `secret` | A [secret](https://v1-29.docs.kubernetes.io/docs/concepts/storage/volumes/#secret) volume |  |
## Deprecated Kubernetes Attributes
Describes deprecated k8s attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------ | ------ | ---------------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `k8s.pod.labels.` | string | Deprecated, use `k8s.pod.label` instead. | `k8s.pod.label.app=my-app` | 
Replaced by `k8s.pod.label`. |
diff --git a/docs/attributes-registry/linux.md b/docs/attributes-registry/linux.md
index 63c01d4e58..82c90fe1fb 100644
--- a/docs/attributes-registry/linux.md
+++ b/docs/attributes-registry/linux.md
@@ -10,13 +10,13 @@
Describes Linux Memory attributes
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------- | ------ | --------------------------- | ------------------------------ | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `linux.memory.slab.state` | string | The Linux Slab memory state | `reclaimable`; `unreclaimable` |  |
`linux.memory.slab.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------------- | ------------- | ---------------------------------------------------------------- |
-| `reclaimable` | reclaimable |  |
+| Value | Description | Stability |
+|---|---|---|
+| `reclaimable` | reclaimable |  |
| `unreclaimable` | unreclaimable |  |
diff --git a/docs/attributes-registry/log.md b/docs/attributes-registry/log.md
index 57460abe61..5371589ccf 100644
--- a/docs/attributes-registry/log.md
+++ b/docs/attributes-registry/log.md
@@ -14,36 +14,36 @@
This document defines log attributes
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------ | ------------------ | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `log.iostream` | string | The stream associated with the log. See below for a list of well-known values. | `stdout`; `stderr` |  |
`log.iostream` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ------------------------- | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `stderr` | Events from stderr stream |  |
-| `stdout` | Logs from stdout stream |  |
+| `stdout` | Logs from stdout stream |  |
## Log File Attributes
Attributes for a file to which log was emitted.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------ | ------ | -------------------------------------------------- | -------------------------- | ---------------------------------------------------------------- |
-| `log.file.name` | string | The basename of the file. | `audit.log` |  |
-| `log.file.name_resolved` | string | The basename of the file, with symlinks resolved. | `uuid.log` |  |
-| `log.file.path` | string | The full path to the file. | `/var/log/mysql/audit.log` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `log.file.name` | string | The basename of the file. | `audit.log` |  |
+| `log.file.name_resolved` | string | The basename of the file, with symlinks resolved. | `uuid.log` |  |
+| `log.file.path` | string | The full path to the file. | `/var/log/mysql/audit.log` |  |
| `log.file.path_resolved` | string | The full path to the file, with symlinks resolved. | `/var/lib/docker/uuid.log` |  |
## Log Record Attributes
This document defines the generic attributes that may be used in any Log Record.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `log.record.original` | string | The complete original Log Record. [1] | `77 <86>1 2015-08-06T21:58:59.694Z 192.168.2.133 inactive - - - Something happened`; `[INFO] 8/3/24 12:34:56 Something happened` |  |
-| `log.record.uid` | string | A unique identifier for the Log Record. [2] | `01ARZ3NDEKTSV4RRFFQ69G5FAV` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `log.record.original` | string | The complete original Log Record. [1] | `77 <86>1 2015-08-06T21:58:59.694Z 192.168.2.133 inactive - - - Something happened`; `[INFO] 8/3/24 12:34:56 Something happened` |  |
+| `log.record.uid` | string | A unique identifier for the Log Record. [2] | `01ARZ3NDEKTSV4RRFFQ69G5FAV` |  |
**[1]:** This value MAY be added when processing a Log Record which was originally transmitted as a string or equivalent data type AND the Body field of the Log Record does not contain the same value. (e.g. a syslog or a log record read from a file.)
diff --git a/docs/attributes-registry/messaging.md b/docs/attributes-registry/messaging.md
index 590529c609..f199868334 100644
--- a/docs/attributes-registry/messaging.md
+++ b/docs/attributes-registry/messaging.md
@@ -19,24 +19,24 @@
Attributes describing telemetry around messaging systems and messaging activities.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | ---------------------------------------------------------------- |
-| `messaging.batch.message_count` | int | The number of messages sent, received, or processed in the scope of the batching operation. [1] | `0`; `1`; `2` |  |
-| `messaging.client.id` | string | A unique identifier for the client that consumes or produces a message. | `client-5`; `myhost@8742@s8083jm` |  |
-| `messaging.consumer.group.name` | string | The name of the consumer group with which a consumer is associated. [2] | `my-group`; `indexer` |  |
-| `messaging.destination.anonymous` | boolean | A boolean that is true if the message destination is anonymous (could be unnamed or have auto-generated name). | |  |
-| `messaging.destination.name` | string | The message destination name [3] | `MyQueue`; `MyTopic` |  |
-| `messaging.destination.partition.id` | string | The identifier of the partition messages are sent to or received from, unique within the `messaging.destination.name`. | `1` |  |
-| `messaging.destination.subscription.name` | string | The name of the destination subscription from which a message is consumed. [4] | `subscription-a` |  |
-| `messaging.destination.template` | string | Low cardinality representation of the messaging destination name [5] | `/customers/{customerId}` |  |
-| `messaging.destination.temporary` | boolean | A boolean that is true if the message destination is temporary and might not exist anymore after messages are processed. | |  |
-| `messaging.message.body.size` | int | The size of the message body in bytes. [6] | `1439` |  |
-| `messaging.message.conversation_id` | string | The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called "Correlation ID". | `MyConversationId` |  |
-| `messaging.message.envelope.size` | int | The size of the message body and metadata in bytes. [7] | `2738` |  |
-| `messaging.message.id` | string | A value used by the messaging system as an identifier for the message, represented as a string. | `452a7c7c7c7048c2f887f61572b18fc2` |  |
-| `messaging.operation.name` | string | The system-specific name of the messaging operation. | `ack`; `nack`; `send` |  |
-| `messaging.operation.type` | string | A string identifying the type of the messaging operation. [8] | `create`; `send`; `receive` |  |
-| `messaging.system` | string | The messaging system as identified by the client instrumentation. [9] | `activemq`; `aws_sqs`; `eventgrid` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.batch.message_count` | int | The number of messages sent, received, or processed in the scope of the batching operation. [1] | `0`; `1`; `2` |  |
+| `messaging.client.id` | string | A unique identifier for the client that consumes or produces a message. | `client-5`; `myhost@8742@s8083jm` |  |
+| `messaging.consumer.group.name` | string | The name of the consumer group with which a consumer is associated. [2] | `my-group`; `indexer` |  |
+| `messaging.destination.anonymous` | boolean | A boolean that is true if the message destination is anonymous (could be unnamed or have auto-generated name). | |  |
+| `messaging.destination.name` | string | The message destination name [3] | `MyQueue`; `MyTopic` |  |
+| `messaging.destination.partition.id` | string | The identifier of the partition messages are sent to or received from, unique within the `messaging.destination.name`. | `1` |  |
+| `messaging.destination.subscription.name` | string | The name of the destination subscription from which a message is consumed. [4] | `subscription-a` |  |
+| `messaging.destination.template` | string | Low cardinality representation of the messaging destination name [5] | `/customers/{customerId}` |  |
+| `messaging.destination.temporary` | boolean | A boolean that is true if the message destination is temporary and might not exist anymore after messages are processed. | |  |
+| `messaging.message.body.size` | int | The size of the message body in bytes. [6] | `1439` |  |
+| `messaging.message.conversation_id` | string | The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called "Correlation ID". | `MyConversationId` |  |
+| `messaging.message.envelope.size` | int | The size of the message body and metadata in bytes. [7] | `2738` |  |
+| `messaging.message.id` | string | A value used by the messaging system as an identifier for the message, represented as a string. | `452a7c7c7c7048c2f887f61572b18fc2` |  |
+| `messaging.operation.name` | string | The system-specific name of the messaging operation. | `ack`; `nack`; `send` |  |
+| `messaging.operation.type` | string | A string identifying the type of the messaging operation. [8] | `create`; `send`; `receive` |  |
+| `messaging.system` | string | The messaging system as identified by the client instrumentation. [9] | `activemq`; `aws_sqs`; `eventgrid` |  |
**[1]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
@@ -61,60 +61,60 @@ size should be used.
`messaging.operation.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
-| `create` | A message is created. "Create" spans always refer to a single message and are used to provide a unique creation context for messages in batch sending scenarios. |  |
-| `deliver` | Deprecated. Use `process` instead. | 
Replaced by `process`. |
-| `process` | One or more messages are processed by a consumer. |  |
-| `publish` | Deprecated. Use `send` instead. | 
Replaced by `send`. |
-| `receive` | One or more messages are requested by a consumer. This operation refers to pull-based scenarios, where consumers explicitly call methods of messaging SDKs to receive messages. |  |
-| `send` | One or more messages are provided for sending to an intermediary. If a single message is sent, the context of the "Send" span can be used as the creation context and no "Create" span needs to be created. |  |
-| `settle` | One or more messages are settled. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `create` | A message is created. "Create" spans always refer to a single message and are used to provide a unique creation context for messages in batch sending scenarios. |  |
+| `deliver` | Deprecated. Use `process` instead. | 
Replaced by `process`. |
+| `process` | One or more messages are processed by a consumer. |  |
+| `publish` | Deprecated. Use `send` instead. | 
Replaced by `send`. |
+| `receive` | One or more messages are requested by a consumer. This operation refers to pull-based scenarios, where consumers explicitly call methods of messaging SDKs to receive messages. |  |
+| `send` | One or more messages are provided for sending to an intermediary. If a single message is sent, the context of the "Send" span can be used as the creation context and no "Create" span needs to be created. |  |
+| `settle` | One or more messages are settled. |  |
`messaging.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------ | --------------------------------- | ---------------------------------------------------------------- |
-| `activemq` | Apache ActiveMQ |  |
-| `aws_sqs` | Amazon Simple Queue Service (SQS) |  |
-| `eventgrid` | Azure Event Grid |  |
-| `eventhubs` | Azure Event Hubs |  |
-| `gcp_pubsub` | Google Cloud Pub/Sub |  |
-| `jms` | Java Message Service |  |
-| `kafka` | Apache Kafka |  |
-| `pulsar` | Apache Pulsar |  |
-| `rabbitmq` | RabbitMQ |  |
-| `rocketmq` | Apache RocketMQ |  |
-| `servicebus` | Azure Service Bus |  |
+| Value | Description | Stability |
+|---|---|---|
+| `activemq` | Apache ActiveMQ |  |
+| `aws_sqs` | Amazon Simple Queue Service (SQS) |  |
+| `eventgrid` | Azure Event Grid |  |
+| `eventhubs` | Azure Event Hubs |  |
+| `gcp_pubsub` | Google Cloud Pub/Sub |  |
+| `jms` | Java Message Service |  |
+| `kafka` | Apache Kafka |  |
+| `pulsar` | Apache Pulsar |  |
+| `rabbitmq` | RabbitMQ |  |
+| `rocketmq` | Apache RocketMQ |  |
+| `servicebus` | Azure Service Bus |  |
## Azure Event Hubs Attributes
This group describes attributes specific to Azure Event Hubs.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | -------------------------------------------------------------------------------------- | ------------ | ---------------------------------------------------------------- |
-| `messaging.eventhubs.message.enqueued_time` | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.eventhubs.message.enqueued_time` | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` |  |
## GCP Pub/Sub Attributes
This group describes attributes specific to GCP Pub/Sub.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------- | -------------- | ---------------------------------------------------------------- |
-| `messaging.gcp_pubsub.message.ack_deadline` | int | The ack deadline in seconds set for the modify ack deadline request. | `10` |  |
-| `messaging.gcp_pubsub.message.ack_id` | string | The ack id for a given message. | `ack_id` |  |
-| `messaging.gcp_pubsub.message.delivery_attempt` | int | The delivery attempt for a given message. | `2` |  |
-| `messaging.gcp_pubsub.message.ordering_key` | string | The ordering key for a given message. If the attribute is not present, the message does not have an ordering key. | `ordering_key` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.gcp_pubsub.message.ack_deadline` | int | The ack deadline in seconds set for the modify ack deadline request. | `10` |  |
+| `messaging.gcp_pubsub.message.ack_id` | string | The ack id for a given message. | `ack_id` |  |
+| `messaging.gcp_pubsub.message.delivery_attempt` | int | The delivery attempt for a given message. | `2` |  |
+| `messaging.gcp_pubsub.message.ordering_key` | string | The ordering key for a given message. If the attribute is not present, the message does not have an ordering key. | `ordering_key` |  |
## Kafka Attributes
This group describes attributes specific to Apache Kafka.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------------------------------------------------------------- |
-| `messaging.kafka.message.key` | string | Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set. [10] | `myKey` |  |
-| `messaging.kafka.message.tombstone` | boolean | A boolean that is true if the message is a tombstone. | |  |
-| `messaging.kafka.offset` | int | The offset of a record in the corresponding Kafka partition. | `42` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.kafka.message.key` | string | Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set. [10] | `myKey` |  |
+| `messaging.kafka.message.tombstone` | boolean | A boolean that is true if the message is a tombstone. | |  |
+| `messaging.kafka.offset` | int | The offset of a record in the corresponding Kafka partition. | `42` |  |
**[10]:** If the key type is not string, it's string representation has to be supplied for the attribute. If the key has no unambiguous, canonical string form, don't include its value.
@@ -122,74 +122,74 @@ This group describes attributes specific to Apache Kafka.
This group describes attributes specific to RabbitMQ.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ----------------------------- | -------- | ---------------------------------------------------------------- |
-| `messaging.rabbitmq.destination.routing_key` | string | RabbitMQ message routing key. | `myKey` |  |
-| `messaging.rabbitmq.message.delivery_tag` | int | RabbitMQ message delivery tag | `123` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.rabbitmq.destination.routing_key` | string | RabbitMQ message routing key. | `myKey` |  |
+| `messaging.rabbitmq.message.delivery_tag` | int | RabbitMQ message delivery tag | `123` |  |
## RocketMQ Attributes
This group describes attributes specific to RocketMQ.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | ---------------------------------------------------------------- |
-| `messaging.rocketmq.consumption_model` | string | Model of message consumption. This only applies to consumer spans. | `clustering`; `broadcasting` |  |
-| `messaging.rocketmq.message.delay_time_level` | int | The delay time level for delay message, which determines the message delay time. | `3` |  |
-| `messaging.rocketmq.message.delivery_timestamp` | int | The timestamp in milliseconds that the delay message is expected to be delivered to consumer. | `1665987217045` |  |
-| `messaging.rocketmq.message.group` | string | It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group. | `myMessageGroup` |  |
-| `messaging.rocketmq.message.keys` | string[] | Key(s) of message, another way to mark message besides message id. | `["keyA", "keyB"]` |  |
-| `messaging.rocketmq.message.tag` | string | The secondary classifier of message besides topic. | `tagA` |  |
-| `messaging.rocketmq.message.type` | string | Type of message. | `normal`; `fifo`; `delay` |  |
-| `messaging.rocketmq.namespace` | string | Namespace of RocketMQ resources, resources in different namespaces are individual. | `myNamespace` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.rocketmq.consumption_model` | string | Model of message consumption. This only applies to consumer spans. | `clustering`; `broadcasting` |  |
+| `messaging.rocketmq.message.delay_time_level` | int | The delay time level for delay message, which determines the message delay time. | `3` |  |
+| `messaging.rocketmq.message.delivery_timestamp` | int | The timestamp in milliseconds that the delay message is expected to be delivered to consumer. | `1665987217045` |  |
+| `messaging.rocketmq.message.group` | string | It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group. | `myMessageGroup` |  |
+| `messaging.rocketmq.message.keys` | string[] | Key(s) of message, another way to mark message besides message id. | `["keyA", "keyB"]` |  |
+| `messaging.rocketmq.message.tag` | string | The secondary classifier of message besides topic. | `tagA` |  |
+| `messaging.rocketmq.message.type` | string | Type of message. | `normal`; `fifo`; `delay` |  |
+| `messaging.rocketmq.namespace` | string | Namespace of RocketMQ resources, resources in different namespaces are individual. | `myNamespace` |  |
`messaging.rocketmq.consumption_model` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------- | ------------------------------ | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `broadcasting` | Broadcasting consumption model |  |
-| `clustering` | Clustering consumption model |  |
+| `clustering` | Clustering consumption model |  |
`messaging.rocketmq.message.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------- | ------------------- | ---------------------------------------------------------------- |
-| `delay` | Delay message |  |
-| `fifo` | FIFO message |  |
-| `normal` | Normal message |  |
+| Value | Description | Stability |
+|---|---|---|
+| `delay` | Delay message |  |
+| `fifo` | FIFO message |  |
+| `normal` | Normal message |  |
| `transaction` | Transaction message |  |
## Azure Service Bus Attributes
This group describes attributes specific to Azure Service Bus.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ---------------------------------------------------------------- |
-| `messaging.servicebus.disposition_status` | string | Describes the [settlement type](https://learn.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock). | `complete`; `abandon`; `dead_letter` |  |
-| `messaging.servicebus.message.delivery_count` | int | Number of deliveries that have been attempted for this message. | `2` |  |
-| `messaging.servicebus.message.enqueued_time` | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.servicebus.disposition_status` | string | Describes the [settlement type](https://learn.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock). | `complete`; `abandon`; `dead_letter` |  |
+| `messaging.servicebus.message.delivery_count` | int | Number of deliveries that have been attempted for this message. | `2` |  |
+| `messaging.servicebus.message.enqueued_time` | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` |  |
`messaging.servicebus.disposition_status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------- | ------------------------------------ | ---------------------------------------------------------------- |
-| `abandon` | Message is abandoned |  |
-| `complete` | Message is completed |  |
+| Value | Description | Stability |
+|---|---|---|
+| `abandon` | Message is abandoned |  |
+| `complete` | Message is completed |  |
| `dead_letter` | Message is sent to dead letter queue |  |
-| `defer` | Message is deferred |  |
+| `defer` | Message is deferred |  |
## Deprecated Messaging Attributes
Describes deprecated messaging attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | ------------------------------------------------------------------ | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `messaging.client_id` | string | Deprecated, use `messaging.client.id` instead. | `client-5`; `myhost@8742@s8083jm` | 
Replaced by `messaging.client.id`. |
-| `messaging.destination_publish.anonymous` | boolean | Deprecated, no replacement at this time. | | 
No replacement at this time. |
-| `messaging.destination_publish.name` | string | Deprecated, no replacement at this time. | `MyQueue`; `MyTopic` | 
No replacement at this time. |
-| `messaging.eventhubs.consumer.group` | string | Deprecated, use `messaging.consumer.group.name` instead. | `$Default` | 
Replaced by `messaging.consumer.group.name`. |
-| `messaging.kafka.consumer.group` | string | Deprecated, use `messaging.consumer.group.name` instead. | `my-group` | 
Replaced by `messaging.consumer.group.name`. |
-| `messaging.kafka.destination.partition` | int | Deprecated, use `messaging.destination.partition.id` instead. | `2` | 
Replaced by `messaging.destination.partition.id`. |
-| `messaging.kafka.message.offset` | int | Deprecated, use `messaging.kafka.offset` instead. | `42` | 
Replaced by `messaging.kafka.offset`. |
-| `messaging.operation` | string | Deprecated, use `messaging.operation.type` instead. | `publish`; `create`; `process` | 
Replaced by `messaging.operation.type`. |
-| `messaging.rocketmq.client_group` | string | Deprecated, use `messaging.consumer.group.name` instead. | `myConsumerGroup` | 
Replaced by `messaging.consumer.group.name` on the consumer spans. No replacement for producer spans. |
-| `messaging.servicebus.destination.subscription_name` | string | Deprecated, use `messaging.destination.subscription.name` instead. | `subscription-a` | 
Replaced by `messaging.destination.subscription.name`. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.client_id` | string | Deprecated, use `messaging.client.id` instead. | `client-5`; `myhost@8742@s8083jm` | 
Replaced by `messaging.client.id`. |
+| `messaging.destination_publish.anonymous` | boolean | Deprecated, no replacement at this time. | | 
No replacement at this time. |
+| `messaging.destination_publish.name` | string | Deprecated, no replacement at this time. | `MyQueue`; `MyTopic` | 
No replacement at this time. |
+| `messaging.eventhubs.consumer.group` | string | Deprecated, use `messaging.consumer.group.name` instead. | `$Default` | 
Replaced by `messaging.consumer.group.name`. |
+| `messaging.kafka.consumer.group` | string | Deprecated, use `messaging.consumer.group.name` instead. | `my-group` | 
Replaced by `messaging.consumer.group.name`. |
+| `messaging.kafka.destination.partition` | int | Deprecated, use `messaging.destination.partition.id` instead. | `2` | 
Replaced by `messaging.destination.partition.id`. |
+| `messaging.kafka.message.offset` | int | Deprecated, use `messaging.kafka.offset` instead. | `42` | 
Replaced by `messaging.kafka.offset`. |
+| `messaging.operation` | string | Deprecated, use `messaging.operation.type` instead. | `publish`; `create`; `process` | 
Replaced by `messaging.operation.type`. |
+| `messaging.rocketmq.client_group` | string | Deprecated, use `messaging.consumer.group.name` instead. | `myConsumerGroup` | 
Replaced by `messaging.consumer.group.name` on the consumer spans. No replacement for producer spans. |
+| `messaging.servicebus.destination.subscription_name` | string | Deprecated, use `messaging.destination.subscription.name` instead. | `subscription-a` | 
Replaced by `messaging.destination.subscription.name`. |
diff --git a/docs/attributes-registry/network.md b/docs/attributes-registry/network.md
index c5984d4ca3..82256c0345 100644
--- a/docs/attributes-registry/network.md
+++ b/docs/attributes-registry/network.md
@@ -13,23 +13,23 @@
These attributes may be used for any network related operation.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------- |
-| `network.carrier.icc` | string | The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. | `DE` |  |
-| `network.carrier.mcc` | string | The mobile carrier country code. | `310` |  |
-| `network.carrier.mnc` | string | The mobile carrier network code. | `001` |  |
-| `network.carrier.name` | string | The name of the mobile carrier. | `sprint` |  |
-| `network.connection.subtype` | string | This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. | `LTE` |  |
-| `network.connection.type` | string | The internet connection type. | `wifi` |  |
-| `network.io.direction` | string | The network IO operation direction. | `transmit` |  |
-| `network.local.address` | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |  |
-| `network.local.port` | int | Local port number of the network connection. | `65123` |  |
-| `network.peer.address` | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |  |
-| `network.peer.port` | int | Peer port number of the network connection. | `65123` |  |
-| `network.protocol.name` | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `amqp`; `http`; `mqtt` |  |
-| `network.protocol.version` | string | The actual version of the protocol used for network communication. [2] | `1.1`; `2` |  |
-| `network.transport` | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` |  |
-| `network.type` | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `network.carrier.icc` | string | The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. | `DE` |  |
+| `network.carrier.mcc` | string | The mobile carrier country code. | `310` |  |
+| `network.carrier.mnc` | string | The mobile carrier network code. | `001` |  |
+| `network.carrier.name` | string | The name of the mobile carrier. | `sprint` |  |
+| `network.connection.subtype` | string | This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. | `LTE` |  |
+| `network.connection.type` | string | The internet connection type. | `wifi` |  |
+| `network.io.direction` | string | The network IO operation direction. | `transmit` |  |
+| `network.local.address` | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |  |
+| `network.local.port` | int | Local port number of the network connection. | `65123` |  |
+| `network.peer.address` | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |  |
+| `network.peer.port` | int | Peer port number of the network connection. | `65123` |  |
+| `network.protocol.name` | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `amqp`; `http`; `mqtt` |  |
+| `network.protocol.version` | string | The actual version of the protocol used for network communication. [2] | `1.1`; `2` |  |
+| `network.transport` | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` |  |
+| `network.type` | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -45,102 +45,102 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
`network.connection.subtype` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------------- | ----------------------------------- | ---------------------------------------------------------------- |
-| `cdma` | CDMA |  |
-| `cdma2000_1xrtt` | CDMA2000 1XRTT |  |
-| `edge` | EDGE |  |
-| `ehrpd` | EHRPD |  |
-| `evdo_0` | EVDO Rel. 0 |  |
-| `evdo_a` | EVDO Rev. A |  |
-| `evdo_b` | EVDO Rev. B |  |
-| `gprs` | GPRS |  |
-| `gsm` | GSM |  |
-| `hsdpa` | HSDPA |  |
-| `hspa` | HSPA |  |
-| `hspap` | HSPAP |  |
-| `hsupa` | HSUPA |  |
-| `iden` | IDEN |  |
-| `iwlan` | IWLAN |  |
-| `lte` | LTE |  |
-| `lte_ca` | LTE CA |  |
-| `nr` | 5G NR (New Radio) |  |
-| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |  |
-| `td_scdma` | TD-SCDMA |  |
-| `umts` | UMTS |  |
+| Value | Description | Stability |
+|---|---|---|
+| `cdma` | CDMA |  |
+| `cdma2000_1xrtt` | CDMA2000 1XRTT |  |
+| `edge` | EDGE |  |
+| `ehrpd` | EHRPD |  |
+| `evdo_0` | EVDO Rel. 0 |  |
+| `evdo_a` | EVDO Rev. A |  |
+| `evdo_b` | EVDO Rev. B |  |
+| `gprs` | GPRS |  |
+| `gsm` | GSM |  |
+| `hsdpa` | HSDPA |  |
+| `hspa` | HSPA |  |
+| `hspap` | HSPAP |  |
+| `hsupa` | HSUPA |  |
+| `iden` | IDEN |  |
+| `iwlan` | IWLAN |  |
+| `lte` | LTE |  |
+| `lte_ca` | LTE CA |  |
+| `nr` | 5G NR (New Radio) |  |
+| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |  |
+| `td_scdma` | TD-SCDMA |  |
+| `umts` | UMTS |  |
`network.connection.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------- | ----------- | ---------------------------------------------------------------- |
-| `cell` | cell |  |
+| Value | Description | Stability |
+|---|---|---|
+| `cell` | cell |  |
| `unavailable` | unavailable |  |
-| `unknown` | unknown |  |
-| `wifi` | wifi |  |
-| `wired` | wired |  |
+| `unknown` | unknown |  |
+| `wifi` | wifi |  |
+| `wired` | wired |  |
`network.io.direction` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------- | ----------- | ---------------------------------------------------------------- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| Value | Description | Stability |
+|---|---|---|
+| `receive` | receive |  |
+| `transmit` | transmit |  |
`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | ------------------------ | ---------------------------------------------------------------- |
-| `pipe` | Named or anonymous pipe. |  |
-| `quic` | QUIC |  |
-| `tcp` | TCP |  |
-| `udp` | UDP |  |
-| `unix` | Unix domain socket |  |
+| Value | Description | Stability |
+|---|---|---|
+| `pipe` | Named or anonymous pipe. |  |
+| `quic` | QUIC |  |
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `unix` | Unix domain socket |  |
`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | ----------- | ---------------------------------------------------------- |
-| `ipv4` | IPv4 |  |
-| `ipv6` | IPv6 |  |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Deprecated Network Attributes
These attributes may be used for any network related operation.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | ------ | -------------------------------------------------------------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `net.host.ip` | string | Deprecated, use `network.local.address`. | `192.168.0.1` | 
Replaced by `network.local.address`. |
-| `net.host.name` | string | Deprecated, use `server.address`. | `example.com` | 
Replaced by `server.address`. |
-| `net.host.port` | int | Deprecated, use `server.port`. | `8080` | 
Replaced by `server.port`. |
-| `net.peer.ip` | string | Deprecated, use `network.peer.address`. | `127.0.0.1` | 
Replaced by `network.peer.address`. |
-| `net.peer.name` | string | Deprecated, use `server.address` on client spans and `client.address` on server spans. | `example.com` | 
Replaced by `server.address` on client spans and `client.address` on server spans. |
-| `net.peer.port` | int | Deprecated, use `server.port` on client spans and `client.port` on server spans. | `8080` | 
Replaced by `server.port` on client spans and `client.port` on server spans. |
-| `net.protocol.name` | string | Deprecated, use `network.protocol.name`. | `amqp`; `http`; `mqtt` | 
Replaced by `network.protocol.name`. |
-| `net.protocol.version` | string | Deprecated, use `network.protocol.version`. | `3.1.1` | 
Replaced by `network.protocol.version`. |
-| `net.sock.family` | string | Deprecated, use `network.transport` and `network.type`. | `inet`; `inet6`; `unix` | 
Split to `network.transport` and `network.type`. |
-| `net.sock.host.addr` | string | Deprecated, use `network.local.address`. | `/var/my.sock` | 
Replaced by `network.local.address`. |
-| `net.sock.host.port` | int | Deprecated, use `network.local.port`. | `8080` | 
Replaced by `network.local.port`. |
-| `net.sock.peer.addr` | string | Deprecated, use `network.peer.address`. | `192.168.0.1` | 
Replaced by `network.peer.address`. |
-| `net.sock.peer.name` | string | Deprecated, no replacement at this time. | `/var/my.sock` | 
Removed. |
-| `net.sock.peer.port` | int | Deprecated, use `network.peer.port`. | `65531` | 
Replaced by `network.peer.port`. |
-| `net.transport` | string | Deprecated, use `network.transport`. | `ip_tcp`; `ip_udp`; `pipe` | 
Replaced by `network.transport`. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `net.host.ip` | string | Deprecated, use `network.local.address`. | `192.168.0.1` | 
Replaced by `network.local.address`. |
+| `net.host.name` | string | Deprecated, use `server.address`. | `example.com` | 
Replaced by `server.address`. |
+| `net.host.port` | int | Deprecated, use `server.port`. | `8080` | 
Replaced by `server.port`. |
+| `net.peer.ip` | string | Deprecated, use `network.peer.address`. | `127.0.0.1` | 
Replaced by `network.peer.address`. |
+| `net.peer.name` | string | Deprecated, use `server.address` on client spans and `client.address` on server spans. | `example.com` | 
Replaced by `server.address` on client spans and `client.address` on server spans. |
+| `net.peer.port` | int | Deprecated, use `server.port` on client spans and `client.port` on server spans. | `8080` | 
Replaced by `server.port` on client spans and `client.port` on server spans. |
+| `net.protocol.name` | string | Deprecated, use `network.protocol.name`. | `amqp`; `http`; `mqtt` | 
Replaced by `network.protocol.name`. |
+| `net.protocol.version` | string | Deprecated, use `network.protocol.version`. | `3.1.1` | 
Replaced by `network.protocol.version`. |
+| `net.sock.family` | string | Deprecated, use `network.transport` and `network.type`. | `inet`; `inet6`; `unix` | 
Split to `network.transport` and `network.type`. |
+| `net.sock.host.addr` | string | Deprecated, use `network.local.address`. | `/var/my.sock` | 
Replaced by `network.local.address`. |
+| `net.sock.host.port` | int | Deprecated, use `network.local.port`. | `8080` | 
Replaced by `network.local.port`. |
+| `net.sock.peer.addr` | string | Deprecated, use `network.peer.address`. | `192.168.0.1` | 
Replaced by `network.peer.address`. |
+| `net.sock.peer.name` | string | Deprecated, no replacement at this time. | `/var/my.sock` | 
Removed. |
+| `net.sock.peer.port` | int | Deprecated, use `network.peer.port`. | `65531` | 
Replaced by `network.peer.port`. |
+| `net.transport` | string | Deprecated, use `network.transport`. | `ip_tcp`; `ip_udp`; `pipe` | 
Replaced by `network.transport`. |
`net.sock.family` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------- | ----------------------- | ---------------------------------------------------------------- |
-| `inet` | IPv4 address |  |
-| `inet6` | IPv6 address |  |
-| `unix` | Unix domain socket path |  |
+| Value | Description | Stability |
+|---|---|---|
+| `inet` | IPv4 address |  |
+| `inet6` | IPv6 address |  |
+| `unix` | Unix domain socket path |  |
`net.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ------------------------------ | ---------------------------------------------------------------- |
-| `inproc` | In-process communication. [5] |  |
-| `ip_tcp` | ip_tcp |  |
-| `ip_udp` | ip_udp |  |
-| `other` | Something else (non IP-based). |  |
-| `pipe` | Named or anonymous pipe. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `inproc` | In-process communication. [5] |  |
+| `ip_tcp` | ip_tcp |  |
+| `ip_udp` | ip_udp |  |
+| `other` | Something else (non IP-based). |  |
+| `pipe` | Named or anonymous pipe. |  |
**[5]:** Signals that there is only in-process communication not using a "real" network protocol in cases where network attributes would normally be expected. Usually all other network attributes can be left out in that case.
diff --git a/docs/attributes-registry/nodejs.md b/docs/attributes-registry/nodejs.md
index 62dadc5ee4..76cfd152e8 100644
--- a/docs/attributes-registry/nodejs.md
+++ b/docs/attributes-registry/nodejs.md
@@ -10,13 +10,13 @@
Describes Node.js related attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------ | ------ | ----------------------------- | ---------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `nodejs.eventloop.state` | string | The state of event loop time. | `active`; `idle` |  |
`nodejs.eventloop.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ------------ | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `active` | Active time. |  |
-| `idle` | Idle time. |  |
+| `idle` | Idle time. |  |
diff --git a/docs/attributes-registry/oci.md b/docs/attributes-registry/oci.md
index 843b2e68a2..5674fa08db 100644
--- a/docs/attributes-registry/oci.md
+++ b/docs/attributes-registry/oci.md
@@ -10,8 +10,8 @@
An OCI image manifest.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `oci.manifest.digest` | string | The digest of the OCI image manifest. For container images specifically is the digest by which the container image is known. [1] | `sha256:e4ca62c0d62f3e886e684806dfe9d4e0cda60d54986898173c1083856cfda0f4` |  |
**[1]:** Follows [OCI Image Manifest Specification](https://github.com/opencontainers/image-spec/blob/main/manifest.md), and specifically the [Digest property](https://github.com/opencontainers/image-spec/blob/main/descriptor.md#digests).
diff --git a/docs/attributes-registry/opentracing.md b/docs/attributes-registry/opentracing.md
index 91cfdc4437..ce73840fcd 100644
--- a/docs/attributes-registry/opentracing.md
+++ b/docs/attributes-registry/opentracing.md
@@ -10,15 +10,15 @@
Attributes used by the OpenTracing Shim layer.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | ------ | ------------------------------- | -------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `opentracing.ref_type` | string | Parent-child Reference type [1] | `child_of`; `follows_from` |  |
**[1]:** The causal relationship between a child Span and a parent Span.
`opentracing.ref_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `child_of` | The parent Span depends on the child Span in some capacity |  |
+| Value | Description | Stability |
+|---|---|---|
+| `child_of` | The parent Span depends on the child Span in some capacity |  |
| `follows_from` | The parent Span doesn't depend in any way on the result of the child Span |  |
diff --git a/docs/attributes-registry/os.md b/docs/attributes-registry/os.md
index 8ff113a3ea..9c1a841805 100644
--- a/docs/attributes-registry/os.md
+++ b/docs/attributes-registry/os.md
@@ -10,26 +10,26 @@
The operating system (OS) on which the process represented by this resource is running.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------- |
-| `os.build_id` | string | Unique identifier for a particular build or compilation of the operating system. | `TQ3C.230805.001.B2`; `20E247`; `22621` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `os.build_id` | string | Unique identifier for a particular build or compilation of the operating system. | `TQ3C.230805.001.B2`; `20E247`; `22621` |  |
| `os.description` | string | Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` |  |
-| `os.name` | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` |  |
-| `os.type` | string | The operating system type. | `windows`; `linux`; `darwin` |  |
-| `os.version` | string | The version string of the operating system as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `14.2.1`; `18.04.1` |  |
+| `os.name` | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` |  |
+| `os.type` | string | The operating system type. | `windows`; `linux`; `darwin` |  |
+| `os.version` | string | The version string of the operating system as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `14.2.1`; `18.04.1` |  |
`os.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------- | ------------------------------------ | ---------------------------------------------------------------- |
-| `aix` | AIX (Advanced Interactive eXecutive) |  |
-| `darwin` | Apple Darwin |  |
-| `dragonflybsd` | DragonFly BSD |  |
-| `freebsd` | FreeBSD |  |
-| `hpux` | HP-UX (Hewlett Packard Unix) |  |
-| `linux` | Linux |  |
-| `netbsd` | NetBSD |  |
-| `openbsd` | OpenBSD |  |
-| `solaris` | SunOS, Oracle Solaris |  |
-| `windows` | Microsoft Windows |  |
-| `z_os` | IBM z/OS |  |
+| Value | Description | Stability |
+|---|---|---|
+| `aix` | AIX (Advanced Interactive eXecutive) |  |
+| `darwin` | Apple Darwin |  |
+| `dragonflybsd` | DragonFly BSD |  |
+| `freebsd` | FreeBSD |  |
+| `hpux` | HP-UX (Hewlett Packard Unix) |  |
+| `linux` | Linux |  |
+| `netbsd` | NetBSD |  |
+| `openbsd` | OpenBSD |  |
+| `solaris` | SunOS, Oracle Solaris |  |
+| `windows` | Microsoft Windows |  |
+| `z_os` | IBM z/OS |  |
diff --git a/docs/attributes-registry/otel.md b/docs/attributes-registry/otel.md
index 0996cc7d8f..44076a1e63 100644
--- a/docs/attributes-registry/otel.md
+++ b/docs/attributes-registry/otel.md
@@ -14,32 +14,32 @@
Attributes reserved for OpenTelemetry
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------- | -------------------- | ---------------------------------------------------------- |
-| `otel.status_code` | string | Name of the code, either "OK" or "ERROR". MUST NOT be set if the status code is UNSET. | `OK`; `ERROR` |  |
-| `otel.status_description` | string | Description of the Status if it has a value, otherwise not set. | `resource not found` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `otel.status_code` | string | Name of the code, either "OK" or "ERROR". MUST NOT be set if the status code is UNSET. | `OK`; `ERROR` |  |
+| `otel.status_description` | string | Description of the Status if it has a value, otherwise not set. | `resource not found` |  |
`otel.status_code` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
-| `ERROR` | The operation contains an error. |  |
-| `OK` | The operation has been validated by an Application developer or Operator to have completed successfully. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `ERROR` | The operation contains an error. |  |
+| `OK` | The operation has been validated by an Application developer or Operator to have completed successfully. |  |
## OTel Scope Attributes
Attributes used by non-OTLP exporters to represent OpenTelemetry Scope's concepts.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------ | ---------------------------------- | ---------------------------------------------------------- |
-| `otel.scope.name` | string | The name of the instrumentation scope - (`InstrumentationScope.Name` in OTLP). | `io.opentelemetry.contrib.mongodb` |  |
-| `otel.scope.version` | string | The version of the instrumentation scope - (`InstrumentationScope.Version` in OTLP). | `1.0.0` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `otel.scope.name` | string | The name of the instrumentation scope - (`InstrumentationScope.Name` in OTLP). | `io.opentelemetry.contrib.mongodb` |  |
+| `otel.scope.version` | string | The version of the instrumentation scope - (`InstrumentationScope.Version` in OTLP). | `1.0.0` |  |
## Deprecated OTel Library Attributes
Describes deprecated otel.library attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | ------ | --------------------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `otel.library.name` | string | Deprecated. Use the `otel.scope.name` attribute | `io.opentelemetry.contrib.mongodb` | 
Use the `otel.scope.name` attribute. |
-| `otel.library.version` | string | Deprecated. Use the `otel.scope.version` attribute. | `1.0.0` | 
Use the `otel.scope.version` attribute. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `otel.library.name` | string | Deprecated. Use the `otel.scope.name` attribute | `io.opentelemetry.contrib.mongodb` | 
Use the `otel.scope.name` attribute. |
+| `otel.library.version` | string | Deprecated. Use the `otel.scope.version` attribute. | `1.0.0` | 
Use the `otel.scope.version` attribute. |
diff --git a/docs/attributes-registry/peer.md b/docs/attributes-registry/peer.md
index 0daab149ef..d4bb3bc90a 100644
--- a/docs/attributes-registry/peer.md
+++ b/docs/attributes-registry/peer.md
@@ -10,6 +10,6 @@
Operations that access some remote service.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `peer.service` | string | The [`service.name`](/docs/resource/README.md#service) of the remote service. SHOULD be equal to the actual `service.name` resource attribute of the remote service if any. | `AuthTokenCache` |  |
diff --git a/docs/attributes-registry/process.md b/docs/attributes-registry/process.md
index e4fd455be8..202ec1b3ed 100644
--- a/docs/attributes-registry/process.md
+++ b/docs/attributes-registry/process.md
@@ -13,40 +13,40 @@
An operating system process.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `process.args_count` | int | Length of the process.command_args array [1] | `4` |  |
-| `process.command` | string | The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`. | `cmd/otelcol` |  |
-| `process.command_args` | string[] | All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from `proc/[pid]/cmdline`. For libc-based executables, this would be the full argv vector passed to `main`. | `["cmd/otecol", "--config=config.yaml"]` |  |
-| `process.command_line` | string | The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of `GetCommandLineW`. Do not set this if you have to assemble it just for monitoring; use `process.command_args` instead. | `C:\cmd\otecol --config="my directory\config.yaml"` |  |
-| `process.context_switch_type` | string | Specifies whether the context switches for this data point were voluntary or involuntary. | `voluntary`; `involuntary` |  |
-| `process.creation.time` | string | The date and time the process was created, in ISO 8601 format. | `2023-11-21T09:25:34.853Z` |  |
-| `process.executable.build_id.gnu` | string | The GNU build ID as found in the `.note.gnu.build-id` ELF section (hex string). | `c89b11207f6479603b0d49bf291c092c2b719293` |  |
-| `process.executable.build_id.go` | string | The Go build ID as retrieved by `go tool buildid `. | `foh3mEXu7BLZjsN9pOwG/kATcXlYVCDEFouRMQed_/WwRFB1hPo9LBkekthSPG/x8hMC8emW2cCjXD0_1aY` |  |
-| `process.executable.build_id.profiling` | string | Profiling specific build ID for executables. See the OTel specification for Profiles for more information. | `600DCAFE4A110000F2BF38C493F5FB92` |  |
-| `process.executable.name` | string | The name of the process executable. On Linux based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` |  |
-| `process.executable.path` | string | The full path to the process executable. On Linux based systems, can be set to the target of `proc/[pid]/exe`. On Windows, can be set to the result of `GetProcessImageFileNameW`. | `/usr/bin/cmd/otelcol` |  |
-| `process.exit.code` | int | The exit code of the process. | `127` |  |
-| `process.exit.time` | string | The date and time the process exited, in ISO 8601 format. | `2023-11-21T09:26:12.315Z` |  |
-| `process.group_leader.pid` | int | The PID of the process's group leader. This is also the process group ID (PGID) of the process. | `23` |  |
-| `process.interactive` | boolean | Whether the process is connected to an interactive shell. | |  |
-| `process.owner` | string | The username of the user that owns the process. | `root` |  |
-| `process.paging.fault_type` | string | The type of page fault for this data point. Type `major` is for major/hard page faults, and `minor` is for minor/soft page faults. | `major`; `minor` |  |
-| `process.parent_pid` | int | Parent Process identifier (PPID). | `111` |  |
-| `process.pid` | int | Process identifier (PID). | `1234` |  |
-| `process.real_user.id` | int | The real user ID (RUID) of the process. | `1000` |  |
-| `process.real_user.name` | string | The username of the real user of the process. | `operator` |  |
-| `process.runtime.description` | string | An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment. | `Eclipse OpenJ9 Eclipse OpenJ9 VM openj9-0.21.0` |  |
-| `process.runtime.name` | string | The name of the runtime of this process. | `OpenJDK Runtime Environment` |  |
-| `process.runtime.version` | string | The version of the runtime of this process, as returned by the runtime without modification. | `14.0.2` |  |
-| `process.saved_user.id` | int | The saved user ID (SUID) of the process. | `1002` |  |
-| `process.saved_user.name` | string | The username of the saved user. | `operator` |  |
-| `process.session_leader.pid` | int | The PID of the process's session leader. This is also the session ID (SID) of the process. | `14` |  |
-| `process.title` | string | Process title (proctitle) [2] | `cat /etc/hostname`; `xfce4-session`; `bash` |  |
-| `process.user.id` | int | The effective user ID (EUID) of the process. | `1001` |  |
-| `process.user.name` | string | The username of the effective user of the process. | `root` |  |
-| `process.vpid` | int | Virtual process identifier. [3] | `12` |  |
-| `process.working_directory` | string | The working directory of the process. | `/root` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `process.args_count` | int | Length of the process.command_args array [1] | `4` |  |
+| `process.command` | string | The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`. | `cmd/otelcol` |  |
+| `process.command_args` | string[] | All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from `proc/[pid]/cmdline`. For libc-based executables, this would be the full argv vector passed to `main`. | `["cmd/otecol", "--config=config.yaml"]` |  |
+| `process.command_line` | string | The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of `GetCommandLineW`. Do not set this if you have to assemble it just for monitoring; use `process.command_args` instead. | `C:\cmd\otecol --config="my directory\config.yaml"` |  |
+| `process.context_switch_type` | string | Specifies whether the context switches for this data point were voluntary or involuntary. | `voluntary`; `involuntary` |  |
+| `process.creation.time` | string | The date and time the process was created, in ISO 8601 format. | `2023-11-21T09:25:34.853Z` |  |
+| `process.executable.build_id.gnu` | string | The GNU build ID as found in the `.note.gnu.build-id` ELF section (hex string). | `c89b11207f6479603b0d49bf291c092c2b719293` |  |
+| `process.executable.build_id.go` | string | The Go build ID as retrieved by `go tool buildid `. | `foh3mEXu7BLZjsN9pOwG/kATcXlYVCDEFouRMQed_/WwRFB1hPo9LBkekthSPG/x8hMC8emW2cCjXD0_1aY` |  |
+| `process.executable.build_id.profiling` | string | Profiling specific build ID for executables. See the OTel specification for Profiles for more information. | `600DCAFE4A110000F2BF38C493F5FB92` |  |
+| `process.executable.name` | string | The name of the process executable. On Linux based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` |  |
+| `process.executable.path` | string | The full path to the process executable. On Linux based systems, can be set to the target of `proc/[pid]/exe`. On Windows, can be set to the result of `GetProcessImageFileNameW`. | `/usr/bin/cmd/otelcol` |  |
+| `process.exit.code` | int | The exit code of the process. | `127` |  |
+| `process.exit.time` | string | The date and time the process exited, in ISO 8601 format. | `2023-11-21T09:26:12.315Z` |  |
+| `process.group_leader.pid` | int | The PID of the process's group leader. This is also the process group ID (PGID) of the process. | `23` |  |
+| `process.interactive` | boolean | Whether the process is connected to an interactive shell. | |  |
+| `process.owner` | string | The username of the user that owns the process. | `root` |  |
+| `process.paging.fault_type` | string | The type of page fault for this data point. Type `major` is for major/hard page faults, and `minor` is for minor/soft page faults. | `major`; `minor` |  |
+| `process.parent_pid` | int | Parent Process identifier (PPID). | `111` |  |
+| `process.pid` | int | Process identifier (PID). | `1234` |  |
+| `process.real_user.id` | int | The real user ID (RUID) of the process. | `1000` |  |
+| `process.real_user.name` | string | The username of the real user of the process. | `operator` |  |
+| `process.runtime.description` | string | An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment. | `Eclipse OpenJ9 Eclipse OpenJ9 VM openj9-0.21.0` |  |
+| `process.runtime.name` | string | The name of the runtime of this process. | `OpenJDK Runtime Environment` |  |
+| `process.runtime.version` | string | The version of the runtime of this process, as returned by the runtime without modification. | `14.0.2` |  |
+| `process.saved_user.id` | int | The saved user ID (SUID) of the process. | `1002` |  |
+| `process.saved_user.name` | string | The username of the saved user. | `operator` |  |
+| `process.session_leader.pid` | int | The PID of the process's session leader. This is also the session ID (SID) of the process. | `14` |  |
+| `process.title` | string | Process title (proctitle) [2] | `cat /etc/hostname`; `xfce4-session`; `bash` |  |
+| `process.user.id` | int | The effective user ID (EUID) of the process. | `1001` |  |
+| `process.user.name` | string | The username of the effective user of the process. | `root` |  |
+| `process.vpid` | int | Virtual process identifier. [3] | `12` |  |
+| `process.working_directory` | string | The working directory of the process. | `/root` |  |
**[1]:** This field can be useful for querying or performing bucket analysis on how many arguments were provided to start a process. More arguments may be an indication of suspicious activity.
@@ -56,30 +56,30 @@ An operating system process.
`process.context_switch_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------- | ----------- | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `involuntary` | involuntary |  |
-| `voluntary` | voluntary |  |
+| `voluntary` | voluntary |  |
`process.paging.fault_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------- | ----------- | ---------------------------------------------------------------- |
-| `major` | major |  |
-| `minor` | minor |  |
+| Value | Description | Stability |
+|---|---|---|
+| `major` | major |  |
+| `minor` | minor |  |
## Deprecated Process Attributes
Deprecated process attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------- | ------ | ----------------------------------- | ------------------------ | ------------------------------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `process.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `system`; `user`; `wait` | 
Replaced by `cpu.mode` |
`process.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ----------- | ---------------------------------------------------------------- |
-| `system` | system |  |
-| `user` | user |  |
-| `wait` | wait |  |
+| Value | Description | Stability |
+|---|---|---|
+| `system` | system |  |
+| `user` | user |  |
+| `wait` | wait |  |
diff --git a/docs/attributes-registry/profile.md b/docs/attributes-registry/profile.md
index 1703adae0e..cb21193a68 100644
--- a/docs/attributes-registry/profile.md
+++ b/docs/attributes-registry/profile.md
@@ -10,20 +10,20 @@
Describes the origin of a single frame in a Profile.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------ | ------ | -------------------------------------------------------- | --------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `profile.frame.type` | string | Describes the interpreter or compiler of a single frame. | `cpython` |  |
`profile.frame.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `cpython` | [Python]() |  |
-| `dotnet` | [.NET](https://wikipedia.org/wiki/.NET) |  |
-| `jvm` | [JVM](https://wikipedia.org/wiki/Java_virtual_machine) |  |
-| `kernel` | [Kernel]() |  |
-| `native` | [C](), [C++](https://wikipedia.org/wiki/C%2B%2B), [Go](), [Rust]() |  |
-| `perl` | [Perl](https://wikipedia.org/wiki/Perl) |  |
-| `php` | [PHP](https://wikipedia.org/wiki/PHP) |  |
-| `ruby` | [Ruby]() |  |
-| `v8js` | [V8JS]() |  |
+| Value | Description | Stability |
+|---|---|---|
+| `cpython` | [Python](https://wikipedia.org/wiki/Python_(programming_language)) |  |
+| `dotnet` | [.NET](https://wikipedia.org/wiki/.NET) |  |
+| `jvm` | [JVM](https://wikipedia.org/wiki/Java_virtual_machine) |  |
+| `kernel` | [Kernel](https://wikipedia.org/wiki/Kernel_(operating_system)) |  |
+| `native` | [C](https://wikipedia.org/wiki/C_(programming_language)), [C++](https://wikipedia.org/wiki/C%2B%2B), [Go](https://wikipedia.org/wiki/Go_(programming_language)), [Rust](https://wikipedia.org/wiki/Rust_(programming_language)) |  |
+| `perl` | [Perl](https://wikipedia.org/wiki/Perl) |  |
+| `php` | [PHP](https://wikipedia.org/wiki/PHP) |  |
+| `ruby` | [Ruby](https://wikipedia.org/wiki/Ruby_(programming_language)) |  |
+| `v8js` | [V8JS](https://wikipedia.org/wiki/V8_(JavaScript_engine)) |  |
diff --git a/docs/attributes-registry/rpc.md b/docs/attributes-registry/rpc.md
index 163275f96e..2dc4810d0b 100644
--- a/docs/attributes-registry/rpc.md
+++ b/docs/attributes-registry/rpc.md
@@ -13,25 +13,25 @@
This document defines attributes for remote procedure calls.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `rpc.connect_rpc.error_code` | string | The [error codes](https://connect.build/docs/protocol/#error-codes) of the Connect request. Error codes are always string values. | `cancelled`; `unknown`; `invalid_argument` |  |
-| `rpc.connect_rpc.request.metadata.` | string[] | Connect request metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [1] | `rpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` |  |
-| `rpc.connect_rpc.response.metadata.` | string[] | Connect response metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [2] | `rpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` |  |
-| `rpc.grpc.request.metadata.` | string[] | gRPC request metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [3] | `rpc.grpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` |  |
-| `rpc.grpc.response.metadata.` | string[] | gRPC response metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [4] | `rpc.grpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` |  |
-| `rpc.grpc.status_code` | int | The [numeric status code](https://github.com/grpc/grpc/blob/v1.33.2/doc/statuscodes.md) of the gRPC request. | `0`; `1`; `2` |  |
-| `rpc.jsonrpc.error_code` | int | `error.code` property of response if it is an error response. | `-32700`; `100` |  |
-| `rpc.jsonrpc.error_message` | string | `error.message` property of response if it is an error response. | `Parse error`; `User already exists` |  |
-| `rpc.jsonrpc.request_id` | string | `id` property of request or response. Since protocol allows id to be int, string, `null` or missing (for notifications), value is expected to be cast to string for simplicity. Use empty string in case of `null` value. Omit entirely if this is a notification. | `10`; `request-7`; `` |  |
-| `rpc.jsonrpc.version` | string | Protocol version as in `jsonrpc` property of request/response. Since JSON-RPC 1.0 doesn't specify this, the value can be omitted. | `2.0`; `1.0` |  |
-| `rpc.message.compressed_size` | int | Compressed size of the message in bytes. | |  |
-| `rpc.message.id` | int | MUST be calculated as two different counters starting from `1` one for sent messages and one for received message. [5] | |  |
-| `rpc.message.type` | string | Whether this is a received or sent message. | `SENT`; `RECEIVED` |  |
-| `rpc.message.uncompressed_size` | int | Uncompressed size of the message in bytes. | |  |
-| `rpc.method` | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [6] | `exampleMethod` |  |
-| `rpc.service` | string | The full (logical) name of the service being called, including its package name, if applicable. [7] | `myservice.EchoService` |  |
-| `rpc.system` | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc`; `java_rmi`; `dotnet_wcf` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `rpc.connect_rpc.error_code` | string | The [error codes](https://connect.build/docs/protocol/#error-codes) of the Connect request. Error codes are always string values. | `cancelled`; `unknown`; `invalid_argument` |  |
+| `rpc.connect_rpc.request.metadata.` | string[] | Connect request metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [1] | `rpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` |  |
+| `rpc.connect_rpc.response.metadata.` | string[] | Connect response metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [2] | `rpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` |  |
+| `rpc.grpc.request.metadata.` | string[] | gRPC request metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [3] | `rpc.grpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` |  |
+| `rpc.grpc.response.metadata.` | string[] | gRPC response metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [4] | `rpc.grpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` |  |
+| `rpc.grpc.status_code` | int | The [numeric status code](https://github.com/grpc/grpc/blob/v1.33.2/doc/statuscodes.md) of the gRPC request. | `0`; `1`; `2` |  |
+| `rpc.jsonrpc.error_code` | int | `error.code` property of response if it is an error response. | `-32700`; `100` |  |
+| `rpc.jsonrpc.error_message` | string | `error.message` property of response if it is an error response. | `Parse error`; `User already exists` |  |
+| `rpc.jsonrpc.request_id` | string | `id` property of request or response. Since protocol allows id to be int, string, `null` or missing (for notifications), value is expected to be cast to string for simplicity. Use empty string in case of `null` value. Omit entirely if this is a notification. | `10`; `request-7`; `` |  |
+| `rpc.jsonrpc.version` | string | Protocol version as in `jsonrpc` property of request/response. Since JSON-RPC 1.0 doesn't specify this, the value can be omitted. | `2.0`; `1.0` |  |
+| `rpc.message.compressed_size` | int | Compressed size of the message in bytes. | |  |
+| `rpc.message.id` | int | MUST be calculated as two different counters starting from `1` one for sent messages and one for received message. [5] | |  |
+| `rpc.message.type` | string | Whether this is a received or sent message. | `SENT`; `RECEIVED` |  |
+| `rpc.message.uncompressed_size` | int | Uncompressed size of the message in bytes. | |  |
+| `rpc.method` | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [6] | `exampleMethod` |  |
+| `rpc.service` | string | The full (logical) name of the service being called, including its package name, if applicable. [7] | `myservice.EchoService` |  |
+| `rpc.system` | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc`; `java_rmi`; `dotnet_wcf` |  |
**[1]:** Instrumentations SHOULD require an explicit configuration of which metadata values are to be captured. Including all request metadata values can be a security risk - explicit configuration helps avoid leaking sensitive information.
@@ -49,78 +49,78 @@ This document defines attributes for remote procedure calls.
`rpc.connect_rpc.error_code` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------------------- | ------------------- | ---------------------------------------------------------------- |
-| `aborted` | aborted |  |
-| `already_exists` | already_exists |  |
-| `cancelled` | cancelled |  |
-| `data_loss` | data_loss |  |
-| `deadline_exceeded` | deadline_exceeded |  |
+| Value | Description | Stability |
+|---|---|---|
+| `aborted` | aborted |  |
+| `already_exists` | already_exists |  |
+| `cancelled` | cancelled |  |
+| `data_loss` | data_loss |  |
+| `deadline_exceeded` | deadline_exceeded |  |
| `failed_precondition` | failed_precondition |  |
-| `internal` | internal |  |
-| `invalid_argument` | invalid_argument |  |
-| `not_found` | not_found |  |
-| `out_of_range` | out_of_range |  |
-| `permission_denied` | permission_denied |  |
-| `resource_exhausted` | resource_exhausted |  |
-| `unauthenticated` | unauthenticated |  |
-| `unavailable` | unavailable |  |
-| `unimplemented` | unimplemented |  |
-| `unknown` | unknown |  |
+| `internal` | internal |  |
+| `invalid_argument` | invalid_argument |  |
+| `not_found` | not_found |  |
+| `out_of_range` | out_of_range |  |
+| `permission_denied` | permission_denied |  |
+| `resource_exhausted` | resource_exhausted |  |
+| `unauthenticated` | unauthenticated |  |
+| `unavailable` | unavailable |  |
+| `unimplemented` | unimplemented |  |
+| `unknown` | unknown |  |
`rpc.grpc.status_code` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----- | ------------------- | ---------------------------------------------------------------- |
-| `0` | OK |  |
-| `1` | CANCELLED |  |
-| `2` | UNKNOWN |  |
-| `3` | INVALID_ARGUMENT |  |
-| `4` | DEADLINE_EXCEEDED |  |
-| `5` | NOT_FOUND |  |
-| `6` | ALREADY_EXISTS |  |
-| `7` | PERMISSION_DENIED |  |
-| `8` | RESOURCE_EXHAUSTED |  |
-| `9` | FAILED_PRECONDITION |  |
-| `10` | ABORTED |  |
-| `11` | OUT_OF_RANGE |  |
-| `12` | UNIMPLEMENTED |  |
-| `13` | INTERNAL |  |
-| `14` | UNAVAILABLE |  |
-| `15` | DATA_LOSS |  |
-| `16` | UNAUTHENTICATED |  |
+| Value | Description | Stability |
+|---|---|---|
+| `0` | OK |  |
+| `1` | CANCELLED |  |
+| `2` | UNKNOWN |  |
+| `3` | INVALID_ARGUMENT |  |
+| `4` | DEADLINE_EXCEEDED |  |
+| `5` | NOT_FOUND |  |
+| `6` | ALREADY_EXISTS |  |
+| `7` | PERMISSION_DENIED |  |
+| `8` | RESOURCE_EXHAUSTED |  |
+| `9` | FAILED_PRECONDITION |  |
+| `10` | ABORTED |  |
+| `11` | OUT_OF_RANGE |  |
+| `12` | UNIMPLEMENTED |  |
+| `13` | INTERNAL |  |
+| `14` | UNAVAILABLE |  |
+| `15` | DATA_LOSS |  |
+| `16` | UNAUTHENTICATED |  |
`rpc.message.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------- | ----------- | ---------------------------------------------------------------- |
-| `RECEIVED` | received |  |
-| `SENT` | sent |  |
+| Value | Description | Stability |
+|---|---|---|
+| `RECEIVED` | received |  |
+| `SENT` | sent |  |
`rpc.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------- | ------------ | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `apache_dubbo` | Apache Dubbo |  |
-| `connect_rpc` | Connect RPC |  |
-| `dotnet_wcf` | .NET WCF |  |
-| `grpc` | gRPC |  |
-| `java_rmi` | Java RMI |  |
+| `connect_rpc` | Connect RPC |  |
+| `dotnet_wcf` | .NET WCF |  |
+| `grpc` | gRPC |  |
+| `java_rmi` | Java RMI |  |
## Deprecated RPC Attributes
Deprecated rpc message attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------- |
-| `message.compressed_size` | int | Deprecated, use `rpc.message.compressed_size` instead. | | 
Replaced by `rpc.message.compressed_size`. |
-| `message.id` | int | Deprecated, use `rpc.message.id` instead. | | 
Replaced by `rpc.message.id`. |
-| `message.type` | string | Deprecated, use `rpc.message.type` instead. | `SENT`; `RECEIVED` | 
Replaced by `rpc.message.type`. |
-| `message.uncompressed_size` | int | Deprecated, use `rpc.message.uncompressed_size` instead. | | 
Replaced by `rpc.message.uncompressed_size`. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `message.compressed_size` | int | Deprecated, use `rpc.message.compressed_size` instead. | | 
Replaced by `rpc.message.compressed_size`. |
+| `message.id` | int | Deprecated, use `rpc.message.id` instead. | | 
Replaced by `rpc.message.id`. |
+| `message.type` | string | Deprecated, use `rpc.message.type` instead. | `SENT`; `RECEIVED` | 
Replaced by `rpc.message.type`. |
+| `message.uncompressed_size` | int | Deprecated, use `rpc.message.uncompressed_size` instead. | | 
Replaced by `rpc.message.uncompressed_size`. |
`message.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------- | ----------- | ---------------------------------------------------------------- |
-| `RECEIVED` | received |  |
-| `SENT` | sent |  |
+| Value | Description | Stability |
+|---|---|---|
+| `RECEIVED` | received |  |
+| `SENT` | sent |  |
diff --git a/docs/attributes-registry/server.md b/docs/attributes-registry/server.md
index 6ef0995375..7ea59e0cdc 100644
--- a/docs/attributes-registry/server.md
+++ b/docs/attributes-registry/server.md
@@ -10,10 +10,10 @@
These attributes may be used to describe the server in a connection-based network interaction where there is one side that initiates the connection (the client is the side that initiates the connection). This covers all TCP network interactions since TCP is connection-based and one side initiates the connection (an exception is made for peer-to-peer communication over TCP where the "user-facing" surface of the protocol / API doesn't expose a clear notion of client and server). This also covers UDP network interactions where one side initiates the interaction, e.g. QUIC (HTTP/3) and DNS.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | ---------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `server.address` | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` |  |
-| `server.port` | int | Server port number. [2] | `80`; `8080`; `443` |  |
+| `server.port` | int | Server port number. [2] | `80`; `8080`; `443` |  |
**[1]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
diff --git a/docs/attributes-registry/service.md b/docs/attributes-registry/service.md
index 6f3e08a3c1..88ecebc591 100644
--- a/docs/attributes-registry/service.md
+++ b/docs/attributes-registry/service.md
@@ -10,12 +10,12 @@
A service instance.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
-| `service.instance.id` | string | The string ID of the service instance. [1] | `627cc493-f310-47de-96bd-71410b7dec09` |  |
-| `service.name` | string | Logical name of the service. [2] | `shoppingcart` |  |
-| `service.namespace` | string | A namespace for `service.name`. [3] | `Shop` |  |
-| `service.version` | string | The version string of the service API or implementation. The format is not defined by these conventions. | `2.0.0`; `a01dbef8a` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `service.instance.id` | string | The string ID of the service instance. [1] | `627cc493-f310-47de-96bd-71410b7dec09` |  |
+| `service.name` | string | Logical name of the service. [2] | `shoppingcart` |  |
+| `service.namespace` | string | A namespace for `service.name`. [3] | `Shop` |  |
+| `service.version` | string | The version string of the service API or implementation. The format is not defined by these conventions. | `2.0.0`; `a01dbef8a` |  |
**[1]:** MUST be unique for each instance of the same `service.namespace,service.name` pair (in other words
`service.namespace,service.name,service.instance.id` triplet MUST be globally unique). The ID helps to
diff --git a/docs/attributes-registry/session.md b/docs/attributes-registry/session.md
index c0774c988b..2505a28fcf 100644
--- a/docs/attributes-registry/session.md
+++ b/docs/attributes-registry/session.md
@@ -12,7 +12,7 @@ Session is defined as the period of time encompassing all activities performed b
Consequently, a Session is represented as a collection of Logs, Events, and Spans emitted by the Client Application throughout the Session's duration. Each Session is assigned a unique identifier, which is included as an attribute in the Logs, Events, and Spans generated during the Session's lifecycle.
When a session reaches end of life, typically due to user inactivity or session timeout, a new session identifier will be assigned. The previous session identifier may be provided by the instrumentation so that telemetry backends can link the two sessions.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | ---------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
-| `session.id` | string | A unique id to identify a session. | `00112233-4455-6677-8899-aabbccddeeff` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `session.id` | string | A unique id to identify a session. | `00112233-4455-6677-8899-aabbccddeeff` |  |
| `session.previous_id` | string | The previous `session.id` for this user, when known. | `00112233-4455-6677-8899-aabbccddeeff` |  |
diff --git a/docs/attributes-registry/signalr.md b/docs/attributes-registry/signalr.md
index caacf3e501..d1535b3bf3 100644
--- a/docs/attributes-registry/signalr.md
+++ b/docs/attributes-registry/signalr.md
@@ -10,23 +10,23 @@
SignalR attributes
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | ----------------------------- | ---------------------------------------------------------- |
-| `signalr.connection.status` | string | SignalR HTTP connection closure status. | `app_shutdown`; `timeout` |  |
-| `signalr.transport` | string | [SignalR transport type](https://github.com/dotnet/aspnetcore/blob/main/src/SignalR/docs/specs/TransportProtocols.md) | `web_sockets`; `long_polling` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `signalr.connection.status` | string | SignalR HTTP connection closure status. | `app_shutdown`; `timeout` |  |
+| `signalr.transport` | string | [SignalR transport type](https://github.com/dotnet/aspnetcore/blob/main/src/SignalR/docs/specs/TransportProtocols.md) | `web_sockets`; `long_polling` |  |
`signalr.connection.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------------- | ----------------------------------------------------------- | ---------------------------------------------------------- |
-| `app_shutdown` | The connection was closed because the app is shutting down. |  |
-| `normal_closure` | The connection was closed normally. |  |
-| `timeout` | The connection was closed due to a timeout. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `app_shutdown` | The connection was closed because the app is shutting down. |  |
+| `normal_closure` | The connection was closed normally. |  |
+| `timeout` | The connection was closed due to a timeout. |  |
`signalr.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------------- | ------------------------- | ---------------------------------------------------------- |
-| `long_polling` | LongPolling protocol |  |
+| Value | Description | Stability |
+|---|---|---|
+| `long_polling` | LongPolling protocol |  |
| `server_sent_events` | ServerSentEvents protocol |  |
-| `web_sockets` | WebSockets protocol |  |
+| `web_sockets` | WebSockets protocol |  |
diff --git a/docs/attributes-registry/source.md b/docs/attributes-registry/source.md
index de08994d9a..5ee20afb67 100644
--- a/docs/attributes-registry/source.md
+++ b/docs/attributes-registry/source.md
@@ -10,9 +10,9 @@
These attributes may be used to describe the sender of a network exchange/packet. These should be used when there is no client/server relationship between the two sides, or when that relationship is unknown. This covers low-level network interactions (e.g. packet tracing) where you don't know if there was a connection or which side initiated it. This also covers unidirectional UDP flows and peer-to-peer communication where the "user-facing" surface of the protocol / API doesn't expose a clear notion of client and server.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `source.address` | string | Source address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `source.example.com`; `10.1.2.80`; `/tmp/my.sock` |  |
-| `source.port` | int | Source port number | `3389`; `2888` |  |
+| `source.port` | int | Source port number | `3389`; `2888` |  |
**[1]:** When observed from the destination side, and when communicating through an intermediary, `source.address` SHOULD represent the source address behind any intermediaries, for example proxies, if it's available.
diff --git a/docs/attributes-registry/system.md b/docs/attributes-registry/system.md
index 69c8c80d9e..a94bda9e14 100644
--- a/docs/attributes-registry/system.md
+++ b/docs/attributes-registry/system.md
@@ -19,165 +19,165 @@
Describes System attributes
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------- | ------ | --------------------- | -------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `system.device` | string | The device identifier | `(identifier)` |  |
## System CPU Attributes
Describes System CPU attributes
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------- | ---- | ------------------------------- | -------- | ---------------------------------------------------------------- |
-| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` |  |
## Filesystem Attributes
Describes Filesystem attributes
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------ | ------ | ------------------------- | ----------- | ---------------------------------------------------------------- |
-| `system.filesystem.mode` | string | The filesystem mode | `rw, ro` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `system.filesystem.mode` | string | The filesystem mode | `rw, ro` |  |
| `system.filesystem.mountpoint` | string | The filesystem mount path | `/mnt/data` |  |
-| `system.filesystem.state` | string | The filesystem state | `used` |  |
-| `system.filesystem.type` | string | The filesystem type | `ext4` |  |
+| `system.filesystem.state` | string | The filesystem state | `used` |  |
+| `system.filesystem.type` | string | The filesystem type | `ext4` |  |
`system.filesystem.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------- | ----------- | ---------------------------------------------------------------- |
-| `free` | free |  |
-| `reserved` | reserved |  |
-| `used` | used |  |
+| Value | Description | Stability |
+|---|---|---|
+| `free` | free |  |
+| `reserved` | reserved |  |
+| `used` | used |  |
`system.filesystem.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | ----------- | ---------------------------------------------------------------- |
-| `exfat` | exfat |  |
-| `ext4` | ext4 |  |
-| `fat32` | fat32 |  |
-| `hfsplus` | hfsplus |  |
-| `ntfs` | ntfs |  |
-| `refs` | refs |  |
+| Value | Description | Stability |
+|---|---|---|
+| `exfat` | exfat |  |
+| `ext4` | ext4 |  |
+| `fat32` | fat32 |  |
+| `hfsplus` | hfsplus |  |
+| `ntfs` | ntfs |  |
+| `refs` | refs |  |
## System Memory Attributes
Describes System Memory attributes
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | ---------------- | ---------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `system.memory.state` | string | The memory state | `free`; `cached` |  |
`system.memory.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| `buffers` | buffers |  |
-| `cached` | cached |  |
-| `free` | free |  |
-| `shared` | shared | 
Removed, report shared memory usage with `metric.system.memory.shared` metric |
-| `used` | used |  |
+| Value | Description | Stability |
+|---|---|---|
+| `buffers` | buffers |  |
+| `cached` | cached |  |
+| `free` | free |  |
+| `shared` | shared | 
Removed, report shared memory usage with `metric.system.memory.shared` metric |
+| `used` | used |  |
## System Network Attributes
Describes Network attributes
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | ------ | ------------------------------------------------ | ------------ | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `system.network.state` | string | A stateless protocol MUST NOT set this attribute | `close_wait` |  |
`system.network.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------- | ----------- | ---------------------------------------------------------------- |
-| `close` | close |  |
-| `close_wait` | close_wait |  |
-| `closing` | closing |  |
-| `delete` | delete |  |
+| Value | Description | Stability |
+|---|---|---|
+| `close` | close |  |
+| `close_wait` | close_wait |  |
+| `closing` | closing |  |
+| `delete` | delete |  |
| `established` | established |  |
-| `fin_wait_1` | fin_wait_1 |  |
-| `fin_wait_2` | fin_wait_2 |  |
-| `last_ack` | last_ack |  |
-| `listen` | listen |  |
-| `syn_recv` | syn_recv |  |
-| `syn_sent` | syn_sent |  |
-| `time_wait` | time_wait |  |
+| `fin_wait_1` | fin_wait_1 |  |
+| `fin_wait_2` | fin_wait_2 |  |
+| `last_ack` | last_ack |  |
+| `listen` | listen |  |
+| `syn_recv` | syn_recv |  |
+| `syn_sent` | syn_sent |  |
+| `time_wait` | time_wait |  |
## System Paging Attributes
Describes System Memory Paging attributes
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------- | ------ | --------------------------- | -------- | ---------------------------------------------------------------- |
-| `system.paging.direction` | string | The paging access direction | `in` |  |
-| `system.paging.state` | string | The memory paging state | `free` |  |
-| `system.paging.type` | string | The memory paging type | `minor` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `system.paging.direction` | string | The paging access direction | `in` |  |
+| `system.paging.state` | string | The memory paging state | `free` |  |
+| `system.paging.type` | string | The memory paging type | `minor` |  |
`system.paging.direction` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----- | ----------- | ---------------------------------------------------------------- |
-| `in` | in |  |
-| `out` | out |  |
+| Value | Description | Stability |
+|---|---|---|
+| `in` | in |  |
+| `out` | out |  |
`system.paging.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | ----------- | ---------------------------------------------------------------- |
-| `free` | free |  |
-| `used` | used |  |
+| Value | Description | Stability |
+|---|---|---|
+| `free` | free |  |
+| `used` | used |  |
`system.paging.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------- | ----------- | ---------------------------------------------------------------- |
-| `major` | major |  |
-| `minor` | minor |  |
+| Value | Description | Stability |
+|---|---|---|
+| `major` | major |  |
+| `minor` | minor |  |
## System Process Attributes
Describes System Process attributes
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- | --------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `system.process.status` | string | The process state, e.g., [Linux Process State Codes](https://man7.org/linux/man-pages/man1/ps.1.html#PROCESS_STATE_CODES) | `running` |  |
`system.process.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------- | ----------- | ---------------------------------------------------------------- |
-| `defunct` | defunct |  |
-| `running` | running |  |
-| `sleeping` | sleeping |  |
-| `stopped` | stopped |  |
+| Value | Description | Stability |
+|---|---|---|
+| `defunct` | defunct |  |
+| `running` | running |  |
+| `sleeping` | sleeping |  |
+| `stopped` | stopped |  |
## Deprecated System Attributes
Deprecated system attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------ | ------------------- | --------------------------------------------------------------------------------------------------- |
-| `system.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `idle`; `interrupt` | 
Replaced by `cpu.mode` |
-| `system.processes.status` | string | Deprecated, use `system.process.status` instead. | `running` | 
Replaced by `system.process.status`. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `system.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `idle`; `interrupt` | 
Replaced by `cpu.mode` |
+| `system.processes.status` | string | Deprecated, use `system.process.status` instead. | `running` | 
Replaced by `system.process.status`. |
`system.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----------- | ----------- | ---------------------------------------------------------------- |
-| `idle` | idle |  |
-| `interrupt` | interrupt |  |
-| `iowait` | iowait |  |
-| `nice` | nice |  |
-| `steal` | steal |  |
-| `system` | system |  |
-| `user` | user |  |
+| Value | Description | Stability |
+|---|---|---|
+| `idle` | idle |  |
+| `interrupt` | interrupt |  |
+| `iowait` | iowait |  |
+| `nice` | nice |  |
+| `steal` | steal |  |
+| `system` | system |  |
+| `user` | user |  |
`system.processes.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ---------- | ----------- | ---------------------------------------------------------------- |
-| `defunct` | defunct |  |
-| `running` | running |  |
-| `sleeping` | sleeping |  |
-| `stopped` | stopped |  |
+| Value | Description | Stability |
+|---|---|---|
+| `defunct` | defunct |  |
+| `running` | running |  |
+| `sleeping` | sleeping |  |
+| `stopped` | stopped |  |
diff --git a/docs/attributes-registry/telemetry.md b/docs/attributes-registry/telemetry.md
index add53583d9..39d1a8de55 100644
--- a/docs/attributes-registry/telemetry.md
+++ b/docs/attributes-registry/telemetry.md
@@ -10,13 +10,13 @@
This document defines attributes for telemetry SDK.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------ | ------------------------- | ---------------------------------------------------------------- |
-| `telemetry.distro.name` | string | The name of the auto instrumentation agent or distribution, if used. [1] | `parts-unlimited-java` |  |
-| `telemetry.distro.version` | string | The version string of the auto instrumentation agent or distribution, if used. | `1.2.3` |  |
-| `telemetry.sdk.language` | string | The language of the telemetry SDK. | `cpp`; `dotnet`; `erlang` |  |
-| `telemetry.sdk.name` | string | The name of the telemetry SDK as defined above. [2] | `opentelemetry` |  |
-| `telemetry.sdk.version` | string | The version string of the telemetry SDK. | `1.2.3` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `telemetry.distro.name` | string | The name of the auto instrumentation agent or distribution, if used. [1] | `parts-unlimited-java` |  |
+| `telemetry.distro.version` | string | The version string of the auto instrumentation agent or distribution, if used. | `1.2.3` |  |
+| `telemetry.sdk.language` | string | The language of the telemetry SDK. | `cpp`; `dotnet`; `erlang` |  |
+| `telemetry.sdk.name` | string | The name of the telemetry SDK as defined above. [2] | `opentelemetry` |  |
+| `telemetry.sdk.version` | string | The version string of the telemetry SDK. | `1.2.3` |  |
**[1]:** Official auto instrumentation agents and distributions SHOULD set the `telemetry.distro.name` attribute to
a string starting with `opentelemetry-`, e.g. `opentelemetry-java-instrumentation`.
@@ -30,17 +30,17 @@ All custom identifiers SHOULD be stable across different versions of an implemen
`telemetry.sdk.language` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ----------- | ---------------------------------------------------------- |
-| `cpp` | cpp |  |
-| `dotnet` | dotnet |  |
-| `erlang` | erlang |  |
-| `go` | go |  |
-| `java` | java |  |
-| `nodejs` | nodejs |  |
-| `php` | php |  |
-| `python` | python |  |
-| `ruby` | ruby |  |
-| `rust` | rust |  |
-| `swift` | swift |  |
-| `webjs` | webjs |  |
+| Value | Description | Stability |
+|---|---|---|
+| `cpp` | cpp |  |
+| `dotnet` | dotnet |  |
+| `erlang` | erlang |  |
+| `go` | go |  |
+| `java` | java |  |
+| `nodejs` | nodejs |  |
+| `php` | php |  |
+| `python` | python |  |
+| `ruby` | ruby |  |
+| `rust` | rust |  |
+| `swift` | swift |  |
+| `webjs` | webjs |  |
diff --git a/docs/attributes-registry/test.md b/docs/attributes-registry/test.md
index cd02883b1d..11fbf5d98f 100644
--- a/docs/attributes-registry/test.md
+++ b/docs/attributes-registry/test.md
@@ -10,27 +10,27 @@
This group describes attributes specific to [software tests](https://en.wikipedia.org/wiki/Software_testing).
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `test.case.name` | string | The fully qualified human readable name of the [test case](https://en.wikipedia.org/wiki/Test_case). | `org.example.TestCase1.test1`; `example/tests/TestCase1.test1`; `ExampleTestCase1_test1` |  |
-| `test.case.result.status` | string | The status of the actual test case result from test execution. | `pass`; `fail` |  |
-| `test.suite.name` | string | The human readable name of a [test suite](https://en.wikipedia.org/wiki/Test_suite). | `TestSuite1` |  |
-| `test.suite.run.status` | string | The status of the test suite run. | `success`; `failure`; `skipped`; `aborted`; `timed_out`; `in_progress` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `test.case.name` | string | The fully qualified human readable name of the [test case](https://en.wikipedia.org/wiki/Test_case). | `org.example.TestCase1.test1`; `example/tests/TestCase1.test1`; `ExampleTestCase1_test1` |  |
+| `test.case.result.status` | string | The status of the actual test case result from test execution. | `pass`; `fail` |  |
+| `test.suite.name` | string | The human readable name of a [test suite](https://en.wikipedia.org/wiki/Test_suite). | `TestSuite1` |  |
+| `test.suite.run.status` | string | The status of the test suite run. | `success`; `failure`; `skipped`; `aborted`; `timed_out`; `in_progress` |  |
`test.case.result.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------ | ----------- | ---------------------------------------------------------------- |
-| `fail` | fail |  |
-| `pass` | pass |  |
+| Value | Description | Stability |
+|---|---|---|
+| `fail` | fail |  |
+| `pass` | pass |  |
`test.suite.run.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------- | ----------- | ---------------------------------------------------------------- |
-| `aborted` | aborted |  |
-| `failure` | failure |  |
+| Value | Description | Stability |
+|---|---|---|
+| `aborted` | aborted |  |
+| `failure` | failure |  |
| `in_progress` | in_progress |  |
-| `skipped` | skipped |  |
-| `success` | success |  |
-| `timed_out` | timed_out |  |
+| `skipped` | skipped |  |
+| `success` | success |  |
+| `timed_out` | timed_out |  |
diff --git a/docs/attributes-registry/thread.md b/docs/attributes-registry/thread.md
index a82015395f..ed1cf73493 100644
--- a/docs/attributes-registry/thread.md
+++ b/docs/attributes-registry/thread.md
@@ -10,7 +10,7 @@
These attributes may be used for any operation to store information about a thread that started a span.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------- | ------ | --------------------------------------------------------- | -------- | ---------------------------------------------------------------- |
-| `thread.id` | int | Current "managed" thread ID (as opposed to OS thread ID). | `42` |  |
-| `thread.name` | string | Current thread name. | `main` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `thread.id` | int | Current "managed" thread ID (as opposed to OS thread ID). | `42` |  |
+| `thread.name` | string | Current thread name. | `main` |  |
diff --git a/docs/attributes-registry/tls.md b/docs/attributes-registry/tls.md
index 9f6ecca39a..2002a76972 100644
--- a/docs/attributes-registry/tls.md
+++ b/docs/attributes-registry/tls.md
@@ -13,50 +13,50 @@
This document defines semantic convention attributes in the TLS namespace.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `tls.cipher` | string | String indicating the [cipher](https://datatracker.ietf.org/doc/html/rfc5246#appendix-A.5) used during the current connection. [1] | `TLS_RSA_WITH_3DES_EDE_CBC_SHA`; `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256` |  |
-| `tls.client.certificate` | string | PEM-encoded stand-alone certificate offered by the client. This is usually mutually-exclusive of `client.certificate_chain` since this value also exists in that list. | `MII...` |  |
-| `tls.client.certificate_chain` | string[] | Array of PEM-encoded certificates that make up the certificate chain offered by the client. This is usually mutually-exclusive of `client.certificate` since that value should be the first certificate in the chain. | `["MII...", "MI..."]` |  |
-| `tls.client.hash.md5` | string | Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC` |  |
-| `tls.client.hash.sha1` | string | Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `9E393D93138888D288266C2D915214D1D1CCEB2A` |  |
-| `tls.client.hash.sha256` | string | Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0` |  |
-| `tls.client.issuer` | string | Distinguished name of [subject](https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6) of the issuer of the x.509 certificate presented by the client. | `CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com` |  |
-| `tls.client.ja3` | string | A hash that identifies clients based on how they perform an SSL/TLS handshake. | `d4e5b18d6b55c71272893221c96ba240` |  |
-| `tls.client.not_after` | string | Date/Time indicating when client certificate is no longer considered valid. | `2021-01-01T00:00:00.000Z` |  |
-| `tls.client.not_before` | string | Date/Time indicating when client certificate is first considered valid. | `1970-01-01T00:00:00.000Z` |  |
-| `tls.client.subject` | string | Distinguished name of subject of the x.509 certificate presented by the client. | `CN=myclient, OU=Documentation Team, DC=example, DC=com` |  |
-| `tls.client.supported_ciphers` | string[] | Array of ciphers offered by the client during the client hello. | `["TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384"]` |  |
-| `tls.curve` | string | String indicating the curve used for the given cipher, when applicable | `secp256r1` |  |
-| `tls.established` | boolean | Boolean flag indicating if the TLS negotiation was successful and transitioned to an encrypted tunnel. | `true` |  |
-| `tls.next_protocol` | string | String indicating the protocol being tunneled. Per the values in the [IANA registry](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids), this string should be lower case. | `http/1.1` |  |
-| `tls.protocol.name` | string | Normalized lowercase protocol name parsed from original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `ssl`; `tls` |  |
-| `tls.protocol.version` | string | Numeric part of the version parsed from the original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `1.2`; `3` |  |
-| `tls.resumed` | boolean | Boolean flag indicating if this TLS connection was resumed from an existing TLS negotiation. | `true` |  |
-| `tls.server.certificate` | string | PEM-encoded stand-alone certificate offered by the server. This is usually mutually-exclusive of `server.certificate_chain` since this value also exists in that list. | `MII...` |  |
-| `tls.server.certificate_chain` | string[] | Array of PEM-encoded certificates that make up the certificate chain offered by the server. This is usually mutually-exclusive of `server.certificate` since that value should be the first certificate in the chain. | `["MII...", "MI..."]` |  |
-| `tls.server.hash.md5` | string | Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC` |  |
-| `tls.server.hash.sha1` | string | Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `9E393D93138888D288266C2D915214D1D1CCEB2A` |  |
-| `tls.server.hash.sha256` | string | Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0` |  |
-| `tls.server.issuer` | string | Distinguished name of [subject](https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6) of the issuer of the x.509 certificate presented by the client. | `CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com` |  |
-| `tls.server.ja3s` | string | A hash that identifies servers based on how they perform an SSL/TLS handshake. | `d4e5b18d6b55c71272893221c96ba240` |  |
-| `tls.server.not_after` | string | Date/Time indicating when server certificate is no longer considered valid. | `2021-01-01T00:00:00.000Z` |  |
-| `tls.server.not_before` | string | Date/Time indicating when server certificate is first considered valid. | `1970-01-01T00:00:00.000Z` |  |
-| `tls.server.subject` | string | Distinguished name of subject of the x.509 certificate presented by the server. | `CN=myserver, OU=Documentation Team, DC=example, DC=com` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `tls.cipher` | string | String indicating the [cipher](https://datatracker.ietf.org/doc/html/rfc5246#appendix-A.5) used during the current connection. [1] | `TLS_RSA_WITH_3DES_EDE_CBC_SHA`; `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256` |  |
+| `tls.client.certificate` | string | PEM-encoded stand-alone certificate offered by the client. This is usually mutually-exclusive of `client.certificate_chain` since this value also exists in that list. | `MII...` |  |
+| `tls.client.certificate_chain` | string[] | Array of PEM-encoded certificates that make up the certificate chain offered by the client. This is usually mutually-exclusive of `client.certificate` since that value should be the first certificate in the chain. | `["MII...", "MI..."]` |  |
+| `tls.client.hash.md5` | string | Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC` |  |
+| `tls.client.hash.sha1` | string | Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `9E393D93138888D288266C2D915214D1D1CCEB2A` |  |
+| `tls.client.hash.sha256` | string | Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0` |  |
+| `tls.client.issuer` | string | Distinguished name of [subject](https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6) of the issuer of the x.509 certificate presented by the client. | `CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com` |  |
+| `tls.client.ja3` | string | A hash that identifies clients based on how they perform an SSL/TLS handshake. | `d4e5b18d6b55c71272893221c96ba240` |  |
+| `tls.client.not_after` | string | Date/Time indicating when client certificate is no longer considered valid. | `2021-01-01T00:00:00.000Z` |  |
+| `tls.client.not_before` | string | Date/Time indicating when client certificate is first considered valid. | `1970-01-01T00:00:00.000Z` |  |
+| `tls.client.subject` | string | Distinguished name of subject of the x.509 certificate presented by the client. | `CN=myclient, OU=Documentation Team, DC=example, DC=com` |  |
+| `tls.client.supported_ciphers` | string[] | Array of ciphers offered by the client during the client hello. | `["TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384"]` |  |
+| `tls.curve` | string | String indicating the curve used for the given cipher, when applicable | `secp256r1` |  |
+| `tls.established` | boolean | Boolean flag indicating if the TLS negotiation was successful and transitioned to an encrypted tunnel. | `true` |  |
+| `tls.next_protocol` | string | String indicating the protocol being tunneled. Per the values in the [IANA registry](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids), this string should be lower case. | `http/1.1` |  |
+| `tls.protocol.name` | string | Normalized lowercase protocol name parsed from original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `ssl`; `tls` |  |
+| `tls.protocol.version` | string | Numeric part of the version parsed from the original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `1.2`; `3` |  |
+| `tls.resumed` | boolean | Boolean flag indicating if this TLS connection was resumed from an existing TLS negotiation. | `true` |  |
+| `tls.server.certificate` | string | PEM-encoded stand-alone certificate offered by the server. This is usually mutually-exclusive of `server.certificate_chain` since this value also exists in that list. | `MII...` |  |
+| `tls.server.certificate_chain` | string[] | Array of PEM-encoded certificates that make up the certificate chain offered by the server. This is usually mutually-exclusive of `server.certificate` since that value should be the first certificate in the chain. | `["MII...", "MI..."]` |  |
+| `tls.server.hash.md5` | string | Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC` |  |
+| `tls.server.hash.sha1` | string | Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `9E393D93138888D288266C2D915214D1D1CCEB2A` |  |
+| `tls.server.hash.sha256` | string | Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0` |  |
+| `tls.server.issuer` | string | Distinguished name of [subject](https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6) of the issuer of the x.509 certificate presented by the client. | `CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com` |  |
+| `tls.server.ja3s` | string | A hash that identifies servers based on how they perform an SSL/TLS handshake. | `d4e5b18d6b55c71272893221c96ba240` |  |
+| `tls.server.not_after` | string | Date/Time indicating when server certificate is no longer considered valid. | `2021-01-01T00:00:00.000Z` |  |
+| `tls.server.not_before` | string | Date/Time indicating when server certificate is first considered valid. | `1970-01-01T00:00:00.000Z` |  |
+| `tls.server.subject` | string | Distinguished name of subject of the x.509 certificate presented by the server. | `CN=myserver, OU=Documentation Team, DC=example, DC=com` |  |
**[1]:** The values allowed for `tls.cipher` MUST be one of the `Descriptions` of the [registered TLS Cipher Suits](https://www.iana.org/assignments/tls-parameters/tls-parameters.xhtml#table-tls-parameters-4).
`tls.protocol.name` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ----- | ----------- | ---------------------------------------------------------------- |
-| `ssl` | ssl |  |
-| `tls` | tls |  |
+| Value | Description | Stability |
+|---|---|---|
+| `ssl` | ssl |  |
+| `tls` | tls |  |
## TLS Deprecated Attributes
Describes deprecated `tls` attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------------ | ------ | ----------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `tls.client.server_name` | string | Deprecated, use `server.address` instead. | `opentelemetry.io` | 
Replaced by `server.address`. |
diff --git a/docs/attributes-registry/url.md b/docs/attributes-registry/url.md
index 898a66c220..ba44a2f815 100644
--- a/docs/attributes-registry/url.md
+++ b/docs/attributes-registry/url.md
@@ -10,21 +10,21 @@
Attributes describing URL.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `url.domain` | string | Domain extracted from the `url.full`, such as "opentelemetry.io". [1] | `www.foo.bar`; `opentelemetry.io`; `3.12.167.2`; `[1080:0:0:0:8:800:200C:417A]` |  |
-| `url.extension` | string | The file extension extracted from the `url.full`, excluding the leading dot. [2] | `png`; `gz` |  |
-| `url.fragment` | string | The [URI fragment](https://www.rfc-editor.org/rfc/rfc3986#section-3.5) component | `SemConv` |  |
-| `url.full` | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [3] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `//localhost` |  |
-| `url.original` | string | Unmodified original URL as seen in the event source. [4] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `search?q=OpenTelemetry` |  |
-| `url.path` | string | The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component [5] | `/search` |  |
-| `url.port` | int | Port extracted from the `url.full` | `443` |  |
-| `url.query` | string | The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component [6] | `q=OpenTelemetry` |  |
-| `url.registered_domain` | string | The highest registered url domain, stripped of the subdomain. [7] | `example.com`; `foo.co.uk` |  |
-| `url.scheme` | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `https`; `ftp`; `telnet` |  |
-| `url.subdomain` | string | The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. [8] | `east`; `sub2.sub1` |  |
-| `url.template` | string | The low-cardinality template of an [absolute path reference](https://www.rfc-editor.org/rfc/rfc3986#section-4.2). | `/users/{id}`; `/users/:id`; `/users?id={id}` |  |
-| `url.top_level_domain` | string | The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is `com`. [9] | `com`; `co.uk` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `url.domain` | string | Domain extracted from the `url.full`, such as "opentelemetry.io". [1] | `www.foo.bar`; `opentelemetry.io`; `3.12.167.2`; `[1080:0:0:0:8:800:200C:417A]` |  |
+| `url.extension` | string | The file extension extracted from the `url.full`, excluding the leading dot. [2] | `png`; `gz` |  |
+| `url.fragment` | string | The [URI fragment](https://www.rfc-editor.org/rfc/rfc3986#section-3.5) component | `SemConv` |  |
+| `url.full` | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [3] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `//localhost` |  |
+| `url.original` | string | Unmodified original URL as seen in the event source. [4] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `search?q=OpenTelemetry` |  |
+| `url.path` | string | The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component [5] | `/search` |  |
+| `url.port` | int | Port extracted from the `url.full` | `443` |  |
+| `url.query` | string | The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component [6] | `q=OpenTelemetry` |  |
+| `url.registered_domain` | string | The highest registered url domain, stripped of the subdomain. [7] | `example.com`; `foo.co.uk` |  |
+| `url.scheme` | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `https`; `ftp`; `telnet` |  |
+| `url.subdomain` | string | The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. [8] | `east`; `sub2.sub1` |  |
+| `url.template` | string | The low-cardinality template of an [absolute path reference](https://www.rfc-editor.org/rfc/rfc3986#section-4.2). | `/users/{id}`; `/users/:id`; `/users?id={id}` |  |
+| `url.top_level_domain` | string | The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is `com`. [9] | `com`; `co.uk` |  |
**[1]:** In some cases a URL may refer to an IP and/or port directly, without a domain name. In this case, the IP address would go to the domain field. If the URL contains a [literal IPv6 address](https://www.rfc-editor.org/rfc/rfc2732#section-2) enclosed by `[` and `]`, the `[` and `]` characters should also be captured in the domain field.
diff --git a/docs/attributes-registry/user-agent.md b/docs/attributes-registry/user-agent.md
index 18568cc272..6afe7b8549 100644
--- a/docs/attributes-registry/user-agent.md
+++ b/docs/attributes-registry/user-agent.md
@@ -10,11 +10,11 @@
Describes user-agent attributes.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `user_agent.name` | string | Name of the user-agent extracted from original. Usually refers to the browser's name. [1] | `Safari`; `YourApp` |  |
-| `user_agent.original` | string | Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1`; `YourApp/1.0.0 grpc-java-okhttp/1.27.2` |  |
-| `user_agent.version` | string | Version of the user-agent extracted from original. Usually refers to the browser's version [2] | `14.1.2`; `1.0.0` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `user_agent.name` | string | Name of the user-agent extracted from original. Usually refers to the browser's name. [1] | `Safari`; `YourApp` |  |
+| `user_agent.original` | string | Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1`; `YourApp/1.0.0 grpc-java-okhttp/1.27.2` |  |
+| `user_agent.version` | string | Version of the user-agent extracted from original. Usually refers to the browser's version [2] | `14.1.2`; `1.0.0` |  |
**[1]:** [Example](https://www.whatsmyua.info) of extracting browser's name from original string. In the case of using a user-agent for non-browser products, such as microservices with multiple names/versions inside the `user_agent.original`, the most significant name SHOULD be selected. In such a scenario it should align with `user_agent.version`
diff --git a/docs/attributes-registry/user.md b/docs/attributes-registry/user.md
index 0ccc2ed499..0f061b55ac 100644
--- a/docs/attributes-registry/user.md
+++ b/docs/attributes-registry/user.md
@@ -10,13 +10,13 @@
Describes information about the user.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------ | -------- | ---------------------------------------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------- |
-| `user.email` | string | User email address. | `a.einstein@example.com` |  |
-| `user.full_name` | string | User's full name | `Albert Einstein` |  |
-| `user.hash` | string | Unique user hash to correlate information for a user in anonymized form. [1] | `364fc68eaf4c8acec74a4e52d7d1feaa` |  |
-| `user.id` | string | Unique identifier of the user. | `S-1-5-21-202424912787-2692429404-2351956786-1000` |  |
-| `user.name` | string | Short name or login/username of the user. | `a.einstein` |  |
-| `user.roles` | string[] | Array of user roles at the time of the event. | `["admin", "reporting_user"]` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `user.email` | string | User email address. | `a.einstein@example.com` |  |
+| `user.full_name` | string | User's full name | `Albert Einstein` |  |
+| `user.hash` | string | Unique user hash to correlate information for a user in anonymized form. [1] | `364fc68eaf4c8acec74a4e52d7d1feaa` |  |
+| `user.id` | string | Unique identifier of the user. | `S-1-5-21-202424912787-2692429404-2351956786-1000` |  |
+| `user.name` | string | Short name or login/username of the user. | `a.einstein` |  |
+| `user.roles` | string[] | Array of user roles at the time of the event. | `["admin", "reporting_user"]` |  |
**[1]:** Useful if `user.id` or `user.name` contain confidential information and cannot be used.
diff --git a/docs/attributes-registry/v8js.md b/docs/attributes-registry/v8js.md
index 45d8903e63..3ca30207c9 100644
--- a/docs/attributes-registry/v8js.md
+++ b/docs/attributes-registry/v8js.md
@@ -10,28 +10,28 @@
Describes V8 JS Engine Runtime related attributes.
-| Attribute | Type | Description | Examples | Stability |
-| ------------------------------------------------------------------------------------ | ------ | ---------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
-| `v8js.gc.type` | string | The type of garbage collection. | `major`; `minor`; `incremental` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `v8js.gc.type` | string | The type of garbage collection. | `major`; `minor`; `incremental` |  |
| `v8js.heap.space.name` | string | The name of the space type of heap memory. [1] | `new_space`; `old_space`; `code_space` |  |
**[1]:** Value can be retrieved from value `space_name` of [`v8.getHeapSpaceStatistics()`](https://nodejs.org/api/v8.html#v8getheapspacestatistics)
`v8js.gc.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| ------------- | ---------------------------------------- | ---------------------------------------------------------------- |
-| `incremental` | Incremental (Incremental Marking). |  |
-| `major` | Major (Mark Sweep Compact). |  |
-| `minor` | Minor (Scavenge). |  |
-| `weakcb` | Weak Callbacks (Process Weak Callbacks). |  |
+| Value | Description | Stability |
+|---|---|---|
+| `incremental` | Incremental (Incremental Marking). |  |
+| `major` | Major (Mark Sweep Compact). |  |
+| `minor` | Minor (Scavenge). |  |
+| `weakcb` | Weak Callbacks (Process Weak Callbacks). |  |
`v8js.heap.space.name` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------------------- | -------------------------- | ---------------------------------------------------------------- |
-| `code_space` | Code memory space. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `code_space` | Code memory space. |  |
| `large_object_space` | Large object memory space. |  |
-| `map_space` | Map memory space. |  |
-| `new_space` | New memory space. |  |
-| `old_space` | Old memory space. |  |
+| `map_space` | Map memory space. |  |
+| `new_space` | New memory space. |  |
+| `old_space` | Old memory space. |  |
diff --git a/docs/attributes-registry/vcs.md b/docs/attributes-registry/vcs.md
index c7cdcd539b..4e480afebe 100644
--- a/docs/attributes-registry/vcs.md
+++ b/docs/attributes-registry/vcs.md
@@ -13,17 +13,17 @@
This group defines the attributes for [Version Control Systems (VCS)](https://en.wikipedia.org/wiki/Version_control).
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
-| `vcs.change.id` | string | The ID of the change (pull request/merge request/changelist) if applicable. This is usually a unique (within repository) identifier generated by the VCS system. | `123` |  |
-| `vcs.change.state` | string | The state of the change (pull request/merge request/changelist). | `open`; `closed`; `merged` |  |
-| `vcs.change.title` | string | The human readable title of the change (pull request/merge request/changelist). This title is often a brief summary of the change and may get merged in to a ref as the commit summary. | `Fixes broken thing`; `feat: add my new feature`; `[chore] update dependency` |  |
-| `vcs.line_change.type` | string | The type of line change being measured on a branch or change. | `added`; `removed` |  |
-| `vcs.ref.name` | string | The name of the [reference](https://git-scm.com/docs/gitglossary#def_ref) such as **branch** or **tag** in the repository. | `my-feature-branch`; `tag-1-test` |  |
-| `vcs.ref.revision` | string | The revision, literally [revised version](https://www.merriam-webster.com/dictionary/revision), The revision most often refers to a commit object in Git, or a revision number in SVN. [1] | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` |  |
-| `vcs.ref.type` | string | The type of the [reference](https://git-scm.com/docs/gitglossary#def_ref) in the repository. | `branch`; `tag` |  |
-| `vcs.repository.url.full` | string | The [URL](https://en.wikipedia.org/wiki/URL) of the repository providing the complete address in order to locate and identify the repository. | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` |  |
-| `vcs.revision_delta.type` | string | The type of revision comparison. | `ahead`; `behind` |  |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `vcs.change.id` | string | The ID of the change (pull request/merge request/changelist) if applicable. This is usually a unique (within repository) identifier generated by the VCS system. | `123` |  |
+| `vcs.change.state` | string | The state of the change (pull request/merge request/changelist). | `open`; `closed`; `merged` |  |
+| `vcs.change.title` | string | The human readable title of the change (pull request/merge request/changelist). This title is often a brief summary of the change and may get merged in to a ref as the commit summary. | `Fixes broken thing`; `feat: add my new feature`; `[chore] update dependency` |  |
+| `vcs.line_change.type` | string | The type of line change being measured on a branch or change. | `added`; `removed` |  |
+| `vcs.ref.name` | string | The name of the [reference](https://git-scm.com/docs/gitglossary#def_ref) such as **branch** or **tag** in the repository. | `my-feature-branch`; `tag-1-test` |  |
+| `vcs.ref.revision` | string | The revision, literally [revised version](https://www.merriam-webster.com/dictionary/revision), The revision most often refers to a commit object in Git, or a revision number in SVN. [1] | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` |  |
+| `vcs.ref.type` | string | The type of the [reference](https://git-scm.com/docs/gitglossary#def_ref) in the repository. | `branch`; `tag` |  |
+| `vcs.repository.url.full` | string | The [URL](https://en.wikipedia.org/wiki/URL) of the repository providing the complete address in order to locate and identify the repository. | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` |  |
+| `vcs.revision_delta.type` | string | The type of revision comparison. | `ahead`; `behind` |  |
**[1]:** The revision can be a full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf),
of the recorded change to a ref within a repository pointing to a
@@ -37,49 +37,49 @@ based on the VCS system and situational context.
`vcs.change.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `closed` | Closed means the merge request has been closed without merging. This can happen for various reasons, such as the changes being deemed unnecessary, the issue being resolved in another way, or the author deciding to withdraw the request. |  |
-| `merged` | Merged indicates that the change has been successfully integrated into the target codebase. |  |
-| `open` | Open means the change is currently active and under review. It hasn't been merged into the target branch yet, and it's still possible to make changes or add comments. |  |
-| `wip` | WIP (work-in-progress, draft) means the change is still in progress and not yet ready for a full review. It might still undergo significant changes. |  |
+| `merged` | Merged indicates that the change has been successfully integrated into the target codebase. |  |
+| `open` | Open means the change is currently active and under review. It hasn't been merged into the target branch yet, and it's still possible to make changes or add comments. |  |
+| `wip` | WIP (work-in-progress, draft) means the change is still in progress and not yet ready for a full review. It might still undergo significant changes. |  |
`vcs.line_change.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| --------- | ---------------------------- | ---------------------------------------------------------------- |
-| `added` | How many lines were added. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `added` | How many lines were added. |  |
| `removed` | How many lines were removed. |  |
`vcs.ref.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) |  |
-| `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) |  |
+| `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) |  |
`vcs.revision_delta.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | --------------------------------------------------------- | ---------------------------------------------------------------- |
-| `ahead` | How many revisions the change is ahead of the target ref. |  |
-| `behind` | How many revisions the change is behind the target ref. |  |
+| Value | Description | Stability |
+|---|---|---|
+| `ahead` | How many revisions the change is ahead of the target ref. |  |
+| `behind` | How many revisions the change is behind the target ref. |  |
## VCS Deprecated Attributes
"Describes deprecated vcs attributes."
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| `vcs.repository.change.id` | string | Deprecated, use `vcs.change.id` instead. | `123` | 
Deprecated, use `vcs.change.id` instead. |
-| `vcs.repository.change.title` | string | Deprecated, use `vcs.change.title` instead. | `Fixes broken thing`; `feat: add my new feature`; `[chore] update dependency` | 
Deprecated, use `vcs.change.title` instead. |
-| `vcs.repository.ref.name` | string | Deprecated, use `vcs.ref.name` instead. | `my-feature-branch`; `tag-1-test` | 
Deprecated, use `vcs.ref.name` instead. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `vcs.repository.change.id` | string | Deprecated, use `vcs.change.id` instead. | `123` | 
Deprecated, use `vcs.change.id` instead. |
+| `vcs.repository.change.title` | string | Deprecated, use `vcs.change.title` instead. | `Fixes broken thing`; `feat: add my new feature`; `[chore] update dependency` | 
Deprecated, use `vcs.change.title` instead. |
+| `vcs.repository.ref.name` | string | Deprecated, use `vcs.ref.name` instead. | `my-feature-branch`; `tag-1-test` | 
Deprecated, use `vcs.ref.name` instead. |
| `vcs.repository.ref.revision` | string | Deprecated, use `vcs.ref.revision` instead. | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` | 
Deprecated, use `vcs.ref.revision` instead. |
-| `vcs.repository.ref.type` | string | Deprecated, use `vcs.ref.type` instead. | `branch`; `tag` | 
Deprecated, use `vcs.ref.type` instead. |
+| `vcs.repository.ref.type` | string | Deprecated, use `vcs.ref.type` instead. | `branch`; `tag` | 
Deprecated, use `vcs.ref.type` instead. |
`vcs.repository.ref.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description | Stability |
-| -------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
+| Value | Description | Stability |
+|---|---|---|
| `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) |  |
-| `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) |  |
+| `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) |  |
diff --git a/docs/attributes-registry/webengine.md b/docs/attributes-registry/webengine.md
index 2b88051408..602fdb0e26 100644
--- a/docs/attributes-registry/webengine.md
+++ b/docs/attributes-registry/webengine.md
@@ -10,8 +10,8 @@
This document defines the attributes used to describe the packaged software running the application code.
-| Attribute | Type | Description | Examples | Stability |
-| --------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
| `webengine.description` | string | Additional description of the web engine (e.g. detailed version and edition information). | `WildFly Full 21.0.0.Final (WildFly Core 13.0.1.Final) - 2.2.2.Final` |  |
-| `webengine.name` | string | The name of the web engine. | `WildFly` |  |
-| `webengine.version` | string | The version of the web engine. | `21.0.0` |  |
+| `webengine.name` | string | The name of the web engine. | `WildFly` |  |
+| `webengine.version` | string | The version of the web engine. | `21.0.0` |  |
diff --git a/docs/azure/events.md b/docs/azure/events.md
index aba71f17db..4a32413085 100644
--- a/docs/azure/events.md
+++ b/docs/azure/events.md
@@ -7,8 +7,6 @@ Resource Log events.
## Azure Resource Log
-### Attributes
-
@@ -16,39 +14,43 @@ Resource Log events.
+**Status:** 
+
The event name MUST be `az.resource.log`.
+Describes Azure Resource Log event, see [Azure Resource Log Top-level Schema](https://learn.microsoft.com/azure/azure-monitor/essentials/resource-logs-schema#top-level-common-schema) for more details.
+
| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
|---|---|---|---|---|---|
| [`az.service_request_id`](/docs/attributes-registry/azure.md) | string | The unique identifier of the service request. It's generated by the Azure service and returned with the response. | `00000000-0000-0000-0000-000000000000` | `Recommended` |  |
| [`cloud.resource_id`](/docs/attributes-registry/cloud.md) | string | The [Fully Qualified Azure Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) the log is emitted for. | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` | `Recommended` |  |
-| [`event.name`](/docs/attributes-registry/event.md) | string | Identifies the class / type of event. [1] | `browser.mouse.click`; `device.app.lifecycle` | `Recommended` |  |
-**[1]:** Event names are subject to the same rules as [attribute names](/docs/general/attribute-naming.md). Notably, event names are namespaced to avoid collisions and provide a clean separation of semantics for events in separate domains like browser, mobile, and kubernetes.
+**Body fields:**
+
+| Body Field | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `category` | string | The Azure category of the log entry. | `AuditEvent`; `GatewayLogs`; `ApplicationGatewayAccessLog` | `Recommended` |  |
+| `correlation.id` | string | The correlation ID of the log entry. | `607964b6-41a5-4e24-a5db-db7aab3b9b34` | `Recommended` |  |
+| `duration` | int | The duration of the operations in milliseconds. | `1000` | `Recommended` |  |
+| `identity` | undefined | "A JSON blob that describes the identity of the user or application that performed the operation." [1] | | `Opt-In` |  |
+| `operation.name` | string | The name of the operation. | `SecretGet`; `Microsoft.ApiManagement/GatewayLogs`; `ApplicationGatewayAccess` | `Recommended` |  |
+| `operation.version` | string | The version of the operation. | `1.0` | `Recommended` |  |
+| `properties` | undefined | The properties provided in the Azure Resource Log. | | `Recommended` |  |
+| `result.description` | string | The description of the result. | `The operation was successful`; `The operation failed` | `Recommended` |  |
+| `result.signature` | string | The substatus of associated with the logged event. | `OK` | `Recommended` |  |
+| `result.type` | string | The status associated with the logged event. | `Succeeded`; `Failed`; `Started` | `Recommended` |  |
+| `tenant.id` | string | The tenant ID of the Active Directory tenant that this event is tied to. | `00000000-0000-0000-0000-000000000000` | `Conditionally Required` [2] |  |
+
+**[1]:** Typically, this field includes the authorization and claims or JWT token from Active Directory.
+
+> [!Warning]
+> This field contains sensitive (PII) information.
+
+**[2]:** if the event is tied to an Active Directory tenant.
-### Body Fields
-
-
-| Body Field | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
-|---|---|---|---|---|---|
-| `category` | string | The Azure category of the log entry. | `AuditEvent`, `GatewayLogs`, `ApplicationGatewayAccessLog` | `Required` |  |
-| `correlation.id` | string | The correlation ID of the log entry. | `607964b6-41a5-4e24-a5db-db7aab3b9b34` | `Required` |  |
-| `duration` | int | The duration of the operations in milliseconds. | `1000` | `Required` |  |
-| `identity` | string | A JSON blob that describes the identity of the user or application that performed the operation. | `someone` | `Opt-In` |  |
-| `operation.name` | string | The name of the operation. | `SecretGet`, `Microsoft.ApiManagement/GatewayLogs`, `ApplicationGatewayAccess` | `Required` |  |
-| `operation.version` | string | The version of the operation. | `1.0` | `Required` |  |
-| `properties` | keyvaluelist | The properties provided in the Azure Resource Log. | {
"statusCode": "Created",
"serviceRequestId": "50d5cddb-8ca0-47ad-9b80-6cde2207f97c"
} | `Required` |  |
-| `result.type` | string | The status associated with the logged event. | `Started`, `In Progress`, `Succeeded`, `Failed`, `Active`, `Resolved` | `Required` |  |
-| `result.signature` | string | The substatus of associated with the logged event. | `OK` | `Required` |  |
-| `result.description` | string | The description of the result. | `The operation was successful`, `The operation failed` | `Required` |  |
-| `tenant.id` | string | The tenant ID of the Active Directory tenant that this event is tied to. | `607964b6-41a5-4e24-a5db-db7aab3b9b34` | `Conditionally Required`: if the event is tied to an Active Directory tenant. |  |
-
-
-See [Azure Resource Log definition](/model/azure/logs.yaml) for the details.
-
[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/dotnet/dotnet-aspnetcore-metrics.md b/docs/dotnet/dotnet-aspnetcore-metrics.md
index 4593cede39..8b7cfdcb1a 100644
--- a/docs/dotnet/dotnet-aspnetcore-metrics.md
+++ b/docs/dotnet/dotnet-aspnetcore-metrics.md
@@ -108,8 +108,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[2]:** if and only if the exception was handled by this handler.
diff --git a/docs/exceptions/exceptions-spans.md b/docs/exceptions/exceptions-spans.md
index 4fd632587c..df00c1b87a 100644
--- a/docs/exceptions/exceptions-spans.md
+++ b/docs/exceptions/exceptions-spans.md
@@ -12,7 +12,7 @@ exceptions associated with spans.
- [Recording an Exception](#recording-an-exception)
-- [Attributes](#attributes)
+- [Exception event](#exception-event)
- [Stacktrace Representation](#stacktrace-representation)
@@ -38,10 +38,7 @@ try {
}
```
-## Attributes
-
-The table below indicates which attributes should be added to the `Event` and
-their types.
+## Exception event
@@ -50,8 +47,12 @@ their types.
+**Status:** 
+
The event name MUST be `exception`.
+This event describes a single exception.
+
| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
|---|---|---|---|---|---|
| [`exception.message`](/docs/attributes-registry/exception.md) | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` | `Conditionally Required` [1] |  |
diff --git a/docs/faas/faas-spans.md b/docs/faas/faas-spans.md
index 225bf960ce..a1cbce4b4c 100644
--- a/docs/faas/faas-spans.md
+++ b/docs/faas/faas-spans.md
@@ -57,13 +57,13 @@ so it may be necessary to set `cloud.resource_id` as a span attribute instead.
The exact value to use for `cloud.resource_id` depends on the cloud provider.
The following well-known definitions MUST be used if you set this attribute and they apply:
-* **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
+- **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Take care not to use the "invoked ARN" directly but replace any
[alias suffix](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)
with the resolved function version, as the same runtime instance may be invocable with
multiple different aliases.
-* **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
-* **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
+- **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
+- **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
*not* the function app, having the form
`/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/`.
This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share
diff --git a/docs/feature-flags/feature-flags-logs.md b/docs/feature-flags/feature-flags-logs.md
index f9c3bfa4eb..3ca0dff072 100644
--- a/docs/feature-flags/feature-flags-logs.md
+++ b/docs/feature-flags/feature-flags-logs.md
@@ -21,7 +21,7 @@ section of the trace semantic convention for feature flag evaluations.
- [Recording an Evaluation](#recording-an-evaluation)
-- [Attributes](#attributes)
+- [Evaluation event](#evaluation-event)
@@ -32,7 +32,7 @@ Feature flag evaluations SHOULD be recorded as attributes on the
operations. Evaluations MAY be recorded on "logs" or "events" depending on the
context.
-## Attributes
+## Evaluation event
The table below indicates which attributes should be added to the
[LogRecord](https://github.com/open-telemetry/opentelemetry-specification/tree/v1.37.0/specification/logs/data-model.md#log-and-event-record-definition) and their types.
@@ -44,8 +44,12 @@ The table below indicates which attributes should be added to the
+**Status:** 
+
The event name MUST be `feature_flag`.
+This event describes feature flag evaluation representation on a Log Record.
+
| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
|---|---|---|---|---|---|
| [`feature_flag.key`](/docs/attributes-registry/feature-flag.md) | string | The unique identifier of the feature flag. | `logo-color` | `Recommended` |  |
diff --git a/docs/feature-flags/feature-flags-spans.md b/docs/feature-flags/feature-flags-spans.md
index 842045e72e..8ca86c38b8 100644
--- a/docs/feature-flags/feature-flags-spans.md
+++ b/docs/feature-flags/feature-flags-spans.md
@@ -18,6 +18,7 @@ To record an evaluation outside of a transaction context, consider
- [Motivation](#motivation)
- [Overview](#overview)
- [Convention](#convention)
+ - [Evaluation event](#evaluation-event)
@@ -41,6 +42,8 @@ It's intended to be vendor neutral and provide flexibility for current and futur
A flag evaluation SHOULD be recorded as an Event on the span during which it occurred.
+### Evaluation event
+
@@ -48,8 +51,12 @@ A flag evaluation SHOULD be recorded as an Event on the span during which it occ
+**Status:** 
+
The event name MUST be `feature_flag`.
+This event describes feature flag evaluation.
+
| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
|---|---|---|---|---|---|
| [`feature_flag.key`](/docs/attributes-registry/feature-flag.md) | string | The unique identifier of the feature flag. | `logo-color` | `Required` |  |
diff --git a/docs/http/README.md b/docs/http/README.md
index 61c0beba0f..78ccc20348 100644
--- a/docs/http/README.md
+++ b/docs/http/README.md
@@ -44,4 +44,6 @@ Semantic conventions for HTTP are defined for the following signals:
* [HTTP Spans](http-spans.md): Semantic Conventions for HTTP client and server *spans*.
* [HTTP Metrics](http-metrics.md): Semantic Conventions for HTTP client and server *metrics*.
+For help migrating from non-stable to stable conventions, see [the migration guide](../non-normative/http-migration.md).
+
[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/messaging/azure-messaging.md b/docs/messaging/azure-messaging.md
index fcd5c05817..a848c559f4 100644
--- a/docs/messaging/azure-messaging.md
+++ b/docs/messaging/azure-messaging.md
@@ -66,8 +66,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[3]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
@@ -183,8 +183,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[3]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
diff --git a/docs/messaging/gcp-pubsub.md b/docs/messaging/gcp-pubsub.md
index 166f7cbcdc..867e1d78f0 100644
--- a/docs/messaging/gcp-pubsub.md
+++ b/docs/messaging/gcp-pubsub.md
@@ -63,8 +63,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[3]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
diff --git a/docs/messaging/kafka.md b/docs/messaging/kafka.md
index 3b1704af26..abb1d60028 100644
--- a/docs/messaging/kafka.md
+++ b/docs/messaging/kafka.md
@@ -64,8 +64,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[2]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
diff --git a/docs/messaging/messaging-metrics.md b/docs/messaging/messaging-metrics.md
index d116989b58..130ad1eca0 100644
--- a/docs/messaging/messaging-metrics.md
+++ b/docs/messaging/messaging-metrics.md
@@ -81,8 +81,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[3]:** Semantic conventions for individual messaging systems SHOULD document whether `messaging.consumer.group.name` is applicable and what it means in the context of that system.
@@ -187,8 +187,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[3]:** Destination name SHOULD uniquely identify a specific queue, topic or other entity within the broker. If
the broker doesn't have such notion, the destination name SHOULD uniquely identify the broker.
@@ -280,8 +280,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[3]:** Semantic conventions for individual messaging systems SHOULD document whether `messaging.consumer.group.name` is applicable and what it means in the context of that system.
@@ -380,8 +380,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[3]:** Semantic conventions for individual messaging systems SHOULD document whether `messaging.consumer.group.name` is applicable and what it means in the context of that system.
diff --git a/docs/messaging/messaging-spans.md b/docs/messaging/messaging-spans.md
index da3c82ec7e..6da85e1e8b 100644
--- a/docs/messaging/messaging-spans.md
+++ b/docs/messaging/messaging-spans.md
@@ -385,8 +385,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[3]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
diff --git a/docs/messaging/rabbitmq.md b/docs/messaging/rabbitmq.md
index 166bde5ce9..a0f9c1a62e 100644
--- a/docs/messaging/rabbitmq.md
+++ b/docs/messaging/rabbitmq.md
@@ -55,8 +55,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[2]:** Destination name SHOULD uniquely identify a specific queue, topic or other entity within the broker. If
the broker doesn't have such notion, the destination name SHOULD uniquely identify the broker.
diff --git a/docs/messaging/rocketmq.md b/docs/messaging/rocketmq.md
index 7d2fb86b2f..2ab018a776 100644
--- a/docs/messaging/rocketmq.md
+++ b/docs/messaging/rocketmq.md
@@ -60,8 +60,8 @@ If the operation has completed successfully, instrumentations SHOULD NOT set `er
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
-* Use a domain-specific attribute
-* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
**[2]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
diff --git a/docs/mobile/events.md b/docs/mobile/events.md
index c7d0ce4580..d9aa669fce 100644
--- a/docs/mobile/events.md
+++ b/docs/mobile/events.md
@@ -9,25 +9,16 @@ events on mobile platforms. All mobile events MUST use a namespace of
- [Lifecycle instrumentation](#lifecycle-instrumentation)
- - [Event details](#event-details)
+ - [Device app lifecycle event](#device-app-lifecycle-event)
## Lifecycle instrumentation
This section defines how to apply semantic conventions when instrumenting
-application lifecycle. This event is meant to be used in conjunction with
-`os.name` [resource semantic convention](/docs/resource/os.md) to identify the
-mobile operating system (e.g. Android, iOS).
+application lifecycle.
-The following table describes the payload fields that MUST
-be used to describe the state of the application at the time of the event.
-
-The `android.state` and `ios.state` fields are mutually exclusive and MUST
-NOT be used together, each field MUST be used with its corresponding
-`os.name` [resource semantic convention](/docs/resource/os.md) value.
-
-### Event details
+### Device app lifecycle event
@@ -36,45 +27,48 @@ NOT be used together, each field MUST be used with its corresponding
+**Status:** 
+
The event name MUST be `device.app.lifecycle`.
-
-
-
-
+This event represents an occurrence of a lifecycle transition on Android or iOS platform.
+
+The event body fields MUST be used to describe the state of the application at the time of the event.
+This event is meant to be used in conjunction with `os.name` [resource semantic convention](/docs/resource/os.md) to identify the mobile operating system (e.g. Android, iOS).
+The `android.state` and `ios.state` fields are mutually exclusive and MUST NOT be used together, each field MUST be used with its corresponding `os.name` value.
-
-| Body Field | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+**Body fields:**
+
+| Body Field | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
|---|---|---|---|---|---|
-| `android.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | `Conditionally Required`: if and only if `os.name` is `android` |  |
-| `ios.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [2] | `active` | `Conditionally Required`: if and only if `os.name` is `ios` |  |
+| `android.state` | enum | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | `Conditionally Required` if and only if `os.name` is `android` |  |
+| `ios.state` | enum | This attribute represents the state the application has transitioned into at the occurrence of the event. [2] | `active` | `Conditionally Required` if and only if `os.name` is `ios` |  |
**[1]:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), and from which the `OS identifiers` are derived.
**[2]:** The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate#1656902), and from which the `OS terminology` column values are derived.
-**Additional attribute requirements:** At least one of the following sets of attributes is required:
-
-* `ios.state`
-* `android.state`
-
`android.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
| Value | Description | Stability |
|---|---|---|
-| `created` | Any time before Activity.onResume() or, if the app has no Activity, Context.startService() has been called in the app for the first time. |  |
| `background` | Any time after Activity.onPause() or, if the app has no Activity, Context.stopService() has been called when the app was in the foreground state. |  |
+| `created` | Any time before Activity.onResume() or, if the app has no Activity, Context.startService() has been called in the app for the first time. |  |
| `foreground` | Any time after Activity.onResume() or, if the app has no Activity, Context.startService() has been called when the app was in either the created or background states. |  |
-`ios.state` MUST be one of the following:
+`ios.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
| Value | Description | Stability |
|---|---|---|
| `active` | The app has become `active`. Associated with UIKit notification `applicationDidBecomeActive`. |  |
-| `inactive` | The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. |  |
| `background` | The app is now in the background. This value is associated with UIKit notification `applicationDidEnterBackground`. |  |
| `foreground` | The app is now in the foreground. This value is associated with UIKit notification `applicationWillEnterForeground`. |  |
+| `inactive` | The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. |  |
| `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. |  |
-
+
+
+
+
+
[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/resource/cloud.md b/docs/resource/cloud.md
index 78e7556471..0749d14a85 100644
--- a/docs/resource/cloud.md
+++ b/docs/resource/cloud.md
@@ -35,13 +35,13 @@ so it may be necessary to set `cloud.resource_id` as a span attribute instead.
The exact value to use for `cloud.resource_id` depends on the cloud provider.
The following well-known definitions MUST be used if you set this attribute and they apply:
-* **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
+- **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Take care not to use the "invoked ARN" directly but replace any
[alias suffix](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)
with the resolved function version, as the same runtime instance may be invocable with
multiple different aliases.
-* **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
-* **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
+- **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
+- **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
*not* the function app, having the form
`/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/`.
This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share
diff --git a/docs/resource/deployment-environment.md b/docs/resource/deployment-environment.md
index 2ec939a2bd..2bb9e07e73 100644
--- a/docs/resource/deployment-environment.md
+++ b/docs/resource/deployment-environment.md
@@ -23,8 +23,8 @@ the `service.namespace`, `service.name` and `service.instance.id` resource attri
This implies that resources carrying the following attribute combinations MUST be
considered to be identifying the same service:
-* `service.name=frontend`, `deployment.environment.name=production`
-* `service.name=frontend`, `deployment.environment.name=staging`.
+- `service.name=frontend`, `deployment.environment.name=production`
+- `service.name=frontend`, `deployment.environment.name=staging`.
diff --git a/docs/resource/faas.md b/docs/resource/faas.md
index 06a9cc2310..accb79298d 100644
--- a/docs/resource/faas.md
+++ b/docs/resource/faas.md
@@ -39,7 +39,7 @@ For some cloud providers, the above definition is ambiguous. The following
definition of function name MUST be used for this attribute
(and consequently the span name) for the listed cloud providers/products:
-* **Azure:** The full name `/`, i.e., function app name
+- **Azure:** The full name `/`, i.e., function app name
followed by a forward slash followed by the function name (this form
can also be seen in the resource JSON for the function).
This means that a span attribute MUST be used, as an Azure function
@@ -52,31 +52,31 @@ so it may be necessary to set `cloud.resource_id` as a span attribute instead.
The exact value to use for `cloud.resource_id` depends on the cloud provider.
The following well-known definitions MUST be used if you set this attribute and they apply:
-* **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
+- **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Take care not to use the "invoked ARN" directly but replace any
[alias suffix](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)
with the resolved function version, as the same runtime instance may be invocable with
multiple different aliases.
-* **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
-* **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
+- **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
+- **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
*not* the function app, having the form
`/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/`.
This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share
a TracerProvider.
-**[3]:** * **AWS Lambda:** Use the (full) log stream name.
+**[3]:** - **AWS Lambda:** Use the (full) log stream name.
**[4]:** It's recommended to set this attribute since e.g. too little memory can easily stop a Java AWS Lambda function from working correctly. On AWS Lambda, the environment variable `AWS_LAMBDA_FUNCTION_MEMORY_SIZE` provides this information (which must be multiplied by 1,048,576).
**[5]:** Depending on the cloud provider and platform, use:
-* **AWS Lambda:** The [function version](https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html)
+- **AWS Lambda:** The [function version](https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html)
(an integer represented as a decimal string).
-* **Google Cloud Run (Services):** The [revision](https://cloud.google.com/run/docs/managing/revisions)
+- **Google Cloud Run (Services):** The [revision](https://cloud.google.com/run/docs/managing/revisions)
(i.e., the function name plus the revision suffix).
-* **Google Cloud Functions:** The value of the
+- **Google Cloud Functions:** The value of the
[`K_REVISION` environment variable](https://cloud.google.com/functions/docs/env-var#runtime_environment_variables_set_automatically).
-* **Azure Functions:** Not applicable. Do not set this attribute.
+- **Azure Functions:** Not applicable. Do not set this attribute.
diff --git a/docs/resource/k8s.md b/docs/resource/k8s.md
index df261fb05c..efbd40327f 100644
--- a/docs/resource/k8s.md
+++ b/docs/resource/k8s.md
@@ -52,9 +52,9 @@ UUIDs as standardized by
Which states:
> If generated according to one of the mechanisms defined in Rec.
- ITU-T X.667 | ISO/IEC 9834-8, a UUID is either guaranteed to be
- different from all other UUIDs generated before 3603 A.D., or is
- extremely likely to be different (depending on the mechanism chosen).
+> ITU-T X.667 | ISO/IEC 9834-8, a UUID is either guaranteed to be
+> different from all other UUIDs generated before 3603 A.D., or is
+> extremely likely to be different (depending on the mechanism chosen).
Therefore, UIDs between clusters should be extremely unlikely to
conflict.
diff --git a/docs/rpc/rpc-spans.md b/docs/rpc/rpc-spans.md
index c4fab776f0..bb6b08b36c 100644
--- a/docs/rpc/rpc-spans.md
+++ b/docs/rpc/rpc-spans.md
@@ -19,6 +19,7 @@ This document defines how to describe remote procedure calls
- [Client attributes](#client-attributes)
- [Server attributes](#server-attributes)
- [Events](#events)
+ - [Message event](#message-event)
- [Distinction from HTTP spans](#distinction-from-http-spans)
- [Semantic Conventions for specific RPC technologies](#semantic-conventions-for-specific-rpc-technologies)
@@ -242,9 +243,7 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
### Events
-In the lifetime of an RPC stream, an event for each message sent/received on
-client and server spans SHOULD be created. In case of unary calls only one sent
-and one received message will be recorded for both client and server spans.
+#### Message event
@@ -253,8 +252,14 @@ and one received message will be recorded for both client and server spans.
+**Status:** 
+
The event name MUST be `rpc.message`.
+Describes a message sent or received within the context of an RPC call.
+
+In the lifetime of an RPC stream, an event for each message sent/received on client and server spans SHOULD be created. In case of unary calls only one sent and one received message will be recorded for both client and server spans.
+
| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
|---|---|---|---|---|---|
| [`rpc.message.compressed_size`](/docs/attributes-registry/rpc.md) | int | Compressed size of the message in bytes. | | `Recommended` |  |
diff --git a/model/azure/logs.yaml b/model/azure/logs.yaml
index da061e5f31..4a5e3fc22a 100644
--- a/model/azure/logs.yaml
+++ b/model/azure/logs.yaml
@@ -12,91 +12,79 @@ groups:
- ref: cloud.resource_id
brief: The [Fully Qualified Azure Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) the log is emitted for.
note: ""
- - ref: event.name
- # Future Note: When the build tools support this definition please uncomment and validate the details
- # included here and what has been added to the manual markdown table
- # body:
- # fields:
- # - id: category
- # type: string
- # stability: experimental
- # brief: "The Azure category of the log entry."
- # examples:
- # - AuditEvent
- # - GatewayLogs
- # - ApplicationGatewayAccessLog
- # - id: correlation.id
- # type: string
- # stability: experimental
- # brief: "The correlation ID of the log entry."
- # examples:
- # - 607964b6-41a5-4e24-a5db-db7aab3b9b34
- # - id: duration
- # type: int
- # stability: experimental
- # brief: "The duration of the operations in milliseconds."
- # examples:
- # - 1000
- # - id: identity
- # type: string
- # stability: experimental
- # brief: >
- # "A JSON blob that describes the identity of the user or application that performed the operation."
- # note: >
- # Typically, this field includes the authorization and claims or JWT token from Active Directory.
- # > Warning:
- # > this field contains sensitive (PII) information."
- # requirement_level: opt-in
- # examples:
- # - "someone"
- # - id: operation.name
- # type: string
- # stability: experimental
- # brief: "The name of the operation."
- # examples:
- # - SecretGet
- # - Microsoft.ApiManagement/GatewayLogs
- # - ApplicationGatewayAccess
- # - id: operation.version
- # type: string
- # stability: experimental
- # brief: "The version of the operation."
- # examples:
- # - "1.0"
- # - id: properties
- # type: KeyValueList # note: this is not a supported type in the current build tools
- # stability: experimental
- # brief: "The properties provided in the Azure Resource Log."
- # examples: {
"statusCode": "Created",
"serviceRequestId": "50d5cddb-8ca0-47ad-9b80-6cde2207f97c"
}
- # - id: result.type
- # type: string
- # stability: experimental
- # brief: "The status associated with the logged event."
- # examples:
- # - "Started"
- # - "In Progress"
- # - "Succeeded"
- # - "Failed"
- # - "Active"
- # - "Resolved"
- # - id: result.signature
- # type: string
- # stability: experimental
- # brief: "The substatus of associated with the logged event. "
- # examples:
- # - "OK"
- # - id: result.description
- # type: string
- # stability: experimental
- # brief: "The description of the result."
- # examples:
- # - "The operation was successful"
- # - "The operation failed"
- # - id: tenant.id
- # type: string
- # stability: experimental
- # brief: "The tenant ID of the Active Directory tenant that this event is tied to."
- # requirement_level:
- # conditionally_required: "if the event is tied to an Active Directory tenant."
- # examples:
- # - "00000000-0000-0000-0000-000000000000"
+ body:
+ id: az.resource.log
+ requirement_level: recommended
+ type: map
+ fields:
+ - id: category
+ type: string
+ stability: experimental
+ brief: "The Azure category of the log entry."
+ requirement_level: recommended
+ examples: ["AuditEvent", "GatewayLogs", "ApplicationGatewayAccessLog"]
+ - id: correlation.id
+ type: string
+ requirement_level: recommended
+ stability: experimental
+ brief: "The correlation ID of the log entry."
+ examples: ["607964b6-41a5-4e24-a5db-db7aab3b9b34"]
+ - id: duration
+ type: int
+ stability: experimental
+ requirement_level: recommended
+ brief: "The duration of the operations in milliseconds."
+ examples: [1000]
+ - id: identity
+ type: undefined
+ stability: experimental
+ brief: >
+ "A JSON blob that describes the identity of the user or application that performed the operation."
+ note: |
+ Typically, this field includes the authorization and claims or JWT token from Active Directory.
+
+ > [!Warning]
+ > This field contains sensitive (PII) information.
+ requirement_level: opt_in
+ - id: operation.name
+ type: string
+ stability: experimental
+ requirement_level: recommended
+ brief: "The name of the operation."
+ examples: ["SecretGet", "Microsoft.ApiManagement/GatewayLogs", "ApplicationGatewayAccess"]
+ - id: operation.version
+ type: string
+ stability: experimental
+ requirement_level: recommended
+ brief: "The version of the operation."
+ examples: ["1.0"]
+ - id: properties
+ type: undefined
+ requirement_level: recommended
+ stability: experimental
+ brief: The properties provided in the Azure Resource Log.
+ - id: result.type
+ type: string
+ stability: experimental
+ requirement_level: recommended
+ brief: The status associated with the logged event.
+ examples: ["Succeeded", "Failed", "Started"]
+ - id: result.signature
+ type: string
+ stability: experimental
+ requirement_level: recommended
+ brief: The substatus of associated with the logged event.
+ examples: ["OK"]
+ - id: result.description
+ type: string
+ stability: experimental
+ requirement_level: recommended
+ brief: "The description of the result."
+ examples: ["The operation was successful", "The operation failed"]
+ - id: tenant.id
+ type: string
+ stability: experimental
+ brief: "The tenant ID of the Active Directory tenant that this event is tied to."
+ requirement_level:
+ conditionally_required: "if the event is tied to an Active Directory tenant."
+ examples: ["00000000-0000-0000-0000-000000000000"]
diff --git a/model/cloud/registry.yaml b/model/cloud/registry.yaml
index 4390eebc4e..906092d52c 100644
--- a/model/cloud/registry.yaml
+++ b/model/cloud/registry.yaml
@@ -73,13 +73,13 @@ groups:
The exact value to use for `cloud.resource_id` depends on the cloud provider.
The following well-known definitions MUST be used if you set this attribute and they apply:
- * **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
+ - **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Take care not to use the "invoked ARN" directly but replace any
[alias suffix](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)
with the resolved function version, as the same runtime instance may be invocable with
multiple different aliases.
- * **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
- * **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
+ - **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
+ - **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
*not* the function app, having the form
`/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/`.
This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share
diff --git a/model/deployment/registry.yaml b/model/deployment/registry.yaml
index 38d35300a4..492d2e4dad 100644
--- a/model/deployment/registry.yaml
+++ b/model/deployment/registry.yaml
@@ -43,6 +43,6 @@ groups:
This implies that resources carrying the following attribute combinations MUST be
considered to be identifying the same service:
- * `service.name=frontend`, `deployment.environment.name=production`
- * `service.name=frontend`, `deployment.environment.name=staging`.
+ - `service.name=frontend`, `deployment.environment.name=production`
+ - `service.name=frontend`, `deployment.environment.name=staging`.
examples: ["staging", "production"]
diff --git a/model/device/events.yaml b/model/device/events.yaml
index 6b980e0334..36f4f9885f 100644
--- a/model/device/events.yaml
+++ b/model/device/events.yaml
@@ -6,9 +6,16 @@ groups:
brief: >
This event represents an occurrence of a lifecycle transition on Android or iOS platform.
note: >
- This event identifies the fields that are common to all lifecycle events for android and iOS using
- the `android.state` and `ios.state` fields. The `android.state` and `ios.state` attributes are
- mutually exclusive.
+ The event body fields MUST be used to describe the state of the application
+ at the time of the event.
+
+ This event is meant to be used in conjunction with `os.name`
+ [resource semantic convention](/docs/resource/os.md) to identify the
+ mobile operating system (e.g. Android, iOS).
+
+ The `android.state` and `ios.state` fields are mutually exclusive and MUST
+ NOT be used together, each field MUST be used with its corresponding
+ `os.name` value.
body:
id: device_lifecycle_state
type: map
diff --git a/model/error/registry.yaml b/model/error/registry.yaml
index 35f8b57222..4746c89c83 100644
--- a/model/error/registry.yaml
+++ b/model/error/registry.yaml
@@ -35,5 +35,5 @@ groups:
If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
it's RECOMMENDED to:
- * Use a domain-specific attribute
- * Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+ - Use a domain-specific attribute
+ - Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
diff --git a/model/event/common.yaml b/model/event/common.yaml
index b07e25a8df..8e68c5a909 100644
--- a/model/event/common.yaml
+++ b/model/event/common.yaml
@@ -1,6 +1,7 @@
groups:
- id: event
type: attribute_group
+ stability: experimental
brief: >
This document defines attributes for Events represented using Log Records.
attributes:
diff --git a/model/exceptions/events.yaml b/model/exceptions/events.yaml
index 4078f07155..88ff5f3872 100644
--- a/model/exceptions/events.yaml
+++ b/model/exceptions/events.yaml
@@ -1,10 +1,10 @@
groups:
- id: trace-exception
name: exception
+ stability: stable
type: event
brief: >
- This document defines the attributes used to
- report a single exception associated with a span.
+ This event describes a single exception.
attributes:
- ref: exception.type
requirement_level:
diff --git a/model/faas/registry.yaml b/model/faas/registry.yaml
index 4d3e4d0eb1..89691eac06 100644
--- a/model/faas/registry.yaml
+++ b/model/faas/registry.yaml
@@ -20,7 +20,7 @@ groups:
definition of function name MUST be used for this attribute
(and consequently the span name) for the listed cloud providers/products:
- * **Azure:** The full name `/`, i.e., function app name
+ - **Azure:** The full name `/`, i.e., function app name
followed by a forward slash followed by the function name (this form
can also be seen in the resource JSON for the function).
This means that a span attribute MUST be used, as an Azure function
@@ -34,13 +34,13 @@ groups:
note: |
Depending on the cloud provider and platform, use:
- * **AWS Lambda:** The [function version](https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html)
+ - **AWS Lambda:** The [function version](https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html)
(an integer represented as a decimal string).
- * **Google Cloud Run (Services):** The [revision](https://cloud.google.com/run/docs/managing/revisions)
+ - **Google Cloud Run (Services):** The [revision](https://cloud.google.com/run/docs/managing/revisions)
(i.e., the function name plus the revision suffix).
- * **Google Cloud Functions:** The value of the
+ - **Google Cloud Functions:** The value of the
[`K_REVISION` environment variable](https://cloud.google.com/functions/docs/env-var#runtime_environment_variables_set_automatically).
- * **Azure Functions:** Not applicable. Do not set this attribute.
+ - **Azure Functions:** Not applicable. Do not set this attribute.
examples: ['26', 'pinkfroid-00002']
- id: faas.instance
type: string
@@ -49,7 +49,7 @@ groups:
The execution environment ID as a string, that will be potentially reused
for other invocations to the same function/function version.
note: >
- * **AWS Lambda:** Use the (full) log stream name.
+ - **AWS Lambda:** Use the (full) log stream name.
examples: ['2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de']
- id: faas.max_memory
type: int
diff --git a/model/feature-flag/events.yaml b/model/feature-flag/events.yaml
index 8aae493385..0248d07cef 100644
--- a/model/feature-flag/events.yaml
+++ b/model/feature-flag/events.yaml
@@ -1,10 +1,10 @@
groups:
- id: feature_flag
type: event
+ stability: experimental
name: feature_flag
brief: >
- This semantic convention defines the attributes used to represent a
- feature flag evaluation as an event.
+ This event describes feature flag evaluation.
attributes:
- ref: feature_flag.key
requirement_level: required
diff --git a/model/feature-flag/logs.yaml b/model/feature-flag/logs.yaml
index 4530096de7..030c0c11a4 100644
--- a/model/feature-flag/logs.yaml
+++ b/model/feature-flag/logs.yaml
@@ -1,10 +1,10 @@
groups:
- id: log-feature_flag
type: event
+ stability: experimental
name: feature_flag
brief: >
- This document defines attributes for feature flag evaluations
- represented using Log Records.
+ This event describes feature flag evaluation representation on a Log Record.
attributes:
- ref: feature_flag.key
- ref: feature_flag.provider_name
diff --git a/model/feature-flag/registry.yaml b/model/feature-flag/registry.yaml
index 1533d685ec..380ef79d5f 100644
--- a/model/feature-flag/registry.yaml
+++ b/model/feature-flag/registry.yaml
@@ -1,6 +1,7 @@
groups:
- id: registry.feature_flag
type: attribute_group
+ stability: experimental
display_name: Feature Flag Attributes
brief: >
This document defines attributes for Feature Flags.
diff --git a/model/k8s/registry.yaml b/model/k8s/registry.yaml
index 6767f3575e..e1e0107fcc 100644
--- a/model/k8s/registry.yaml
+++ b/model/k8s/registry.yaml
@@ -34,9 +34,9 @@ groups:
Which states:
> If generated according to one of the mechanisms defined in Rec.
- ITU-T X.667 | ISO/IEC 9834-8, a UUID is either guaranteed to be
- different from all other UUIDs generated before 3603 A.D., or is
- extremely likely to be different (depending on the mechanism chosen).
+ > ITU-T X.667 | ISO/IEC 9834-8, a UUID is either guaranteed to be
+ > different from all other UUIDs generated before 3603 A.D., or is
+ > extremely likely to be different (depending on the mechanism chosen).
Therefore, UIDs between clusters should be extremely unlikely to
conflict.
diff --git a/model/rpc/spans.yaml b/model/rpc/spans.yaml
index caf7a2747d..07e418d069 100644
--- a/model/rpc/spans.yaml
+++ b/model/rpc/spans.yaml
@@ -100,8 +100,13 @@ groups:
- id: rpc.message
type: event
+ stability: experimental
name: rpc.message
- brief: "RPC received/sent message."
+ brief: Describes a message sent or received within the context of an RPC call.
+ note: >
+ In the lifetime of an RPC stream, an event for each message sent/received on
+ client and server spans SHOULD be created. In case of unary calls only one sent
+ and one received message will be recorded for both client and server spans.
attributes:
- ref: rpc.message.type
requirement_level: recommended
diff --git a/policies/yaml_schema.rego b/policies/yaml_schema.rego
index 4d09e4d594..c8e40680c6 100644
--- a/policies/yaml_schema.rego
+++ b/policies/yaml_schema.rego
@@ -48,6 +48,18 @@ deny[yaml_schema_violation(description, group.id, name)] {
description := sprintf("Event name '%s' is invalid. Event name %s'", [name, invalid_name_helper])
}
+# checks event.name is not referenced in event attributes
+deny[yaml_schema_violation(description, group.id, name)] {
+ group := input.groups[_]
+ group.type == "event"
+ name := group.name
+
+ attr := group.attributes[_]
+ attr.ref == "event.name"
+
+ description := sprintf("Attribute 'event.name' is referenced on event group '%s'. Event name must be provided in 'name' property on the group", [name])
+}
+
# require resources have names
deny[yaml_schema_violation(description, group.id, "")] {
group := input.groups[_]
diff --git a/policies/yaml_schema_test.rego b/policies/yaml_schema_test.rego
index 4a506835e7..a6d135f9d7 100644
--- a/policies/yaml_schema_test.rego
+++ b/policies/yaml_schema_test.rego
@@ -24,6 +24,14 @@ test_fails_on_invalid_event_name if {
}
}
+test_fails_on_referenced_event_name_on_event if {
+ event := [{ "id": "yaml_schema.test",
+ "type": "event",
+ "name": "foo",
+ "attributes": [{"ref": "event.name"}]}]
+ count(deny) == 1 with input as {"groups": event}
+}
+
test_fails_on_invalid_resource_name if {
every name in invalid_names {
count(deny) >= 1 with input as {"groups": create_resource(name)}
diff --git a/templates/registry/markdown/attribute_macros.j2 b/templates/registry/markdown/attribute_macros.j2
index 7ac1d474c0..be39fd1a29 100644
--- a/templates/registry/markdown/attribute_macros.j2
+++ b/templates/registry/markdown/attribute_macros.j2
@@ -1,3 +1,4 @@
+{% import 'examples_macros.j2' as examples %}
{% macro type(attribute) %}{%- if attribute.type is mapping %}
{%- if attribute.type.members[0].value is string %}string{%- endif %}
{%- if attribute.type.members[0].value is int %}int{%- endif %}
@@ -19,22 +20,6 @@
{% macro name_with_link(attribute, attribute_registry_base_url, lineage_attributes) %}[{{name(attribute)}}]({{attribute_registry_base_url}}/{{ find_lineage(attribute.name, lineage_attributes) | split_id | list | reject("eq", "registry")| first | kebab_case }}.md){% endmacro %}
-{% macro print_examples(examples) %}{%- for e in examples %}{%if loop.first == false %}; {% endif %}`{{ e | trim }}`{%- endfor %}{% endmacro %}
-
-{% macro examples(attribute) %}{%- if attribute.examples %}
-{%- if "[]" in attribute.type and "template" not in attribute.type %}
-{%- if attribute.examples is sequence %}
-{%- if attribute.examples | select("sequence") | length == 0 %}`{{ attribute.examples | trim }}`
-{%- else %}{{ print_examples(attribute.examples) }}
-{%- endif %}
-{%- else %}`[{{ attribute.examples | trim }}]`
-{%- endif %}
-{%- elif attribute.examples is sequence %}{{ print_examples(attribute.examples) }}
-{%- else %}`{{ attribute.examples | trim }}`
-{%- endif %}{%- elif attribute.type is mapping %}
-{%- for e in attribute.type.members %}{% if loop.index0 < 3 %}{% if loop.first == false %}; {% endif %}`{{ e.value | trim }}`{% endif %}{%- endfor %}
-{%- endif %}{% endmacro %}
-
{% macro display_name(group) %}
{%- if 'display_name' in group %}{{ group.display_name }}
{%- else %}{{ group.id | split_id | list | reject("eq", "registry") | join(" ") | title_case | acronym }} Attributes
diff --git a/templates/registry/markdown/attribute_namespace.md.j2 b/templates/registry/markdown/attribute_namespace.md.j2
index ca2980520b..ed8fc1c654 100644
--- a/templates/registry/markdown/attribute_namespace.md.j2
+++ b/templates/registry/markdown/attribute_namespace.md.j2
@@ -3,15 +3,16 @@
{#- - id: The top-level namespace id. -#}
{#- - groups: A sequence of all attribute groups under this namespace. -#}
{#- This includes deprecated groups. -#}
-{% import 'stability.j2' as stability %}
-{% import 'notes.j2' as notes %}
-{% import 'enum_macros.j2' as enums %}
-{% import 'attribute_macros.j2' as attrs %}
+{%- import 'stability.j2' as stability -%}
+{%- import 'notes.j2' as notes -%}
+{%- import 'enum_macros.j2' as enums -%}
+{%- import 'attribute_macros.j2' as attrs -%}
+{%- import 'examples_macros.j2' as examples -%}
{%- set my_file_name = ctx.id | lower | kebab_case ~ ".md" -%}
{{- template.set_file_name(my_file_name) -}}
{%- set groups = namespace(deprecated=[], non_deprecated=[]) -%}
-{% for group in ctx.groups | sort(attribute="id") %}
-{% if group.id[-10:] == "deprecated" %}
+{%- for group in ctx.groups | sort(attribute="id") -%}
+{%- if group.id[-10:] == "deprecated" -%}
{%- set groups.deprecated = groups.deprecated + [group] -%}
{%- else -%}
{%- set groups.non_deprecated = groups.non_deprecated + [group] -%}
@@ -27,23 +28,27 @@
# {{ ctx.id | title_case | acronym }}
-{%- if attr_groups | length > 1 %}{% for group in attr_groups %}
+{%- if attr_groups | length > 1 %}
+{% for group in attr_groups %}
- [{{ attrs.display_name(group) }}](#{{ attrs.heading_link_fragments(attrs.display_name(group)) }})
-{%- endfor -%}{%- endif -%}
-
+{%- endfor -%}
+{%- endif %}
{% for group in attr_groups %}
## {{ attrs.display_name(group) }}
+{% if group.brief.endswith("\n") -%}
{{ group.brief }}
-
-| Attribute | Type | Description | Examples | Stability |
+{% else -%}
+{{ group.brief }}
+{{"\n"}}
+{%- endif -%}
+| Attribute | Type | Description | Examples | Stability |
|---|---|---|---|---|
-{%- for attribute in group.attributes | sort(attribute="name") %}
-| {{ attrs.name(attribute) }} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add(attribute.note) }} | {{ attrs.examples(attribute) | trim }} | {{ stability.badge(attribute.stability, attribute.deprecated) | trim }} |
+{%- for attribute in group.attributes | sort(attribute="name") %}{% set attr_anchor = attribute.name | kebab_case %}
+| {{ attrs.name(attribute) }} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add(attribute.note) }} | {{ examples.format(attribute) | trim }} | {{ stability.badge(attribute.stability, attribute.deprecated) | trim }} |
{%- endfor %}
-
{{ notes.render() }}
-{% for enum in group.attributes | sort(attribute="name") %}
+{%- for enum in group.attributes | sort(attribute="name") %}
{%- if enum.type is mapping -%}{{ enums.table(enum, notes) }}{% endif %}
{%- endfor -%}
{%- endfor -%}
diff --git a/templates/registry/markdown/attribute_table.j2 b/templates/registry/markdown/attribute_table.j2
index e80c3669fe..795512fdf2 100644
--- a/templates/registry/markdown/attribute_table.j2
+++ b/templates/registry/markdown/attribute_table.j2
@@ -4,9 +4,10 @@
{% import 'attribute_macros.j2' as attrs %}
{% import 'enum_macros.j2' as enums %}
{% import 'sampling_macros.j2' as sampling %}
+{% import 'examples_macros.j2' as examples %}
{#- Macro for creating attribute table -#}
{% macro generate(attributes, tag_filter, attribute_registry_base_url, lineage_attributes) %}{% if (tag_filter | length == 0) %}{% set filtered_attributes = attributes %}{% else %}{% set filtered_attributes = attributes | selectattr("tag", "in", tag_filter) %}{% endif %}{% if filtered_attributes | length > 0 %}| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
|---|---|---|---|---|---|
-{% for attribute in filtered_attributes | attribute_sort %}| {{ attrs.name_with_link(attribute, attribute_registry_base_url, lineage_attributes) }} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add(attribute.note) }} | {{ attrs.examples(attribute) | trim }} | {{ requirement.render(attribute.requirement_level, notes) | trim }} | {{ stability.badge(attribute.stability, attribute.deprecated) | trim }} |
+{% for attribute in filtered_attributes | attribute_sort %}| {{ attrs.name_with_link(attribute, attribute_registry_base_url, lineage_attributes) }} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add(attribute.note) }} | {{ examples.format(attribute) | trim }} | {{ requirement.render(attribute.requirement_level, notes) | trim }} | {{ stability.badge(attribute.stability, attribute.deprecated) | trim }} |
{% endfor %}{{ notes.render() }}{{ sampling.snippet(filtered_attributes, attribute_registry_base_url, lineage_attributes) }}{{ enums.tables(filtered_attributes | selectattr("type", "mapping"), notes) }}
{% endif %}{% endmacro %}
diff --git a/templates/registry/markdown/body_field_table.j2 b/templates/registry/markdown/body_field_table.j2
new file mode 100644
index 0000000000..af1ec232c5
--- /dev/null
+++ b/templates/registry/markdown/body_field_table.j2
@@ -0,0 +1,15 @@
+{% import 'requirement.j2' as requirement %}
+{% import 'stability.j2' as stability %}
+{% import 'notes.j2' as notes %}
+{% import 'enum_macros.j2' as enums %}
+{% import 'examples_macros.j2' as examples %}
+{% macro flatten(fields, ns, depth) %}{% if fields %}{% for f in fields | sort(attribute="id") %}
+{% set ns.flat = [ns.flat, [{'field':f,'depth':depth}]] | flatten %}{% if f.fields %}{% set _= flatten(f.fields, ns, depth + 1) %}{% endif %}
+{% endfor %}{% endif %}{% endmacro %}
+{% macro field_name(field, depth) %}{% set name= " " * 2 * depth ~ '`' ~ field.id ~ '`' %}{% if field.type == "map" %}{{ name ~ ":"}}{% else %}{{ name }}{% endif %}{% endmacro %}
+{#- Macro for creating body table -#}
+{% macro generate(fields) %}{% if (fields | length > 0) %}{% set ns = namespace(flat=[])%}{% set _ = flatten(fields, ns, 0) %}| Body Field | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+{% for f in ns.flat %}| {{ field_name(f.field, f.depth) }} | {{ f.field.type }} | {{ f.field.brief | trim }}{{ notes.add(f.field.note) }} | {{ examples.format(f.field) | trim }} | {{ requirement.render(f.field.requirement_level, notes) | trim }} | {{ stability.badge(f.field.stability, f.field.deprecated) | trim }} |
+{% endfor %}{{ notes.render() }}{{ enums.field_tables(ns.flat | map(attribute="field") | selectattr("type", "eq", "enum"), notes) -}}
+{%- endif %}{% endmacro %}
diff --git a/templates/registry/markdown/enum_macros.j2 b/templates/registry/markdown/enum_macros.j2
index 4ffc10cbf0..6ad5288a78 100644
--- a/templates/registry/markdown/enum_macros.j2
+++ b/templates/registry/markdown/enum_macros.j2
@@ -13,3 +13,16 @@
{% for enum in enums | sort(attribute="name") -%}
{{ table(enum, notes) -}}
{% endfor %}{% endmacro %}
+{% macro field_table(enum, notes) %}
+`{{enum.id}}` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+{% for espec in enum.members | sort(attribute='value') %}
+{%- if filter(espec) == "True" -%}
+| `{{ espec.value }}` | {{ (espec.brief or espec.id) | trim }}{{ notes.add(espec.note) }} | {{ stability.badge(espec.stability, espec.deprecated) }} |
+{% endif %}{% endfor %}{{ notes.render() }}{% endmacro %}
+{% macro field_tables(enums, notes) -%}
+{% for enum in enums | sort(attribute="id") -%}
+{{ field_table(enum, notes) -}}
+{% endfor %}{% endmacro %}
\ No newline at end of file
diff --git a/templates/registry/markdown/event_macros.j2 b/templates/registry/markdown/event_macros.j2
index 1b03019e05..c6ef8ef6fa 100644
--- a/templates/registry/markdown/event_macros.j2
+++ b/templates/registry/markdown/event_macros.j2
@@ -1,4 +1,16 @@
{#- Macros for simplifying creating "Event" documentation. -#}
-{% macro header(event) %}{% if event.name %}The event name MUST be `{{ event.name }}`.
+{% import 'stability.j2' as stability %}
+{% import 'body_field_table.j2' as body_table %}
+{% macro header(event) %}**Status:** {{ stability.badge(event.stability, event.deprecated) }}
+The event name MUST be `{{ event.name }}`.
+
+{{ event.brief | trim }}
+{%if event.note %}
+{{ event.note | trim }}
+{% endif %}
+{% endmacro %}
+{% macro body(body) %}{% if body %}**Body fields:**
+
+{{ body_table.generate(body.fields) }}
{% endif %}{% endmacro %}
diff --git a/templates/registry/markdown/examples_macros.j2 b/templates/registry/markdown/examples_macros.j2
new file mode 100644
index 0000000000..bbd840d67f
--- /dev/null
+++ b/templates/registry/markdown/examples_macros.j2
@@ -0,0 +1,17 @@
+{% macro print_examples(examples) %}{%- for e in examples %}{%if loop.first == false %}; {% endif %}`{{ e | trim }}`{%- endfor %}{% endmacro %}
+
+{% macro format(item) %}{%- if item.examples %}
+{%- if "[]" in item.type and "template" not in item.type %}
+{%- if item.examples is sequence %}
+{%- if item.examples | select("sequence") | length == 0 %}`{{ item.examples | trim }}`
+{%- else %}{{ print_examples(item.examples) }}
+{%- endif %}
+{%- else %}`[{{ item.examples | trim }}]`
+{%- endif %}
+{%- elif item.examples is sequence %}{{ print_examples(item.examples) }}
+{%- else %}`{{ item.examples | trim }}`
+{%- endif %}{%- elif item.type is mapping %}
+{%- for e in item.type.members %}{% if loop.index0 < 3 %}{% if loop.first == false %}; {% endif %}`{{ e.value | trim }}`{% endif %}{%- endfor %}
+{%- elif item.type == "enum" -%}
+{%- for e in item.members %}{% if loop.index0 < 3 %}{% if loop.first == false %}; {% endif %}`{{ e.value | trim }}`{% endif %}{%- endfor %}
+{%- endif %}{% endmacro %}
diff --git a/templates/registry/markdown/readme.md.j2 b/templates/registry/markdown/readme.md.j2
index 256b7c6f82..14438da535 100644
--- a/templates/registry/markdown/readme.md.j2
+++ b/templates/registry/markdown/readme.md.j2
@@ -36,5 +36,5 @@ Currently, the following namespaces exist:
{%- set my_file_name = bundle.id | kebab_case ~ ".md" -%}
- [{{ bundle.id | title_case | acronym }}]({{ my_file_name }})
{% endfor %}
-
[developers recommendations]: ../general/attribute-naming.md#recommendations-for-application-developers
+
diff --git a/templates/registry/markdown/snippet.md.j2 b/templates/registry/markdown/snippet.md.j2
index 4751cc65bf..6b225c8119 100644
--- a/templates/registry/markdown/snippet.md.j2
+++ b/templates/registry/markdown/snippet.md.j2
@@ -8,14 +8,25 @@
{%- import 'event_macros.j2' as event -%}
{%- import 'resource_macros.j2' as resource %}
+{% macro generate_event(group) -%}
+{{ event.header(group) }}{{ generate_attributes(group) }}{{ event.body(group.body) }}{% endmacro -%}
+{%- macro generate_resource(group) -%}
+{{ resource.header(group) }}{{ generate_attributes(group) }}{% endmacro -%}
+{%- macro generate_metric(group) -%}
+{{ mt.generate(group) }}
+{{ generate_attributes(group) }}{% endmacro -%}
+{%- macro generate_attributes(group) -%}
+{{ at.generate(group.attributes, tag_filter, attribute_registry_base_url, group.lineage.attributes) }}{% endmacro -%}
+
{% if group.type == "event" -%}
-{{ event.header(group) }}
+{{ generate_event(group) -}}
{%- elif group.type == "resource" -%}
-{{ resource.header(group) }}
-{%- elif group.type=="metric" -%}
-{{ mt.generate(group) }}
+{{ generate_resource(group) }}
+{%- elif group.type == "metric" -%}
+{{ generate_metric(group) }}
+{%- else -%}
+{{ generate_attributes(group) -}}
{% endif -%}
-{{ at.generate(group.attributes, tag_filter, attribute_registry_base_url, group.lineage.attributes) -}}