Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 0d7fb76

Browse files
committedMar 19, 2025·
- Add the generated oracledb.md
1 parent 1dbaba9 commit 0d7fb76

File tree

1 file changed

+5
-10
lines changed

1 file changed

+5
-10
lines changed
 

‎docs/database/oracledb.md

+5-10
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ The following table outlines the span attributes applicable to Oracle Database.
3232

3333
| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
3434
|---|---|---|---|---|---|
35-
| [`db.namespace`](/docs/attributes-registry/db.md) | string | The service name associated with the connection. [1] | `db_high.adb.oraclecloud.com`; `db_low.adb.oraclecloud.com` | `Conditionally Required` If available without an additional network call. | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) |
35+
| [`db.namespace`](/docs/attributes-registry/db.md) | string | The database associated with the connection, qualified by the instance name, database name and service name. [1] | `ORCL1|PDB1|db_high.adb.oraclecloud.com`; `ORCL1|DB1|db_low.adb.oraclecloud.com` | `Conditionally Required` If available without an additional network call. | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) |
3636
| [`db.response.status_code`](/docs/attributes-registry/db.md) | string | [Oracle Database error number](https://docs.oracle.com/en/error-help/db/) recorded as a string. [2] | `ORA-02813`; `ORA-02613` | `Conditionally Required` If response has ended with warning or an error. | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) |
3737
| [`error.type`](/docs/attributes-registry/error.md) | string | Describes a class of error the operation ended with. [3] | `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) |
3838
| [`server.port`](/docs/attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | `Conditionally Required` [5] | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
@@ -41,15 +41,13 @@ The following table outlines the span attributes applicable to Oracle Database.
4141
| [`db.query.text`](/docs/attributes-registry/db.md) | string | The database query being executed. [9] | `SELECT * FROM wuser_table where username = :mykey` | `Recommended` [10] | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) |
4242
| [`db.response.returned_rows`](/docs/attributes-registry/db.md) | int | Number of rows returned by the operation. | `10`; `30`; `1000` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
4343
| [`oracle.db.client.connection.implicit_release`](/docs/attributes-registry/oracledb.md) | boolean | Boolean flag Indicating if the internal connection is released back to pool or not after executing a query. [11] | `true` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
44-
| [`oracle.db.client.connection.increment`](/docs/attributes-registry/oracledb.md) | int | The number of connections added when the pool needs to expand. | `5` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
45-
| [`oracle.db.instance`](/docs/attributes-registry/oracledb.md) | string | The name of the Oracle Database instance. | `ORCL1` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
46-
| [`oracle.db.pdb_name`](/docs/attributes-registry/oracledb.md) | string | The name of the pluggable database (PDB) the connection is using. | `PDB1` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
4744
| [`server.address`](/docs/attributes-registry/server.md) | string | Name of the database host. [12] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |
4845
| [`db.operation.parameter.<key>`](/docs/attributes-registry/db.md) | string | A database operation parameter, with `<key>` being the parameter name, and the attribute value being a string representation of the parameter value. [13] | `someval`; `55` | `Opt-In` | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) |
4946

50-
**[1] `db.namespace`:** Instrumentation SHOULD document if `db.namespace` reflects the service name provided when the connection was established.
51-
52-
It is RECOMMENDED to capture the value as provided by the application without attempting to do any case normalization.
47+
**[1] `db.namespace`:** `db.namespace` SHOULD be set to the combination of instance name, database name and
48+
service name following the `{instance_name}|{database_name}|{service_name}` pattern.
49+
For CDB architecture, database name would be pdb name. For Non-CDB, it would be
50+
`DB_NAME` parameter.
5351

5452
**[2] `db.response.status_code`:** Oracle Database error codes are vendor specific error codes and don't follow [SQLSTATE](https://wikipedia.org/wiki/SQLSTATE) conventions. All Oracle Database error codes SHOULD be considered errors.
5553

@@ -86,9 +84,6 @@ and SHOULD be provided **at span creation time** (if provided at all):
8684
* [`db.query.summary`](/docs/attributes-registry/db.md)
8785
* [`db.query.text`](/docs/attributes-registry/db.md)
8886
* [`oracle.db.client.connection.implicit_release`](/docs/attributes-registry/oracledb.md)
89-
* [`oracle.db.client.connection.increment`](/docs/attributes-registry/oracledb.md)
90-
* [`oracle.db.instance`](/docs/attributes-registry/oracledb.md)
91-
* [`oracle.db.pdb_name`](/docs/attributes-registry/oracledb.md)
9287
* [`server.address`](/docs/attributes-registry/server.md)
9388
* [`server.port`](/docs/attributes-registry/server.md)
9489

0 commit comments

Comments
 (0)
Please sign in to comment.