diff --git a/docs/exceptions/exceptions-spans.md b/docs/exceptions/exceptions-spans.md
index 3fcc788a4a..89bbb9fb96 100644
--- a/docs/exceptions/exceptions-spans.md
+++ b/docs/exceptions/exceptions-spans.md
@@ -37,13 +37,20 @@ This event describes a single exception.
|---|---|---|---|---|---|
| [`exception.message`](/docs/registry/attributes/exception.md) |  | `Conditionally Required` [1] | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` |
| [`exception.type`](/docs/registry/attributes/exception.md) |  | `Conditionally Required` [2] | 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` |
-| [`exception.escaped`](/docs/registry/attributes/exception.md) | 
It's no longer recommended to record exceptions that are handled and do not escape the scope of a span. | `Recommended` | boolean | Indicates that the exception is escaping the scope of the span. | |
| [`exception.stacktrace`](/docs/registry/attributes/exception.md) |  | `Recommended` | 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)` |
**[1] `exception.message`:** Required if `exception.type` is not set, recommended otherwise.
**[2] `exception.type`:** Required if `exception.message` is not set, recommended otherwise.
+
+Deprecated Attributes:
+
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
+|---|---|---|---|---|
+| [`exception.escaped`](/docs/registry/attributes/exception.md) | boolean | Indicates that the exception is escaping the scope of the span. | | It's no longer recommended to record exceptions that are handled and do not escape the scope of a span. |
+
+
diff --git a/docs/registry/attributes/android.md b/docs/registry/attributes/android.md
index 687121360e..04960505e6 100644
--- a/docs/registry/attributes/android.md
+++ b/docs/registry/attributes/android.md
@@ -3,9 +3,6 @@
# Android
-- [Android Attributes](#android-attributes)
-- [Deprecated Android Attributes](#deprecated-android-attributes)
-
## Android Attributes
The Android platform on which the Android application is running.
@@ -29,15 +26,12 @@ The Android platform on which the Android application is running.
| `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. |  |
-## Deprecated Android Attributes
-
-This document defines attributes that represents an occurrence of a lifecycle transition on the Android platform.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `android.state` | 
Replaced by `android.app.state`. | string | Deprecated. Use `android.app.state` attribute instead. | `created`; `background`; `foreground` |
+| `android.state` | string | Deprecated. Use `android.app.state` attribute instead. | `created`; `background`; `foreground` | Use `android.app.state` instead. |
---
@@ -48,3 +42,5 @@ This document defines attributes that represents an occurrence of a lifecycle tr
| `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/registry/attributes/azure.md b/docs/registry/attributes/azure.md
index 2f681c3b8e..42e4a84b72 100644
--- a/docs/registry/attributes/azure.md
+++ b/docs/registry/attributes/azure.md
@@ -61,9 +61,12 @@ This section defines attributes for Azure Cosmos DB.
This section describes deprecated Azure attributes.
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `az.namespace` | 
Replaced by `azure.resource_provider.namespace`. | string | Deprecated, use `azure.resource_provider.namespace` instead. | `Microsoft.Storage`; `Microsoft.KeyVault`; `Microsoft.ServiceBus` |
-| `az.service_request_id` | 
Replaced by `azure.service.request.id`. | string | Deprecated, use `azure.service.request.id` instead. | `00000000-0000-0000-0000-000000000000` |
+| `az.namespace` | string | Deprecated, use `azure.resource_provider.namespace` instead. | `Microsoft.Storage`; `Microsoft.KeyVault`; `Microsoft.ServiceBus` | Use `azure.resource_provider.namespace` instead. |
+| `az.service_request_id` | string | Deprecated, use `azure.service.request.id` instead. | `00000000-0000-0000-0000-000000000000` | Use `azure.service.request.id` instead. |
+
+
diff --git a/docs/registry/attributes/code.md b/docs/registry/attributes/code.md
index 53402bd47b..b3c8ee0815 100644
--- a/docs/registry/attributes/code.md
+++ b/docs/registry/attributes/code.md
@@ -3,9 +3,6 @@
# Code
-- [Code Attributes](#code-attributes)
-- [Deprecated Code Attributes](#deprecated-code-attributes)
-
## Code Attributes
These attributes provide context about source code
@@ -36,16 +33,15 @@ Examples:
* Rust: `playground::my_module::my_cool_func`
* C function: `fopen`
-## Deprecated Code Attributes
-
-These deprecated attributes provide context about source code
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `code.column` | 
Replaced by `code.column.number`. | int | Deprecated, use `code.column.number` | `16` |
-| `code.filepath` | 
Replaced by `code.file.path`. | string | Deprecated, use `code.file.path` instead | `/usr/local/MyApplication/content_root/app/index.php` |
-| `code.function` | 
Value should be included in `code.function.name` which is expected to be a fully-qualified name. | string | Deprecated, use `code.function.name` instead | `serveRequest` |
-| `code.lineno` | 
Replaced by `code.line.number`. | int | Deprecated, use `code.line.number` instead | `42` |
-| `code.namespace` | 
Value should be included in `code.function.name` which is expected to be a fully-qualified name. | string | Deprecated, namespace is now included into `code.function.name` | `com.example.MyHttpService` |
+| `code.column` | int | Deprecated, use `code.column.number` | `16` | Use `code.column.number` instead. |
+| `code.filepath` | string | Deprecated, use `code.file.path` instead | `/usr/local/MyApplication/content_root/app/index.php` | Use `code.file.path` instead. |
+| `code.function` | string | Deprecated, use `code.function.name` instead | `serveRequest` | Value should be included in `code.function.name` which is expected to be a fully-qualified name. |
+| `code.lineno` | int | Deprecated, use `code.line.number` instead | `42` | Use `code.line.number` instead. |
+| `code.namespace` | string | Deprecated, namespace is now included into `code.function.name` | `com.example.MyHttpService` | Value should be included in `code.function.name` which is expected to be a fully-qualified name. |
+
+
diff --git a/docs/registry/attributes/container.md b/docs/registry/attributes/container.md
index a3bee1557c..387cecd485 100644
--- a/docs/registry/attributes/container.md
+++ b/docs/registry/attributes/container.md
@@ -3,9 +3,6 @@
# Container
-- [Container Attributes](#container-attributes)
-- [Deprecated Container Attributes](#deprecated-container-attributes)
-
## Container Attributes
A container instance.
@@ -44,17 +41,14 @@ The ID is assigned by the container runtime and can vary in different environmen
**[6] `container.label.`:** For example, a docker container label `app` with value `nginx` SHOULD be recorded as the `container.label.app` attribute with value `"nginx"`.
-## Deprecated Container Attributes
-
-Describes deprecated container attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `container.cpu.state` | 
Replaced by `cpu.mode`. | string | Deprecated, use `cpu.mode` instead. | `user`; `kernel` |
-| `container.labels.` | 
Replaced by `container.label`. | string | Deprecated, use `container.label` instead. | `nginx` |
-| `container.runtime` | 
Replaced by `container.runtime.name`. | string | The container runtime managing this container. | `docker`; `containerd`; `rkt` |
+| `container.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `user`; `kernel` | Use `cpu.mode` instead. |
+| `container.labels.` | string | Deprecated, use `container.label` instead. | `nginx` | Use `container.label` instead. |
+| `container.runtime` | string | The container runtime managing this container. | `docker`; `containerd`; `rkt` | Use `container.runtime.name` instead. |
---
@@ -65,3 +59,5 @@ Describes deprecated container attributes.
| `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). |  |
+
+
diff --git a/docs/registry/attributes/db.md b/docs/registry/attributes/db.md
index a98f57e3c3..b98982cba3 100644
--- a/docs/registry/attributes/db.md
+++ b/docs/registry/attributes/db.md
@@ -4,7 +4,6 @@
# DB
- [General Database Attributes](#general-database-attributes)
-- [Deprecated Database Attributes](#deprecated-database-attributes)
- [Deprecated Database Metrics](#deprecated-database-metrics)
## General Database Attributes
@@ -168,46 +167,43 @@ stored procedure name then that stored procedure name SHOULD be used.
| `teradata` | [Teradata](https://www.teradata.com/) |  |
| `trino` | [Trino](https://trino.io/) |  |
-## Deprecated Database Attributes
+
+Deprecated Attributes:
-Describes deprecated database attributes.
-
-**Attributes:**
-
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `db.cassandra.consistency_level` | 
Replaced by `cassandra.consistency.level`. | string | Deprecated, use `cassandra.consistency.level` instead. | `all`; `each_quorum`; `quorum` |
-| `db.cassandra.coordinator.dc` | 
Replaced by `cassandra.coordinator.dc`. | string | Deprecated, use `cassandra.coordinator.dc` instead. | `us-west-2` |
-| `db.cassandra.coordinator.id` | 
Replaced by `cassandra.coordinator.id`. | string | Deprecated, use `cassandra.coordinator.id` instead. | `be13faa2-8574-4d71-926d-27f16cf8a7af` |
-| `db.cassandra.idempotence` | 
Replaced by `cassandra.query.idempotent`. | boolean | Deprecated, use `cassandra.query.idempotent` instead. | |
-| `db.cassandra.page_size` | 
Replaced by `cassandra.page.size`. | int | Deprecated, use `cassandra.page.size` instead. | `5000` |
-| `db.cassandra.speculative_execution_count` | 
Replaced by `cassandra.speculative_execution.count`. | int | Deprecated, use `cassandra.speculative_execution.count` instead. | `0`; `2` |
-| `db.cassandra.table` | 
Replaced by `db.collection.name`. | string | Deprecated, use `db.collection.name` instead. | `mytable` |
-| `db.connection_string` | 
Replaced by `server.address` and `server.port`. | string | Deprecated, use `server.address`, `server.port` attributes instead. | `Server=(localdb)\v11.0;Integrated Security=true;` |
-| `db.cosmosdb.client_id` | 
Replaced by `azure.client.id`. | string | Deprecated, use `azure.client.id` instead. | `3ba4827d-4422-483f-b59f-85b74211c11d` |
-| `db.cosmosdb.connection_mode` | 
Replaced by `azure.cosmosdb.connection.mode`. | string | Deprecated, use `azure.cosmosdb.connection.mode` instead. | `gateway`; `direct` |
-| `db.cosmosdb.consistency_level` | 
Replaced by `azure.cosmosdb.consistency.level`. | string | Deprecated, use `cosmosdb.consistency.level` instead. | `Eventual`; `ConsistentPrefix`; `BoundedStaleness`; `Strong`; `Session` |
-| `db.cosmosdb.container` | 
Replaced by `db.collection.name`. | string | Deprecated, use `db.collection.name` instead. | `mytable` |
-| `db.cosmosdb.operation_type` | 
Removed, no replacement at this time. | string | Deprecated, no replacement at this time. | `batch`; `create`; `delete` |
-| `db.cosmosdb.regions_contacted` | 
Replaced by `azure.cosmosdb.operation.contacted_regions`. | string[] | Deprecated, use `azure.cosmosdb.operation.contacted_regions` instead. | `["North Central US", "Australia East", "Australia Southeast"]` |
-| `db.cosmosdb.request_charge` | 
Replaced by `azure.cosmosdb.operation.request_charge`. | double | Deprecated, use `azure.cosmosdb.operation.request_charge` instead. | `46.18`; `1.0` |
-| `db.cosmosdb.request_content_length` | 
Replaced by `azure.cosmosdb.request.body.size`. | int | Deprecated, use `azure.cosmosdb.request.body.size` instead. | |
-| `db.cosmosdb.status_code` | 
Use `db.response.status_code` instead. | int | Deprecated, use `db.response.status_code` instead. | `200`; `201` |
-| `db.cosmosdb.sub_status_code` | 
Replaced by `azure.cosmosdb.response.sub_status_code`. | int | Deprecated, use `azure.cosmosdb.response.sub_status_code` instead. | `1000`; `1002` |
-| `db.elasticsearch.cluster.name` | 
Replaced by `db.namespace`. | string | Deprecated, use `db.namespace` instead. | `e9106fc68e3044f0b1475b04bf4ffd5f` |
-| `db.elasticsearch.node.name` | 
Replaced by `elasticsearch.node.name`. | string | Deprecated, use `elasticsearch.node.name` instead. | `instance-0000000001` |
-| `db.elasticsearch.path_parts.` | 
Replaced by `db.operation.parameter`. | string | Deprecated, use `db.operation.parameter` instead. | `test-index`; `123` |
-| `db.instance.id` | 
Removed, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. | string | Deprecated, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. | `mysql-e26b99z.example.com` |
-| `db.jdbc.driver_classname` | 
Removed, no replacement at this time. | string | Removed, no replacement at this time. | `org.postgresql.Driver`; `com.microsoft.sqlserver.jdbc.SQLServerDriver` |
-| `db.mongodb.collection` | 
Replaced by `db.collection.name`. | string | Deprecated, use `db.collection.name` instead. | `mytable` |
-| `db.mssql.instance_name` | 
Removed, no replacement at this time. | string | Deprecated, SQL Server instance is now populated as a part of `db.namespace` attribute. | `MSSQLSERVER` |
-| `db.name` | 
Replaced by `db.namespace`. | string | Deprecated, use `db.namespace` instead. | `customers`; `main` |
-| `db.operation` | 
Replaced by `db.operation.name`. | string | Deprecated, use `db.operation.name` instead. | `findAndModify`; `HMSET`; `SELECT` |
-| `db.redis.database_index` | 
Uncategorized. | int | Deprecated, use `db.namespace` instead. | `0`; `1`; `15` |
-| `db.sql.table` | 
Replaced by `db.collection.name`, but only if not extracting the value from `db.query.text`. | string | Deprecated, use `db.collection.name` instead. | `mytable` |
-| `db.statement` | 
Replaced by `db.query.text`. | string | The database statement being executed. | `SELECT * FROM wuser_table`; `SET mykey "WuValue"` |
-| `db.system` | 
Replaced by `db.system.name`. | string | Deprecated, use `db.system.name` instead. | `other_sql`; `adabas`; `intersystems_cache` |
-| `db.user` | 
Removed, no replacement at this time. | string | Deprecated, no replacement at this time. | `readonly_user`; `reporting_user` |
+| `db.cassandra.consistency_level` | string | Deprecated, use `cassandra.consistency.level` instead. | `all`; `each_quorum`; `quorum` | Use `cassandra.consistency.level` instead. |
+| `db.cassandra.coordinator.dc` | string | Deprecated, use `cassandra.coordinator.dc` instead. | `us-west-2` | Use `cassandra.coordinator.dc` instead. |
+| `db.cassandra.coordinator.id` | string | Deprecated, use `cassandra.coordinator.id` instead. | `be13faa2-8574-4d71-926d-27f16cf8a7af` | Use `cassandra.coordinator.id` instead. |
+| `db.cassandra.idempotence` | boolean | Deprecated, use `cassandra.query.idempotent` instead. | | Use `cassandra.query.idempotent` instead. |
+| `db.cassandra.page_size` | int | Deprecated, use `cassandra.page.size` instead. | `5000` | Use `cassandra.page.size` instead. |
+| `db.cassandra.speculative_execution_count` | int | Deprecated, use `cassandra.speculative_execution.count` instead. | `0`; `2` | Use `cassandra.speculative_execution.count` instead. |
+| `db.cassandra.table` | string | Deprecated, use `db.collection.name` instead. | `mytable` | Use `db.collection.name` instead. |
+| `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.client_id` | string | Deprecated, use `azure.client.id` instead. | `3ba4827d-4422-483f-b59f-85b74211c11d` | Use `azure.client.id` instead. |
+| `db.cosmosdb.connection_mode` | string | Deprecated, use `azure.cosmosdb.connection.mode` instead. | `gateway`; `direct` | Use `azure.cosmosdb.connection.mode` instead. |
+| `db.cosmosdb.consistency_level` | string | Deprecated, use `cosmosdb.consistency.level` instead. | `Eventual`; `ConsistentPrefix`; `BoundedStaleness`; `Strong`; `Session` | Use `azure.cosmosdb.consistency.level` instead. |
+| `db.cosmosdb.container` | string | Deprecated, use `db.collection.name` instead. | `mytable` | Use `db.collection.name` instead. |
+| `db.cosmosdb.operation_type` | string | Deprecated, no replacement at this time. | `batch`; `create`; `delete` | Removed, no replacement at this time. |
+| `db.cosmosdb.regions_contacted` | string[] | Deprecated, use `azure.cosmosdb.operation.contacted_regions` instead. | `["North Central US", "Australia East", "Australia Southeast"]` | Use `azure.cosmosdb.operation.contacted_regions` instead. |
+| `db.cosmosdb.request_charge` | double | Deprecated, use `azure.cosmosdb.operation.request_charge` instead. | `46.18`; `1.0` | Use `azure.cosmosdb.operation.request_charge` instead. |
+| `db.cosmosdb.request_content_length` | int | Deprecated, use `azure.cosmosdb.request.body.size` instead. | | Use `azure.cosmosdb.request.body.size` instead. |
+| `db.cosmosdb.status_code` | int | Deprecated, use `db.response.status_code` instead. | `200`; `201` | Use `db.response.status_code` instead. |
+| `db.cosmosdb.sub_status_code` | int | Deprecated, use `azure.cosmosdb.response.sub_status_code` instead. | `1000`; `1002` | Use `azure.cosmosdb.response.sub_status_code` instead. |
+| `db.elasticsearch.cluster.name` | string | Deprecated, use `db.namespace` instead. | `e9106fc68e3044f0b1475b04bf4ffd5f` | Use `db.namespace` instead. |
+| `db.elasticsearch.node.name` | string | Deprecated, use `elasticsearch.node.name` instead. | `instance-0000000001` | Use `elasticsearch.node.name` instead. |
+| `db.elasticsearch.path_parts.` | string | Deprecated, use `db.operation.parameter` instead. | `test-index`; `123` | Use `db.operation.parameter` instead. |
+| `db.instance.id` | string | Deprecated, no general replacement at this time. For Elasticsearch, use `db.elasticsearch.node.name` instead. | `mysql-e26b99z.example.com` | Removed, 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, no replacement at this time. |
+| `db.mongodb.collection` | string | Deprecated, use `db.collection.name` instead. | `mytable` | Use `db.collection.name` instead. |
+| `db.mssql.instance_name` | string | Deprecated, SQL Server instance is now populated as a part of `db.namespace` attribute. | `MSSQLSERVER` | Removed, no replacement at this time. |
+| `db.name` | string | Deprecated, use `db.namespace` instead. | `customers`; `main` | Use `db.namespace` instead. |
+| `db.operation` | string | Deprecated, use `db.operation.name` instead. | `findAndModify`; `HMSET`; `SELECT` | Use `db.operation.name` instead. |
+| `db.redis.database_index` | int | Deprecated, use `db.namespace` instead. | `0`; `1`; `15` | Uncategorized. |
+| `db.sql.table` | string | Deprecated, use `db.collection.name` instead. | `mytable` | Replaced by `db.collection.name`, but only if not extracting the value from `db.query.text`. |
+| `db.statement` | string | The database statement being executed. | `SELECT * FROM wuser_table`; `SET mykey "WuValue"` | Use `db.query.text` instead. |
+| `db.system` | string | Deprecated, use `db.system.name` instead. | `other_sql`; `adabas`; `intersystems_cache` | Use `db.system.name` instead. |
+| `db.user` | string | Deprecated, no replacement at this time. | `readonly_user`; `reporting_user` | Removed, no replacement at this time. |
---
@@ -326,18 +322,21 @@ Describes deprecated database attributes.
| `trino` | Trino |  |
| `vertica` | Vertica |  |
+
+
## Deprecated Database Metrics
Describes deprecated db metrics attributes.
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `db.client.connections.pool.name` | 
Replaced by `db.client.connection.pool.name`. | string | Deprecated, use `db.client.connection.pool.name` instead. | `myDataSource` |
-| `db.client.connections.state` | 
Replaced by `db.client.connection.state`. | string | Deprecated, use `db.client.connection.state` instead. | `idle` |
-| `pool.name` | 
Replaced by `db.client.connection.pool.name`. | string | Deprecated, use `db.client.connection.pool.name` instead. | `myDataSource` |
-| `state` | 
Replaced by `db.client.connection.state`. | string | Deprecated, use `db.client.connection.state` instead. | `idle` |
+| `db.client.connections.pool.name` | string | Deprecated, use `db.client.connection.pool.name` instead. | `myDataSource` | Use `db.client.connection.pool.name` instead. |
+| `db.client.connections.state` | string | Deprecated, use `db.client.connection.state` instead. | `idle` | Use `db.client.connection.state` instead. |
+| `pool.name` | string | Deprecated, use `db.client.connection.pool.name` instead. | `myDataSource` | Use `db.client.connection.pool.name` instead. |
+| `state` | string | Deprecated, use `db.client.connection.state` instead. | `idle` | Use `db.client.connection.state` instead. |
---
@@ -356,3 +355,5 @@ Describes deprecated db metrics attributes.
|---|---|---|
| `idle` | idle |  |
| `used` | used |  |
+
+
diff --git a/docs/registry/attributes/deployment.md b/docs/registry/attributes/deployment.md
index f97892c010..fa6e75555a 100644
--- a/docs/registry/attributes/deployment.md
+++ b/docs/registry/attributes/deployment.md
@@ -3,9 +3,6 @@
# Deployment
-- [Deployment Attributes](#deployment-attributes)
-- [Deployment Deprecated Attributes](#deployment-deprecated-attributes)
-
## Deployment Attributes
This document defines attributes for software deployments.
@@ -36,12 +33,11 @@ considered to be identifying the same service:
| `failed` | failed |  |
| `succeeded` | succeeded |  |
-## Deployment Deprecated Attributes
-
-Describes deprecated deployment attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `deployment.environment` | 
Replaced by `deployment.environment.name`. | string | Deprecated, use `deployment.environment.name` instead. | `staging`; `production` |
+| `deployment.environment` | string | Deprecated, use `deployment.environment.name` instead. | `staging`; `production` | Use `deployment.environment.name` instead. |
+
+
diff --git a/docs/registry/attributes/enduser.md b/docs/registry/attributes/enduser.md
index d747446233..728997ab4b 100644
--- a/docs/registry/attributes/enduser.md
+++ b/docs/registry/attributes/enduser.md
@@ -3,9 +3,6 @@
# Enduser
-- [End User Attributes](#end-user-attributes)
-- [Deprecated End User Attributes](#deprecated-end-user-attributes)
-
## End User Attributes
Describes the end user.
@@ -27,13 +24,12 @@ Describes the end user.
> [!Warning]
> This field contains sensitive (linkable PII) information.
-## Deprecated End User Attributes
-
-Describes deprecated enduser attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `enduser.role` | 
Use `user.roles` instead. | string | Deprecated, use `user.roles` instead. | `admin` |
-| `enduser.scope` | 
Removed, no replacement at this time. | string | Deprecated, no replacement at this time. | `read:message, write:files` |
+| `enduser.role` | string | Deprecated, use `user.roles` instead. | `admin` | Use `user.roles` instead. |
+| `enduser.scope` | string | Deprecated, no replacement at this time. | `read:message, write:files` | Removed, no replacement at this time. |
+
+
diff --git a/docs/registry/attributes/event.md b/docs/registry/attributes/event.md
index 75083c2acb..2109be7e97 100644
--- a/docs/registry/attributes/event.md
+++ b/docs/registry/attributes/event.md
@@ -7,8 +7,11 @@
Attributes for Events represented using Log Records.
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `event.name` | 
The value of this attribute MUST now be set as the value of the EventName field on the LogRecord to indicate that the LogRecord represents an Event. | string | Identifies the class / type of event. | `browser.mouse.click`; `device.app.lifecycle` |
+| `event.name` | string | Identifies the class / type of event. | `browser.mouse.click`; `device.app.lifecycle` | The value of this attribute MUST now be set as the value of the EventName field on the LogRecord to indicate that the LogRecord represents an Event. |
+
+
diff --git a/docs/registry/attributes/exception.md b/docs/registry/attributes/exception.md
index a960f2f09d..88b547f93c 100644
--- a/docs/registry/attributes/exception.md
+++ b/docs/registry/attributes/exception.md
@@ -3,9 +3,6 @@
# Exception
-- [Exception Attributes](#exception-attributes)
-- [Deprecated Exception Attributes](#deprecated-exception-attributes)
-
## Exception Attributes
This document defines the shared attributes used to report a single exception associated with a span or log.
@@ -18,12 +15,11 @@ This document defines the shared attributes used to report a single exception as
| `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` |
-## Deprecated Exception Attributes
-
-Deprecated exception attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `exception.escaped` | 
It's no longer recommended to record exceptions that are handled and do not escape the scope of a span. | boolean | Indicates that the exception is escaping the scope of the span. | |
+| `exception.escaped` | boolean | Indicates that the exception is escaping the scope of the span. | | It's no longer recommended to record exceptions that are handled and do not escape the scope of a span. |
+
+
diff --git a/docs/registry/attributes/feature-flag.md b/docs/registry/attributes/feature-flag.md
index 979da587cb..a030636676 100644
--- a/docs/registry/attributes/feature-flag.md
+++ b/docs/registry/attributes/feature-flag.md
@@ -3,9 +3,6 @@
# Feature flag
-- [Feature Flag Attributes](#feature-flag-attributes)
-- [Deprecated Feature Flag Attributes](#deprecated-feature-flag-attributes)
-
## Feature Flag Attributes
This document defines attributes for Feature Flags.
@@ -50,18 +47,15 @@ For example, the variant `red` maybe be used for the value `#c05543`.
| `targeting_match` | The resolved value was the result of a dynamic evaluation, such as a rule or specific user-targeting. |  |
| `unknown` | The reason for the resolved value could not be determined. |  |
-## Deprecated Feature Flag Attributes
-
-Describes deprecated feature flag attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `feature_flag.evaluation.error.message` | 
Replaced by `error.message`. | string | Deprecated, use `error.message` instead. | `Flag `header-color` expected type `string` but found type `number`` |
-| `feature_flag.evaluation.reason` | 
Replaced by `feature_flag.result.reason`. | string | Deprecated, use `feature_flag.result.reason` instead. | `static`; `targeting_match`; `error`; `default` |
-| `feature_flag.provider_name` | 
Replaced by `feature_flag.provider.name`. | string | Deprecated, use `feature_flag.provider.name` instead. | `Flag Manager` |
-| `feature_flag.variant` | 
Replaced by `feature_flag.result.variant`. | string | Deprecated, use `feature_flag.result.variant` instead. | `red`; `true`; `on` |
+| `feature_flag.evaluation.error.message` | string | Deprecated, use `error.message` instead. | `Flag `header-color` expected type `string` but found type `number`` | Use `error.message` instead. |
+| `feature_flag.evaluation.reason` | string | Deprecated, use `feature_flag.result.reason` instead. | `static`; `targeting_match`; `error`; `default` | Use `feature_flag.result.reason` instead. |
+| `feature_flag.provider_name` | string | Deprecated, use `feature_flag.provider.name` instead. | `Flag Manager` | Use `feature_flag.provider.name` instead. |
+| `feature_flag.variant` | string | Deprecated, use `feature_flag.result.variant` instead. | `red`; `true`; `on` | Use `feature_flag.result.variant` instead. |
---
@@ -78,3 +72,5 @@ Describes deprecated feature flag attributes.
| `static` | The resolved value is static (no dynamic evaluation). |  |
| `targeting_match` | The resolved value was the result of a dynamic evaluation, such as a rule or specific user-targeting. |  |
| `unknown` | The reason for the resolved value could not be determined. |  |
+
+
diff --git a/docs/registry/attributes/gen-ai.md b/docs/registry/attributes/gen-ai.md
index af894ef526..ec1b4a8c45 100644
--- a/docs/registry/attributes/gen-ai.md
+++ b/docs/registry/attributes/gen-ai.md
@@ -4,7 +4,6 @@
# Gen AI
- [GenAI Attributes](#genai-attributes)
-- [Deprecated GenAI Attributes](#deprecated-genai-attributes)
- [Deprecated OpenAI GenAI Attributes](#deprecated-openai-genai-attributes)
## GenAI Attributes
@@ -235,19 +234,16 @@ Datastore: A tool used by the agent to access and query structured or unstructur
| `input` | Input tokens (prompt, input, etc.) |  |
| `output` | Output tokens (completion, response, etc.) |  |
-## Deprecated GenAI Attributes
+
+Deprecated Attributes:
-Describes deprecated `gen_ai` attributes.
-
-**Attributes:**
-
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `gen_ai.completion` | 
Removed, no replacement at this time. | string | Deprecated, use Event API to report completions contents. | `[{'role': 'assistant', 'content': 'The capital of France is Paris.'}]` |
-| `gen_ai.prompt` | 
Removed, no replacement at this time. | string | Deprecated, use Event API to report prompt contents. | `[{'role': 'user', 'content': 'What is the capital of France?'}]` |
-| `gen_ai.system` | 
Replaced by `gen_ai.provider.name`. | string | Deprecated, use `gen_ai.provider.name` instead. | `openai`; `gcp.gen_ai`; `gcp.vertex_ai` |
-| `gen_ai.usage.completion_tokens` | 
Replaced by `gen_ai.usage.output_tokens`. | int | Deprecated, use `gen_ai.usage.output_tokens` instead. | `42` |
-| `gen_ai.usage.prompt_tokens` | 
Replaced by `gen_ai.usage.input_tokens`. | int | Deprecated, use `gen_ai.usage.input_tokens` instead. | `42` |
+| `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.system` | string | Deprecated, use `gen_ai.provider.name` instead. | `openai`; `gcp.gen_ai`; `gcp.vertex_ai` | Use `gen_ai.provider.name` instead. |
+| `gen_ai.usage.completion_tokens` | int | Deprecated, use `gen_ai.usage.output_tokens` instead. | `42` | Use `gen_ai.usage.output_tokens` instead. |
+| `gen_ai.usage.prompt_tokens` | int | Deprecated, use `gen_ai.usage.input_tokens` instead. | `42` | Use `gen_ai.usage.input_tokens` instead. |
---
@@ -261,9 +257,9 @@ Describes deprecated `gen_ai` attributes.
| `azure.ai.openai` | Azure OpenAI |  |
| `cohere` | Cohere |  |
| `deepseek` | DeepSeek |  |
-| `gcp.gemini` | Gemini [17] |  |
-| `gcp.gen_ai` | Any Google generative AI endpoint [18] |  |
-| `gcp.vertex_ai` | Vertex AI [19] |  |
+| `gcp.gemini` | Gemini [1] |  |
+| `gcp.gen_ai` | Any Google generative AI endpoint [2] |  |
+| `gcp.vertex_ai` | Vertex AI [3] |  |
| `groq` | Groq |  |
| `ibm.watsonx.ai` | IBM Watsonx AI |  |
| `mistral_ai` | Mistral AI |  |
@@ -271,25 +267,28 @@ Describes deprecated `gen_ai` attributes.
| `perplexity` | Perplexity |  |
| `xai` | xAI |  |
-**[17]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
+**[1]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
-**[18]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
+**[2]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
-**[19]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
+**[3]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
+
+
## Deprecated OpenAI GenAI Attributes
Describes deprecated `gen_ai.openai` attributes.
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `gen_ai.openai.request.response_format` | 
Replaced by `gen_ai.output.type`. | string | Deprecated, use `gen_ai.output.type`. | `text`; `json_object`; `json_schema` |
-| `gen_ai.openai.request.seed` | 
Replaced by `gen_ai.request.seed`. | int | Deprecated, use `gen_ai.request.seed`. | `100` |
-| `gen_ai.openai.request.service_tier` | 
Replaced by `openai.request.service_tier`. | string | Deprecated, use `openai.request.service_tier`. | `auto`; `default` |
-| `gen_ai.openai.response.service_tier` | 
Replaced by `openai.response.service_tier`. | string | Deprecated, use `openai.response.service_tier`. | `scale`; `default` |
-| `gen_ai.openai.response.system_fingerprint` | 
Replaced by `openai.response.system_fingerprint`. | string | Deprecated, use `openai.response.system_fingerprint`. | `fp_44709d6fcb` |
+| `gen_ai.openai.request.response_format` | string | Deprecated, use `gen_ai.output.type`. | `text`; `json_object`; `json_schema` | Use `gen_ai.output.type` instead. |
+| `gen_ai.openai.request.seed` | int | Deprecated, use `gen_ai.request.seed`. | `100` | Use `gen_ai.request.seed` instead. |
+| `gen_ai.openai.request.service_tier` | string | Deprecated, use `openai.request.service_tier`. | `auto`; `default` | Use `openai.request.service_tier` instead. |
+| `gen_ai.openai.response.service_tier` | string | Deprecated, use `openai.response.service_tier`. | `scale`; `default` | Use `openai.response.service_tier` instead. |
+| `gen_ai.openai.response.system_fingerprint` | string | Deprecated, use `openai.response.system_fingerprint`. | `fp_44709d6fcb` | Use `openai.response.system_fingerprint` instead. |
---
@@ -309,3 +308,5 @@ Describes deprecated `gen_ai.openai` attributes.
|---|---|---|
| `auto` | The system will utilize scale tier credits until they are exhausted. |  |
| `default` | The system will utilize the default scale tier. |  |
+
+
diff --git a/docs/registry/attributes/http.md b/docs/registry/attributes/http.md
index 673cd51359..49cde8ea58 100644
--- a/docs/registry/attributes/http.md
+++ b/docs/registry/attributes/http.md
@@ -3,9 +3,6 @@
# HTTP
-- [HTTP Attributes](#http-attributes)
-- [Deprecated HTTP Attributes](#deprecated-http-attributes)
-
## HTTP Attributes
This document defines semantic convention attributes in the HTTP namespace.
@@ -116,28 +113,25 @@ support custom route formatting. Instrumentations SHOULD document the format and
| `QUERY` | QUERY method. |  |
| `TRACE` | TRACE method. |  |
-## Deprecated HTTP Attributes
-
-Describes deprecated HTTP attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `http.client_ip` | 
Replaced by `client.address`. | string | Deprecated, use `client.address` instead. | `83.164.160.102` |
-| `http.flavor` | 
Split into `network.protocol.name` and `network.protocol.version` | string | Deprecated, use `network.protocol.name` and `network.protocol.version` instead. | `1.0`; `1.1`; `2.0` |
-| `http.host` | 
Replaced by one of `server.address`, `client.address` or `http.request.header.host`, depending on the usage. | string | Deprecated, use one of `server.address`, `client.address` or `http.request.header.host` instead, depending on the usage. | `www.example.org` |
-| `http.method` | 
Replaced by `http.request.method`. | string | Deprecated, use `http.request.method` instead. | `GET`; `POST`; `HEAD` |
-| `http.request_content_length` | 
Replaced by `http.request.header.content-length`. | int | Deprecated, use `http.request.header.content-length` instead. | `3495` |
-| `http.request_content_length_uncompressed` | 
Replaced by `http.request.body.size`. | int | Deprecated, use `http.request.body.size` instead. | `5493` |
-| `http.response_content_length` | 
Replaced by `http.response.header.content-length`. | int | Deprecated, use `http.response.header.content-length` instead. | `3495` |
-| `http.response_content_length_uncompressed` | 
Replaced by `http.response.body.size`. | int | Deprecated, use `http.response.body.size` instead. | `5493` |
-| `http.scheme` | 
Replaced by `url.scheme`. | string | Deprecated, use `url.scheme` instead. | `http`; `https` |
-| `http.server_name` | 
Replaced by `server.address`. | string | Deprecated, use `server.address` instead. | `example.com` |
-| `http.status_code` | 
Replaced by `http.response.status_code`. | int | Deprecated, use `http.response.status_code` instead. | `200` |
-| `http.target` | 
Split to `url.path` and `url.query`. | string | Deprecated, use `url.path` and `url.query` instead. | `/search?q=OpenTelemetry#SemConv` |
-| `http.url` | 
Replaced by `url.full`. | string | Deprecated, use `url.full` instead. | `https://www.foo.bar/search?q=OpenTelemetry#SemConv` |
-| `http.user_agent` | 
Replaced by `user_agent.original`. | 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` |
+| `http.client_ip` | string | Deprecated, use `client.address` instead. | `83.164.160.102` | Use `client.address` instead. |
+| `http.flavor` | string | Deprecated, use `network.protocol.name` and `network.protocol.version` instead. | `1.0`; `1.1`; `2.0` | Split into `network.protocol.name` and `network.protocol.version` |
+| `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` | Use `http.request.method` instead. |
+| `http.request_content_length` | int | Deprecated, use `http.request.header.content-length` instead. | `3495` | Replaced by `http.request.header.content-length`. |
+| `http.request_content_length_uncompressed` | int | Deprecated, use `http.request.body.size` instead. | `5493` | Use `http.request.body.size` instead. |
+| `http.response_content_length` | int | Deprecated, use `http.response.header.content-length` instead. | `3495` | Replaced by `http.response.header.content-length`. |
+| `http.response_content_length_uncompressed` | int | Deprecated, use `http.response.body.size` instead. | `5493` | Use `http.response.body.size` instead. |
+| `http.scheme` | string | Deprecated, use `url.scheme` instead. | `http`; `https` | Use `url.scheme` instead. |
+| `http.server_name` | string | Deprecated, use `server.address` instead. | `example.com` | Use `server.address` instead. |
+| `http.status_code` | int | Deprecated, use `http.response.status_code` instead. | `200` | Use `http.response.status_code` instead. |
+| `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` | Use `url.full` instead. |
+| `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` | Use `user_agent.original` instead. |
---
@@ -151,3 +145,5 @@ Describes deprecated HTTP attributes.
| `3.0` | HTTP/3 |  |
| `QUIC` | QUIC protocol. |  |
| `SPDY` | SPDY protocol. |  |
+
+
diff --git a/docs/registry/attributes/ios.md b/docs/registry/attributes/ios.md
index f946e34115..1c5c9ef841 100644
--- a/docs/registry/attributes/ios.md
+++ b/docs/registry/attributes/ios.md
@@ -3,9 +3,6 @@
# iOS
-- [iOS Attributes](#ios-attributes)
-- [Deprecated iOS Attributes](#deprecated-ios-attributes)
-
## iOS Attributes
This group describes iOS-specific attributes.
@@ -30,17 +27,14 @@ This group describes iOS-specific attributes.
| `inactive` | The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. |  |
| `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. |  |
-## Deprecated iOS Attributes
-
-The iOS platform on which the iOS application is running.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `ios.state` | 
Replaced by `ios.app.state`. | string | Deprecated. Use the `ios.app.state` attribute. [2] | `active`; `inactive`; `background` |
+| `ios.state` | string | Deprecated. Use the `ios.app.state` attribute. [1] | `active`; `inactive`; `background` | Use `ios.app.state` instead. |
-**[2] `ios.state`:** The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate), and from which the `OS terminology` column values are derived.
+**[1] `ios.state`:** The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate), and from which the `OS terminology` column values are derived.
---
@@ -53,3 +47,5 @@ The iOS platform on which the iOS application is running.
| `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`. |  |
+
+
diff --git a/docs/registry/attributes/k8s.md b/docs/registry/attributes/k8s.md
index 5eb9c77867..a387d78310 100644
--- a/docs/registry/attributes/k8s.md
+++ b/docs/registry/attributes/k8s.md
@@ -3,9 +3,6 @@
# K8s
-- [Kubernetes Attributes](#kubernetes-attributes)
-- [Deprecated Kubernetes Attributes](#deprecated-kubernetes-attributes)
-
## Kubernetes Attributes
Kubernetes resource attributes.
@@ -350,12 +347,11 @@ When this occurs, the exact value as reported by the Kubernetes API SHOULD be us
| `persistentVolumeClaim` | A [persistentVolumeClaim](https://v1-30.docs.kubernetes.io/docs/concepts/storage/volumes/#persistentvolumeclaim) volume |  |
| `secret` | A [secret](https://v1-30.docs.kubernetes.io/docs/concepts/storage/volumes/#secret) volume |  |
-## Deprecated Kubernetes Attributes
-
-Describes deprecated k8s attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `k8s.pod.labels.` | 
Replaced by `k8s.pod.label`. | string | Deprecated, use `k8s.pod.label` instead. | `my-app` |
+| `k8s.pod.labels.` | string | Deprecated, use `k8s.pod.label` instead. | `my-app` | Use `k8s.pod.label` instead. |
+
+
diff --git a/docs/registry/attributes/messaging.md b/docs/registry/attributes/messaging.md
index 3edc75896b..2f5363c8d4 100644
--- a/docs/registry/attributes/messaging.md
+++ b/docs/registry/attributes/messaging.md
@@ -10,7 +10,6 @@
- [RabbitMQ Attributes](#rabbitmq-attributes)
- [RocketMQ Attributes](#rocketmq-attributes)
- [Azure Service Bus Attributes](#azure-service-bus-attributes)
-- [Deprecated Messaging Attributes](#deprecated-messaging-attributes)
## General Messaging Attributes
@@ -89,6 +88,24 @@ size should be used.
| `rocketmq` | Apache RocketMQ |  |
| `servicebus` | Azure Service Bus |  |
+
+Deprecated Attributes:
+
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
+|---|---|---|---|---|
+| `messaging.client_id` | string | Deprecated, use `messaging.client.id` instead. | `client-5`; `myhost@8742@s8083jm` | Use `messaging.client.id` instead. |
+| `messaging.destination_publish.anonymous` | boolean | Deprecated, no replacement at this time. | | Removed. No replacement at this time. |
+| `messaging.destination_publish.name` | string | Deprecated, no replacement at this time. | `MyQueue`; `MyTopic` | Removed. No replacement at this time. |
+| `messaging.eventhubs.consumer.group` | string | Deprecated, use `messaging.consumer.group.name` instead. | `$Default` | Use `messaging.consumer.group.name` instead. |
+| `messaging.kafka.consumer.group` | string | Deprecated, use `messaging.consumer.group.name` instead. | `my-group` | Use `messaging.consumer.group.name` instead. |
+| `messaging.kafka.destination.partition` | int | Deprecated, use `messaging.destination.partition.id` instead. | `2` | Record string representation of the partition id in `messaging.destination.partition.id` attribute. |
+| `messaging.kafka.message.offset` | int | Deprecated, use `messaging.kafka.offset` instead. | `42` | Use `messaging.kafka.offset` instead. |
+| `messaging.operation` | string | Deprecated, use `messaging.operation.type` instead. | `publish`; `create`; `process` | Use `messaging.operation.type` instead. |
+| `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` | Use `messaging.destination.subscription.name` instead. |
+
+
+
## Azure Event Hubs Attributes
This group describes attributes specific to Azure Event Hubs.
@@ -196,22 +213,3 @@ This group describes attributes specific to Azure Service Bus.
| `complete` | Message is completed |  |
| `dead_letter` | Message is sent to dead letter queue |  |
| `defer` | Message is deferred |  |
-
-## Deprecated Messaging Attributes
-
-Describes deprecated messaging attributes.
-
-**Attributes:**
-
-| Key | Stability | Value Type | Description | Example Values |
-|---|---|---|---|---|
-| `messaging.client_id` | 
Replaced by `messaging.client.id`. | string | Deprecated, use `messaging.client.id` instead. | `client-5`; `myhost@8742@s8083jm` |
-| `messaging.destination_publish.anonymous` | 
Removed. No replacement at this time. | boolean | Deprecated, no replacement at this time. | |
-| `messaging.destination_publish.name` | 
Removed. No replacement at this time. | string | Deprecated, no replacement at this time. | `MyQueue`; `MyTopic` |
-| `messaging.eventhubs.consumer.group` | 
Replaced by `messaging.consumer.group.name`. | string | Deprecated, use `messaging.consumer.group.name` instead. | `$Default` |
-| `messaging.kafka.consumer.group` | 
Replaced by `messaging.consumer.group.name`. | string | Deprecated, use `messaging.consumer.group.name` instead. | `my-group` |
-| `messaging.kafka.destination.partition` | 
Record string representation of the partition id in `messaging.destination.partition.id` attribute. | int | Deprecated, use `messaging.destination.partition.id` instead. | `2` |
-| `messaging.kafka.message.offset` | 
Replaced by `messaging.kafka.offset`. | int | Deprecated, use `messaging.kafka.offset` instead. | `42` |
-| `messaging.operation` | 
Replaced by `messaging.operation.type`. | string | Deprecated, use `messaging.operation.type` instead. | `publish`; `create`; `process` |
-| `messaging.rocketmq.client_group` | 
Replaced by `messaging.consumer.group.name` on the consumer spans. No replacement for producer spans. | string | Deprecated, use `messaging.consumer.group.name` instead. | `myConsumerGroup` |
-| `messaging.servicebus.destination.subscription_name` | 
Replaced by `messaging.destination.subscription.name`. | string | Deprecated, use `messaging.destination.subscription.name` instead. | `subscription-a` |
diff --git a/docs/registry/attributes/network.md b/docs/registry/attributes/network.md
index debd9e2894..4f1579380a 100644
--- a/docs/registry/attributes/network.md
+++ b/docs/registry/attributes/network.md
@@ -3,9 +3,6 @@
# Network
-- [Network Attributes](#network-attributes)
-- [Deprecated Network Attributes](#deprecated-network-attributes)
-
## Network Attributes
These attributes may be used for any network related operation.
@@ -134,29 +131,26 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
| `ipv4` | IPv4 |  |
| `ipv6` | IPv6 |  |
-## Deprecated Network Attributes
-
-These attributes may be used for any network related operation.
+
+Deprecated Attributes:
-**Attributes:**
-
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `net.host.ip` | 
Replaced by `network.local.address`. | string | Deprecated, use `network.local.address`. | `192.168.0.1` |
-| `net.host.name` | 
Replaced by `server.address`. | string | Deprecated, use `server.address`. | `example.com` |
-| `net.host.port` | 
Replaced by `server.port`. | int | Deprecated, use `server.port`. | `8080` |
-| `net.peer.ip` | 
Replaced by `network.peer.address`. | string | Deprecated, use `network.peer.address`. | `127.0.0.1` |
-| `net.peer.name` | 
Replaced by `server.address` on client spans and `client.address` on server spans. | string | Deprecated, use `server.address` on client spans and `client.address` on server spans. | `example.com` |
-| `net.peer.port` | 
Replaced by `server.port` on client spans and `client.port` on server spans. | int | Deprecated, use `server.port` on client spans and `client.port` on server spans. | `8080` |
-| `net.protocol.name` | 
Replaced by `network.protocol.name`. | string | Deprecated, use `network.protocol.name`. | `amqp`; `http`; `mqtt` |
-| `net.protocol.version` | 
Replaced by `network.protocol.version`. | string | Deprecated, use `network.protocol.version`. | `3.1.1` |
-| `net.sock.family` | 
Split to `network.transport` and `network.type`. | string | Deprecated, use `network.transport` and `network.type`. | `inet`; `inet6`; `unix` |
-| `net.sock.host.addr` | 
Replaced by `network.local.address`. | string | Deprecated, use `network.local.address`. | `/var/my.sock` |
-| `net.sock.host.port` | 
Replaced by `network.local.port`. | int | Deprecated, use `network.local.port`. | `8080` |
-| `net.sock.peer.addr` | 
Replaced by `network.peer.address`. | string | Deprecated, use `network.peer.address`. | `192.168.0.1` |
-| `net.sock.peer.name` | 
Removed. No replacement at this time. | string | Deprecated, no replacement at this time. | `/var/my.sock` |
-| `net.sock.peer.port` | 
Replaced by `network.peer.port`. | int | Deprecated, use `network.peer.port`. | `65531` |
-| `net.transport` | 
Replaced by `network.transport`. | string | Deprecated, use `network.transport`. | `ip_tcp`; `ip_udp`; `pipe` |
+| `net.host.ip` | string | Deprecated, use `network.local.address`. | `192.168.0.1` | Use `network.local.address` instead. |
+| `net.host.name` | string | Deprecated, use `server.address`. | `example.com` | Use `server.address` instead. |
+| `net.host.port` | int | Deprecated, use `server.port`. | `8080` | Use `server.port` instead. |
+| `net.peer.ip` | string | Deprecated, use `network.peer.address`. | `127.0.0.1` | Use `network.peer.address` instead. |
+| `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` | Use `network.protocol.name` instead. |
+| `net.protocol.version` | string | Deprecated, use `network.protocol.version`. | `3.1.1` | Use `network.protocol.version` instead. |
+| `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` | Use `network.local.address` instead. |
+| `net.sock.host.port` | int | Deprecated, use `network.local.port`. | `8080` | Use `network.local.port` instead. |
+| `net.sock.peer.addr` | string | Deprecated, use `network.peer.address`. | `192.168.0.1` | Use `network.peer.address` instead. |
+| `net.sock.peer.name` | string | Deprecated, no replacement at this time. | `/var/my.sock` | Removed. No replacement at this time. |
+| `net.sock.peer.port` | int | Deprecated, use `network.peer.port`. | `65531` | Use `network.peer.port` instead. |
+| `net.transport` | string | Deprecated, use `network.transport`. | `ip_tcp`; `ip_udp`; `pipe` | Use `network.transport` instead. |
---
@@ -174,10 +168,12 @@ These attributes may be used for any network related operation.
| Value | Description | Stability |
|---|---|---|
-| `inproc` | In-process communication. [6] |  |
+| `inproc` | In-process communication. [1] |  |
| `ip_tcp` | ip_tcp |  |
| `ip_udp` | ip_udp |  |
| `other` | Something else (non IP-based). |  |
| `pipe` | Named or anonymous pipe. |  |
-**[6]:** 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.
+**[1]:** 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/registry/attributes/otel.md b/docs/registry/attributes/otel.md
index 4f8d7e45fd..d82fef6f17 100644
--- a/docs/registry/attributes/otel.md
+++ b/docs/registry/attributes/otel.md
@@ -117,9 +117,12 @@ Attributes used by non-OTLP exporters to represent OpenTelemetry Scope's concept
Describes deprecated otel.library attributes.
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `otel.library.name` | 
Replaced by `otel.scope.name`. | string | Deprecated. Use the `otel.scope.name` attribute | `io.opentelemetry.contrib.mongodb` |
-| `otel.library.version` | 
Replaced by `otel.scope.version`. | string | Deprecated. Use the `otel.scope.version` attribute. | `1.0.0` |
+| `otel.library.name` | string | Deprecated. Use the `otel.scope.name` attribute | `io.opentelemetry.contrib.mongodb` | Use `otel.scope.name` instead. |
+| `otel.library.version` | string | Deprecated. Use the `otel.scope.version` attribute. | `1.0.0` | Use `otel.scope.version` instead. |
+
+
diff --git a/docs/registry/attributes/process.md b/docs/registry/attributes/process.md
index 9bab50ce2f..ad8d4e2660 100644
--- a/docs/registry/attributes/process.md
+++ b/docs/registry/attributes/process.md
@@ -5,7 +5,6 @@
- [Process Attributes](#process-attributes)
- [Process Linux Attributes](#process-linux-attributes)
-- [Deprecated Process Attributes](#deprecated-process-attributes)
## Process Attributes
@@ -84,30 +83,15 @@ with value `"/usr/local/bin:/usr/bin"`.
| `sleeping` | sleeping |  |
| `stopped` | stopped |  |
-## Process Linux Attributes
-
-Describes Linux Process attributes
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `process.linux.cgroup` |  | string | The control group associated with the process. [5] | `1:name=systemd:/user.slice/user-1000.slice/session-3.scope`; `0::/user.slice/user-1000.slice/user@1000.service/tmux-spawn-0267755b-4639-4a27-90ed-f19f88e53748.scope` |
-
-**[5] `process.linux.cgroup`:** Control groups (cgroups) are a kernel feature used to organize and manage process resources. This attribute provides the path(s) to the cgroup(s) associated with the process, which should match the contents of the [/proc/\[PID\]/cgroup](https://man7.org/linux/man-pages/man7/cgroups.7.html) file.
-
-## Deprecated Process Attributes
-
-Deprecated process attributes.
-
-**Attributes:**
-
-| Key | Stability | Value Type | Description | Example Values |
-|---|---|---|---|---|
-| `process.context_switch_type` | 
Replaced by `process.context_switch.type`. | string | "Deprecated, use `process.context_switch.type` instead." | `voluntary`; `involuntary` |
-| `process.cpu.state` | 
Replaced by `cpu.mode`. | string | Deprecated, use `cpu.mode` instead. | `system`; `user`; `wait` |
-| `process.executable.build_id.profiling` | 
Replaced by `process.executable.build_id.htlhash`. | string | "Deprecated, use `process.executable.build_id.htlhash` instead." | `600DCAFE4A110000F2BF38C493F5FB92` |
-| `process.paging.fault_type` | 
Replaced by `system.paging.fault.type`. | string | Deprecated, use `system.paging.fault.type` instead. | `major`; `minor` |
+| `process.context_switch_type` | string | "Deprecated, use `process.context_switch.type` instead." | `voluntary`; `involuntary` | Use `process.context_switch.type` instead. |
+| `process.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `system`; `user`; `wait` | Use `cpu.mode` instead. |
+| `process.executable.build_id.profiling` | string | "Deprecated, use `process.executable.build_id.htlhash` instead." | `600DCAFE4A110000F2BF38C493F5FB92` | Use `process.executable.build_id.htlhash` instead. |
+| `process.paging.fault_type` | string | Deprecated, use `system.paging.fault.type` instead. | `major`; `minor` | Use `system.paging.fault.type` instead. |
---
@@ -136,3 +120,17 @@ Deprecated process attributes.
|---|---|---|
| `major` | major |  |
| `minor` | minor |  |
+
+
+
+## Process Linux Attributes
+
+Describes Linux Process attributes
+
+**Attributes:**
+
+| Key | Stability | Value Type | Description | Example Values |
+|---|---|---|---|---|
+| `process.linux.cgroup` |  | string | The control group associated with the process. [5] | `1:name=systemd:/user.slice/user-1000.slice/session-3.scope`; `0::/user.slice/user-1000.slice/user@1000.service/tmux-spawn-0267755b-4639-4a27-90ed-f19f88e53748.scope` |
+
+**[5] `process.linux.cgroup`:** Control groups (cgroups) are a kernel feature used to organize and manage process resources. This attribute provides the path(s) to the cgroup(s) associated with the process, which should match the contents of the [/proc/\[PID\]/cgroup](https://man7.org/linux/man-pages/man7/cgroups.7.html) file.
diff --git a/docs/registry/attributes/rpc.md b/docs/registry/attributes/rpc.md
index 3a917a9092..de2726da61 100644
--- a/docs/registry/attributes/rpc.md
+++ b/docs/registry/attributes/rpc.md
@@ -3,9 +3,6 @@
# RPC
-- [Remote Procedure Call (RPC) Attributes](#remote-procedure-call-rpc-attributes)
-- [Deprecated RPC Attributes](#deprecated-rpc-attributes)
-
## Remote Procedure Call (RPC) Attributes
This document defines attributes for remote procedure calls.
@@ -128,18 +125,15 @@ the `rpc.grpc.response.metadata.my-custom-key` attribute with value `["attribute
| `jsonrpc` | JSON-RPC |  |
| `onc_rpc` | [ONC RPC (Sun RPC)](https://datatracker.ietf.org/doc/html/rfc5531) |  |
-## Deprecated RPC Attributes
-
-Deprecated rpc message attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `message.compressed_size` | 
Replaced by `rpc.message.compressed_size`. | int | Deprecated, use `rpc.message.compressed_size` instead. | |
-| `message.id` | 
Replaced by `rpc.message.id`. | int | Deprecated, use `rpc.message.id` instead. | |
-| `message.type` | 
Replaced by `rpc.message.type`. | string | Deprecated, use `rpc.message.type` instead. | `SENT`; `RECEIVED` |
-| `message.uncompressed_size` | 
Replaced by `rpc.message.uncompressed_size`. | int | Deprecated, use `rpc.message.uncompressed_size` instead. | |
+| `message.compressed_size` | int | Deprecated, use `rpc.message.compressed_size` instead. | | Use `rpc.message.compressed_size` instead. |
+| `message.id` | int | Deprecated, use `rpc.message.id` instead. | | Use `rpc.message.id` instead. |
+| `message.type` | string | Deprecated, use `rpc.message.type` instead. | `SENT`; `RECEIVED` | Use `rpc.message.type` instead. |
+| `message.uncompressed_size` | int | Deprecated, use `rpc.message.uncompressed_size` instead. | | Use `rpc.message.uncompressed_size` instead. |
---
@@ -149,3 +143,5 @@ Deprecated rpc message attributes.
|---|---|---|
| `RECEIVED` | received |  |
| `SENT` | sent |  |
+
+
diff --git a/docs/registry/attributes/system.md b/docs/registry/attributes/system.md
index 44534b304c..faa565ad2a 100644
--- a/docs/registry/attributes/system.md
+++ b/docs/registry/attributes/system.md
@@ -7,7 +7,6 @@
- [Filesystem Attributes](#filesystem-attributes)
- [System Memory Attributes](#system-memory-attributes)
- [System Paging Attributes](#system-paging-attributes)
-- [Deprecated System Attributes](#deprecated-system-attributes)
## General System Attributes
@@ -19,6 +18,84 @@ Describes System attributes
|---|---|---|---|---|
| `system.device` |  | string | The device identifier | `(identifier)` |
+
+Deprecated Attributes:
+
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
+|---|---|---|---|---|
+| `system.cpu.logical_number` | int | Deprecated, use `cpu.logical_number` instead. | `1` | Use `cpu.logical_number` instead. |
+| `system.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `idle`; `interrupt` | Use `cpu.mode` instead. |
+| `system.network.state` | string | Deprecated, use `network.connection.state` instead. | `close_wait` | Use `network.connection.state` instead. |
+| `system.paging.type` | string | Deprecated, use `system.paging.fault.type` instead. | `minor` | Use `system.paging.fault.type` instead. |
+| `system.process.status` | string | Deprecated, use `process.state` instead. | `running` | Use `process.state` instead. |
+| `system.processes.status` | string | Deprecated, use `process.state` instead. | `running` | Use `process.state` instead. |
+
+---
+
+`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 |  |
+
+---
+
+`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 |  |
+| `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 |  |
+
+---
+
+`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 |  |
+
+---
+
+`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 |  |
+
+---
+
+`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 |  |
+
+
+
## Filesystem Attributes
Describes Filesystem attributes
@@ -116,82 +193,3 @@ Describes System Memory Paging attributes
|---|---|---|
| `free` | free |  |
| `used` | used |  |
-
-## Deprecated System Attributes
-
-Deprecated system attributes.
-
-**Attributes:**
-
-| Key | Stability | Value Type | Description | Example Values |
-|---|---|---|---|---|
-| `system.cpu.logical_number` | 
Replaced by `cpu.logical_number`. | int | Deprecated, use `cpu.logical_number` instead. | `1` |
-| `system.cpu.state` | 
Replaced by `cpu.mode`. | string | Deprecated, use `cpu.mode` instead. | `idle`; `interrupt` |
-| `system.network.state` | 
Replaced by `network.connection.state`. | string | Deprecated, use `network.connection.state` instead. | `close_wait` |
-| `system.paging.type` | 
Replaced by `system.paging.fault.type`. | string | Deprecated, use `system.paging.fault.type` instead. | `minor` |
-| `system.process.status` | 
Replaced by `process.state`. | string | Deprecated, use `process.state` instead. | `running` |
-| `system.processes.status` | 
Replaced by `process.state`. | string | Deprecated, use `process.state` instead. | `running` |
-
----
-
-`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 |  |
-
----
-
-`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 |  |
-| `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 |  |
-
----
-
-`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 |  |
-
----
-
-`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 |  |
-
----
-
-`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 |  |
diff --git a/docs/registry/attributes/tls.md b/docs/registry/attributes/tls.md
index 8038a425a2..8935731207 100644
--- a/docs/registry/attributes/tls.md
+++ b/docs/registry/attributes/tls.md
@@ -3,9 +3,6 @@
# TLS
-- [TLS Attributes](#tls-attributes)
-- [TLS Deprecated Attributes](#tls-deprecated-attributes)
-
## TLS Attributes
This document defines semantic convention attributes in the TLS namespace.
@@ -54,12 +51,11 @@ This document defines semantic convention attributes in the TLS namespace.
| `ssl` | ssl |  |
| `tls` | tls |  |
-## TLS Deprecated Attributes
-
-Describes deprecated `tls` attributes.
-
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `tls.client.server_name` | 
Replaced by `server.address`. | string | Deprecated, use `server.address` instead. | `opentelemetry.io` |
+| `tls.client.server_name` | string | Deprecated, use `server.address` instead. | `opentelemetry.io` | Use `server.address` instead. |
+
+
diff --git a/docs/registry/attributes/vcs.md b/docs/registry/attributes/vcs.md
index ad4d01ab6b..f22332ce08 100644
--- a/docs/registry/attributes/vcs.md
+++ b/docs/registry/attributes/vcs.md
@@ -149,15 +149,16 @@ the `.git` extension.
Describes deprecated vcs attributes.
-**Attributes:**
+
+Deprecated Attributes:
-| Key | Stability | Value Type | Description | Example Values |
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
|---|---|---|---|---|
-| `vcs.repository.change.id` | 
Replaced by `vcs.change.id`. | string | Deprecated, use `vcs.change.id` instead. | `123` |
-| `vcs.repository.change.title` | 
Replaced by `vcs.change.title`. | string | Deprecated, use `vcs.change.title` instead. | `Fixes broken thing`; `feat: add my new feature`; `[chore] update dependency` |
-| `vcs.repository.ref.name` | 
Replaced by `vcs.ref.head.name`. | string | Deprecated, use `vcs.ref.head.name` instead. | `my-feature-branch`; `tag-1-test` |
-| `vcs.repository.ref.revision` | 
Replaced by `vcs.ref.head.revision`. | string | Deprecated, use `vcs.ref.head.revision` instead. | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` |
-| `vcs.repository.ref.type` | 
Replaced by `vcs.ref.head.type`. | string | Deprecated, use `vcs.ref.head.type` instead. | `branch`; `tag` |
+| `vcs.repository.change.id` | string | Deprecated, use `vcs.change.id` instead. | `123` | 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` | Use `vcs.change.title` instead. |
+| `vcs.repository.ref.name` | string | Deprecated, use `vcs.ref.head.name` instead. | `my-feature-branch`; `tag-1-test` | Use `vcs.ref.head.name` instead. |
+| `vcs.repository.ref.revision` | string | Deprecated, use `vcs.ref.head.revision` instead. | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` | Use `vcs.ref.head.revision` instead. |
+| `vcs.repository.ref.type` | string | Deprecated, use `vcs.ref.head.type` instead. | `branch`; `tag` | Use `vcs.ref.head.type` instead. |
---
@@ -167,3 +168,5 @@ Describes deprecated vcs attributes.
|---|---|---|
| `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) |  |
| `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) |  |
+
+
diff --git a/templates/registry/markdown/attribute_macros.j2 b/templates/registry/markdown/attribute_macros.j2
index cc05fcb679..b9884ffe08 100644
--- a/templates/registry/markdown/attribute_macros.j2
+++ b/templates/registry/markdown/attribute_macros.j2
@@ -20,6 +20,8 @@
{% 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 renamed_to_with_link(attribute, attribute_registry_base_url, lineage_attributes) %}[`{{attribute}}`]({{attribute_registry_base_url}}/{{ find_lineage(attribute, lineage_attributes) | split_id | list | reject("eq", "registry")| first | kebab_case }}.md){% 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 479bb23b8c..65214394c0 100644
--- a/templates/registry/markdown/attribute_namespace.md.j2
+++ b/templates/registry/markdown/attribute_namespace.md.j2
@@ -6,14 +6,27 @@
{%- import 'stability.j2' as stability -%}
{%- import 'notes.j2' as notes -%}
{%- import 'enum_macros.j2' as enums -%}
+{%- import 'attribute_table.j2' as at -%}
{%- import 'attribute_macros.j2' as attrs -%}
{%- import 'examples_macros.j2' as examples -%}
{%- set groups = namespace(deprecated=[], non_deprecated=[]) -%}
{%- for group in ctx.groups | sort(attribute="id") -%}
{%- if group.id[-10:] == "deprecated" -%}
+{% if ctx.groups | selectattr("id", "eq", group.id[:-11]) | length != 1 %}
{%- set groups.deprecated = groups.deprecated + [group] -%}
+{% endif %}
{%- else -%}
+{% set deprecatedAttrs = ctx.groups | selectattr("id", "eq", group.id + ".deprecated") %}{% if deprecatedAttrs | length > 0 %}{% set combined = {
+ "brief": group.brief,
+ "note": group.note,
+ "id": group.id,
+ "attributes": group.attributes + deprecatedAttrs[0].attributes,
+ "display_name": group.display_name
+ } %}
+{%- set groups.non_deprecated = groups.non_deprecated + [combined] -%}
+{% else %}
{%- set groups.non_deprecated = groups.non_deprecated + [group] -%}
+{% endif %}
{%- endif -%}
{%- endfor -%}
{%- set attr_groups = groups.non_deprecated + groups.deprecated -%}
@@ -37,15 +50,17 @@
{{ group.brief }}
{{"\n"}}
{%- endif -%}
-**Attributes:**
+
+{% set filtered_attributes = group.attributes | rejectattr("deprecated") | sort(attribute="name") %}{% if filtered_attributes | length > 0 %}**Attributes:**
| Key | Stability | Value Type | Description | Example Values |
|---|---|---|---|---|
-{%- for attribute in group.attributes | sort(attribute="name") %}{% set attr_anchor = attribute.name | kebab_case %}
+{%- for attribute in filtered_attributes %}{% set attr_anchor = attribute.name | kebab_case %}
| `{{ attrs.name(attribute) }}` | {{ stability.badge(attribute.stability, attribute.deprecated, attribute.brief) | trim }} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add({"note": attribute.note, "name": attrs.name(attribute)}) }} | {{ examples.format(attribute) | trim }} |
{%- endfor %}
{{ notes.render() }}
-{%- for enum in group.attributes | sort(attribute="name") %}
+{%- for enum in filtered_attributes | sort(attribute="name") %}
{%- if enum.type is mapping -%}{{ enums.table(enum, notes) }}{% endif %}
-{%- endfor -%}
+{%- endfor -%}{% endif %}{% if (group.attributes | selectattr("deprecated")) and filtered_attributes %}{{"\n"}}{% endif %}{{ at.generate_deprecated(group.attributes, "", "", "") | trim }}{% if filtered_attributes | length != group.attributes | length %}{{"\n"}}{%endif%}
+
{%- endfor -%}
diff --git a/templates/registry/markdown/attribute_table.j2 b/templates/registry/markdown/attribute_table.j2
index b3bc133a86..d1d2075d0d 100644
--- a/templates/registry/markdown/attribute_table.j2
+++ b/templates/registry/markdown/attribute_table.j2
@@ -6,10 +6,21 @@
{% 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, title) %}{% if (tag_filter | length == 0) %}{% set filtered_attributes = attributes %}{% else %}{% set filtered_attributes = attributes | selectattr("tag", "in", tag_filter) %}{% endif %}{% if (filtered_attributes is defined) and (filtered_attributes | length > 0) %}{% if title and title != "Other" and title != "" %}**{{title}}:**{% elif title is undefined or title != "Other" %}**Attributes:**{%endif%}
+{% macro generate(attributes, tag_filter, attribute_registry_base_url, lineage_attributes, title) %}{% if (tag_filter | length == 0) %}{% set filtered_attributes = attributes | rejectattr("deprecated") | attribute_sort %}{% else %}{% set filtered_attributes = attributes | rejectattr("deprecated") | selectattr("tag", "in", tag_filter) | attribute_sort %}{% endif %}{% if (filtered_attributes is defined) and (filtered_attributes | length > 0) %}{% if title and title != "Other" and title != "" %}**{{title}}:**{% elif title is undefined or title != "Other" %}**Attributes:**{%endif%}
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
|---|---|---|---|---|---|
-{% for attribute in filtered_attributes | attribute_sort %}| {{ attrs.name_with_link(attribute, attribute_registry_base_url, lineage_attributes) }} | {{ stability.badge(attribute.stability, attribute.deprecated, attribute.brief) | trim }} | {{ requirement.render({"level": attribute.requirement_level, "name": attrs.name(attribute)}, notes) | trim }} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add({"note": attribute.note, "name": attrs.name(attribute)}) }} | {{ examples.format(attribute) | trim }} |
+{% for attribute in filtered_attributes %}| {{ attrs.name_with_link(attribute, attribute_registry_base_url, lineage_attributes) }} | {{ stability.badge(attribute.stability, attribute.deprecated, attribute.brief) | trim }} | {{ requirement.render({"level": attribute.requirement_level, "name": attrs.name(attribute), "deprecated": attribute.deprecated}, notes) | trim }} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add({"note": attribute.note, "name": attrs.name(attribute)}) }} | {{ examples.format(attribute) | trim }} |
{% endfor %}{{ notes.render() }}{{ sampling.snippet(filtered_attributes, attribute_registry_base_url, lineage_attributes) }}{{ enums.tables(filtered_attributes | selectattr("type", "mapping"), notes) }}
+{% endif %}{{ generate_deprecated(attributes, tag_filter, attribute_registry_base_url, lineage_attributes)}}{% endmacro %}
+
+{#- Macro for creating deprecated attribute table -#}
+{% macro generate_deprecated(attributes, tag_filter, attribute_registry_base_url, lineage_attributes) %}{% if (tag_filter | length == 0) %}{% set filtered_attributes = attributes | selectattr("deprecated") | attribute_sort %}{% else %}{% set filtered_attributes = attributes | selectattr("tag", "in", tag_filter) | attribute_sort %}{% endif %}{% if (filtered_attributes is defined) and (filtered_attributes | length > 0) %}
+Deprecated Attributes:
+
+| Key | Value Type | Summary | Example Values | Deprecation Explanation |
+|---|---|---|---|---|
+{% for attribute in filtered_attributes %}| {% if attribute_registry_base_url != "" %}{{ attrs.name_with_link(attribute, attribute_registry_base_url, lineage_attributes) }}{% else %}{% set attr_anchor = attribute.name | kebab_case %}`{{ attrs.name(attribute) }}`{%endif%} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add({"note": attribute.note, "name": attrs.name(attribute)}) }} | {{ examples.format(attribute) | trim }} | {% if attribute.deprecated.reason == "renamed" %} Use {% if attribute_registry_base_url != "" %}{{ attrs.renamed_to_with_link(attribute.deprecated.renamed_to, attribute_registry_base_url, lineage_attributes) }}{% else %}`{{attribute.deprecated.renamed_to}}`{%endif%} instead. {% else %} {{attribute.deprecated.note | trim}} {% endif %} |
+{% endfor %}{{ notes.render() }}{{ sampling.snippet(filtered_attributes, attribute_registry_base_url, lineage_attributes) }}{{ enums.tables(filtered_attributes | selectattr("type", "mapping"), notes) }}
+
{% endif %}{% endmacro %}