Skip to content

Commit be902ba

Browse files
committed
Move to deprecation actions
1 parent f43abc8 commit be902ba

20 files changed

+478
-196
lines changed

docs/database/database-metrics.md

Lines changed: 122 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,6 @@ of `[ 0.001, 0.005, 0.01, 0.05, 0.1, 0.5, 1, 5, 10 ]`.
9090
| [`server.port`](/docs/registry/attributes/server.md) | int | Server port number. [10] | `80`; `8080`; `443` | `Conditionally Required` [11] | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
9191
| [`db.query.summary`](/docs/registry/attributes/db.md) | string | Low cardinality summary of a database query. [12] | `SELECT wuser_table`; `INSERT shipping_details SELECT orders`; `get user by id` | `Recommended` [13] | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
9292
| [`db.stored_procedure.name`](/docs/registry/attributes/db.md) | string | The name of a stored procedure within the database. [14] | `GetCustomer` | `Recommended` [15] | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
93-
| [`db.system`](/docs/registry/attributes/db.md) | string | Deprecated, use `db.system.name` instead. | `other_sql`; `adabas`; `cache` | `Migrate` | ![Deprecated](https://img.shields.io/badge/-deprecated-red)<br>Replaced by `db.system.name`. |
9493
| [`network.peer.address`](/docs/registry/attributes/network.md) | string | Peer address of the database node where the operation was performed. [16] | `10.1.2.80`; `/tmp/my.sock` | `Recommended` If applicable for this database system. | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
9594
| [`network.peer.port`](/docs/registry/attributes/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` If and only if `network.peer.address` is set. | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
9695
| [`server.address`](/docs/registry/attributes/server.md) | string | Name of the database host. [17] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
@@ -285,6 +284,67 @@ Parameterized query text SHOULD NOT be sanitized. Even though parameterized quer
285284
|---|---|---|
286285
| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
287286

287+
**Past Attributes:**
288+
| Attribute | Type | Description | Examples | [Deprecation Action](https://opentelemetry.io/docs/specs/semconv/general/attribute-deprecation-action/) | Deprecation Explanation |
289+
|---|---|---|---|---|---|
290+
| [`db.system`](/docs/registry/attributes/db.md) | string | Deprecated, use `db.system.name` instead. | `other_sql`; `adabas`; `cache` | `Migrate` | Use [`db.system.name`](/docs/registry/attributes/db.md) instead. |
291+
292+
---
293+
294+
`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.
295+
296+
| Value | Description | Stability |
297+
|---|---|---|
298+
| `adabas` | Adabas (Adaptable Database System) | ![Development](https://img.shields.io/badge/-development-blue) |
299+
| `cassandra` | Apache Cassandra | ![Development](https://img.shields.io/badge/-development-blue) |
300+
| `clickhouse` | ClickHouse | ![Development](https://img.shields.io/badge/-development-blue) |
301+
| `cockroachdb` | CockroachDB | ![Development](https://img.shields.io/badge/-development-blue) |
302+
| `cosmosdb` | Microsoft Azure Cosmos DB | ![Development](https://img.shields.io/badge/-development-blue) |
303+
| `couchbase` | Couchbase | ![Development](https://img.shields.io/badge/-development-blue) |
304+
| `couchdb` | CouchDB | ![Development](https://img.shields.io/badge/-development-blue) |
305+
| `db2` | IBM Db2 | ![Development](https://img.shields.io/badge/-development-blue) |
306+
| `derby` | Apache Derby | ![Development](https://img.shields.io/badge/-development-blue) |
307+
| `dynamodb` | Amazon DynamoDB | ![Development](https://img.shields.io/badge/-development-blue) |
308+
| `edb` | EnterpriseDB | ![Development](https://img.shields.io/badge/-development-blue) |
309+
| `elasticsearch` | Elasticsearch | ![Development](https://img.shields.io/badge/-development-blue) |
310+
| `filemaker` | FileMaker | ![Development](https://img.shields.io/badge/-development-blue) |
311+
| `firebird` | Firebird | ![Development](https://img.shields.io/badge/-development-blue) |
312+
| `geode` | Apache Geode | ![Development](https://img.shields.io/badge/-development-blue) |
313+
| `h2` | H2 | ![Development](https://img.shields.io/badge/-development-blue) |
314+
| `hanadb` | SAP HANA | ![Development](https://img.shields.io/badge/-development-blue) |
315+
| `hbase` | Apache HBase | ![Development](https://img.shields.io/badge/-development-blue) |
316+
| `hive` | Apache Hive | ![Development](https://img.shields.io/badge/-development-blue) |
317+
| `hsqldb` | HyperSQL DataBase | ![Development](https://img.shields.io/badge/-development-blue) |
318+
| `influxdb` | InfluxDB | ![Development](https://img.shields.io/badge/-development-blue) |
319+
| `informix` | Informix | ![Development](https://img.shields.io/badge/-development-blue) |
320+
| `ingres` | Ingres | ![Development](https://img.shields.io/badge/-development-blue) |
321+
| `instantdb` | InstantDB | ![Development](https://img.shields.io/badge/-development-blue) |
322+
| `interbase` | InterBase | ![Development](https://img.shields.io/badge/-development-blue) |
323+
| `intersystems_cache` | InterSystems Caché | ![Development](https://img.shields.io/badge/-development-blue) |
324+
| `mariadb` | MariaDB | ![Development](https://img.shields.io/badge/-development-blue) |
325+
| `maxdb` | SAP MaxDB | ![Development](https://img.shields.io/badge/-development-blue) |
326+
| `memcached` | Memcached | ![Development](https://img.shields.io/badge/-development-blue) |
327+
| `mongodb` | MongoDB | ![Development](https://img.shields.io/badge/-development-blue) |
328+
| `mssql` | Microsoft SQL Server | ![Development](https://img.shields.io/badge/-development-blue) |
329+
| `mysql` | MySQL | ![Development](https://img.shields.io/badge/-development-blue) |
330+
| `neo4j` | Neo4j | ![Development](https://img.shields.io/badge/-development-blue) |
331+
| `netezza` | Netezza | ![Development](https://img.shields.io/badge/-development-blue) |
332+
| `opensearch` | OpenSearch | ![Development](https://img.shields.io/badge/-development-blue) |
333+
| `oracle` | Oracle Database | ![Development](https://img.shields.io/badge/-development-blue) |
334+
| `other_sql` | Some other SQL database. Fallback only. See notes. | ![Development](https://img.shields.io/badge/-development-blue) |
335+
| `pervasive` | Pervasive PSQL | ![Development](https://img.shields.io/badge/-development-blue) |
336+
| `pointbase` | PointBase | ![Development](https://img.shields.io/badge/-development-blue) |
337+
| `postgresql` | PostgreSQL | ![Development](https://img.shields.io/badge/-development-blue) |
338+
| `progress` | Progress Database | ![Development](https://img.shields.io/badge/-development-blue) |
339+
| `redis` | Redis | ![Development](https://img.shields.io/badge/-development-blue) |
340+
| `redshift` | Amazon Redshift | ![Development](https://img.shields.io/badge/-development-blue) |
341+
| `spanner` | Cloud Spanner | ![Development](https://img.shields.io/badge/-development-blue) |
342+
| `sqlite` | SQLite | ![Development](https://img.shields.io/badge/-development-blue) |
343+
| `sybase` | Sybase | ![Development](https://img.shields.io/badge/-development-blue) |
344+
| `teradata` | Teradata | ![Development](https://img.shields.io/badge/-development-blue) |
345+
| `trino` | Trino | ![Development](https://img.shields.io/badge/-development-blue) |
346+
| `vertica` | Vertica | ![Development](https://img.shields.io/badge/-development-blue) |
347+
288348
<!-- markdownlint-restore -->
289349
<!-- prettier-ignore-end -->
290350
<!-- END AUTOGENERATED TEXT -->
@@ -334,7 +394,6 @@ Explaining bucket configuration:
334394
| [`error.type`](/docs/registry/attributes/error.md) | string | Describes a class of error the operation ended with. [9] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | `Conditionally Required` If and only if the operation failed. | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
335395
| [`server.port`](/docs/registry/attributes/server.md) | int | Server port number. [10] | `80`; `8080`; `443` | `Conditionally Required` [11] | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
336396
| [`db.query.summary`](/docs/registry/attributes/db.md) | string | Low cardinality summary of a database query. [12] | `SELECT wuser_table`; `INSERT shipping_details SELECT orders`; `get user by id` | `Recommended` [13] | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
337-
| [`db.system`](/docs/registry/attributes/db.md) | string | Deprecated, use `db.system.name` instead. | `other_sql`; `adabas`; `cache` | `Migrate` | ![Deprecated](https://img.shields.io/badge/-deprecated-red)<br>Replaced by `db.system.name`. |
338397
| [`network.peer.address`](/docs/registry/attributes/network.md) | string | Peer address of the database node where the operation was performed. [14] | `10.1.2.80`; `/tmp/my.sock` | `Recommended` If applicable for this database system. | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
339398
| [`network.peer.port`](/docs/registry/attributes/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` If and only if `network.peer.address` is set. | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
340399
| [`server.address`](/docs/registry/attributes/server.md) | string | Name of the database host. [15] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
@@ -521,6 +580,67 @@ Parameterized query text SHOULD NOT be sanitized. Even though parameterized quer
521580
|---|---|---|
522581
| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
523582

583+
**Past Attributes:**
584+
| Attribute | Type | Description | Examples | [Deprecation Action](https://opentelemetry.io/docs/specs/semconv/general/attribute-deprecation-action/) | Deprecation Explanation |
585+
|---|---|---|---|---|---|
586+
| [`db.system`](/docs/registry/attributes/db.md) | string | Deprecated, use `db.system.name` instead. | `other_sql`; `adabas`; `cache` | `Migrate` | Use [`db.system.name`](/docs/registry/attributes/db.md) instead. |
587+
588+
---
589+
590+
`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.
591+
592+
| Value | Description | Stability |
593+
|---|---|---|
594+
| `adabas` | Adabas (Adaptable Database System) | ![Development](https://img.shields.io/badge/-development-blue) |
595+
| `cassandra` | Apache Cassandra | ![Development](https://img.shields.io/badge/-development-blue) |
596+
| `clickhouse` | ClickHouse | ![Development](https://img.shields.io/badge/-development-blue) |
597+
| `cockroachdb` | CockroachDB | ![Development](https://img.shields.io/badge/-development-blue) |
598+
| `cosmosdb` | Microsoft Azure Cosmos DB | ![Development](https://img.shields.io/badge/-development-blue) |
599+
| `couchbase` | Couchbase | ![Development](https://img.shields.io/badge/-development-blue) |
600+
| `couchdb` | CouchDB | ![Development](https://img.shields.io/badge/-development-blue) |
601+
| `db2` | IBM Db2 | ![Development](https://img.shields.io/badge/-development-blue) |
602+
| `derby` | Apache Derby | ![Development](https://img.shields.io/badge/-development-blue) |
603+
| `dynamodb` | Amazon DynamoDB | ![Development](https://img.shields.io/badge/-development-blue) |
604+
| `edb` | EnterpriseDB | ![Development](https://img.shields.io/badge/-development-blue) |
605+
| `elasticsearch` | Elasticsearch | ![Development](https://img.shields.io/badge/-development-blue) |
606+
| `filemaker` | FileMaker | ![Development](https://img.shields.io/badge/-development-blue) |
607+
| `firebird` | Firebird | ![Development](https://img.shields.io/badge/-development-blue) |
608+
| `geode` | Apache Geode | ![Development](https://img.shields.io/badge/-development-blue) |
609+
| `h2` | H2 | ![Development](https://img.shields.io/badge/-development-blue) |
610+
| `hanadb` | SAP HANA | ![Development](https://img.shields.io/badge/-development-blue) |
611+
| `hbase` | Apache HBase | ![Development](https://img.shields.io/badge/-development-blue) |
612+
| `hive` | Apache Hive | ![Development](https://img.shields.io/badge/-development-blue) |
613+
| `hsqldb` | HyperSQL DataBase | ![Development](https://img.shields.io/badge/-development-blue) |
614+
| `influxdb` | InfluxDB | ![Development](https://img.shields.io/badge/-development-blue) |
615+
| `informix` | Informix | ![Development](https://img.shields.io/badge/-development-blue) |
616+
| `ingres` | Ingres | ![Development](https://img.shields.io/badge/-development-blue) |
617+
| `instantdb` | InstantDB | ![Development](https://img.shields.io/badge/-development-blue) |
618+
| `interbase` | InterBase | ![Development](https://img.shields.io/badge/-development-blue) |
619+
| `intersystems_cache` | InterSystems Caché | ![Development](https://img.shields.io/badge/-development-blue) |
620+
| `mariadb` | MariaDB | ![Development](https://img.shields.io/badge/-development-blue) |
621+
| `maxdb` | SAP MaxDB | ![Development](https://img.shields.io/badge/-development-blue) |
622+
| `memcached` | Memcached | ![Development](https://img.shields.io/badge/-development-blue) |
623+
| `mongodb` | MongoDB | ![Development](https://img.shields.io/badge/-development-blue) |
624+
| `mssql` | Microsoft SQL Server | ![Development](https://img.shields.io/badge/-development-blue) |
625+
| `mysql` | MySQL | ![Development](https://img.shields.io/badge/-development-blue) |
626+
| `neo4j` | Neo4j | ![Development](https://img.shields.io/badge/-development-blue) |
627+
| `netezza` | Netezza | ![Development](https://img.shields.io/badge/-development-blue) |
628+
| `opensearch` | OpenSearch | ![Development](https://img.shields.io/badge/-development-blue) |
629+
| `oracle` | Oracle Database | ![Development](https://img.shields.io/badge/-development-blue) |
630+
| `other_sql` | Some other SQL database. Fallback only. See notes. | ![Development](https://img.shields.io/badge/-development-blue) |
631+
| `pervasive` | Pervasive PSQL | ![Development](https://img.shields.io/badge/-development-blue) |
632+
| `pointbase` | PointBase | ![Development](https://img.shields.io/badge/-development-blue) |
633+
| `postgresql` | PostgreSQL | ![Development](https://img.shields.io/badge/-development-blue) |
634+
| `progress` | Progress Database | ![Development](https://img.shields.io/badge/-development-blue) |
635+
| `redis` | Redis | ![Development](https://img.shields.io/badge/-development-blue) |
636+
| `redshift` | Amazon Redshift | ![Development](https://img.shields.io/badge/-development-blue) |
637+
| `spanner` | Cloud Spanner | ![Development](https://img.shields.io/badge/-development-blue) |
638+
| `sqlite` | SQLite | ![Development](https://img.shields.io/badge/-development-blue) |
639+
| `sybase` | Sybase | ![Development](https://img.shields.io/badge/-development-blue) |
640+
| `teradata` | Teradata | ![Development](https://img.shields.io/badge/-development-blue) |
641+
| `trino` | Trino | ![Development](https://img.shields.io/badge/-development-blue) |
642+
| `vertica` | Vertica | ![Development](https://img.shields.io/badge/-development-blue) |
643+
524644
<!-- markdownlint-restore -->
525645
<!-- prettier-ignore-end -->
526646
<!-- END AUTOGENERATED TEXT -->

0 commit comments

Comments
 (0)