[receiver/oracledb] Address semconv review: singular units, lean descriptions, simpler tests

Author: rluidash

receiver/oracledbreceiver/documentation.md

@@ -329,23 +329,23 @@ Fraction of host CPU time in use, as computed by Oracle V$SYSMETRIC (% Busy/(Idl
 
 ### oracledb.jvm.memory.committed
 
-Committed (total) size in bytes of Oracle's in-database JVM (OJVM) call heap. Sourced from v$sysstat name java call heap total size. Mirrors semconv jvm.memory.committed for the embedded OJVM.
+Committed (total) size in bytes of Oracle's in-database JVM (OJVM) call heap.
 
 | Unit | Metric Type | Value Type | Stability |
 | ---- | ----------- | ---------- | --------- |
 | By | Gauge | Int | Development |
 
 ### oracledb.jvm.memory.live
 
-Size in bytes of live objects in Oracle's in-database JVM (OJVM) call heap. Sourced from v$sysstat name java call heap live size. No semconv jvm.memory equivalent.
+Size in bytes of live objects in Oracle's in-database JVM (OJVM) call heap.
 
 | Unit | Metric Type | Value Type | Stability |
 | ---- | ----------- | ---------- | --------- |
 | By | Gauge | Int | Development |
 
 ### oracledb.jvm.memory.used
 
-Used size in bytes of Oracle's in-database JVM (OJVM) call heap. Sourced from v$sysstat name java call heap used size. Mirrors semconv jvm.memory.used for the embedded OJVM.
+Used size in bytes of Oracle's in-database JVM (OJVM) call heap.
 
 | Unit | Metric Type | Value Type | Stability |
 | ---- | ----------- | ---------- | --------- |
@@ -369,11 +369,11 @@ Number of logon operations
 
 ### oracledb.os.swaps
 
-Number of OS swap operations, as accounted by Oracle. Sourced from v$sysstat name OS Swaps.
+Number of OS swap operations.
 
 | Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability |
 | ---- | ----------- | ---------- | ----------------------- | --------- | --------- |
-| {swaps} | Sum | Int | Cumulative | true | Development |
+| {swap} | Sum | Int | Cumulative | true | Development |
 
 ### oracledb.parallel_operations_downgraded_1_to_25_pct
 
@@ -549,15 +549,15 @@ Fraction of redo allocations that succeeded without space contention, as compute
 
 ### oracledb.session.stored_procedure.usage
 
-Memory in bytes currently allocated for stored procedures in the session. Sourced from v$sysstat name session stored procedure space.
+Memory in bytes currently allocated for stored procedures in the session.
 
 | Unit | Metric Type | Value Type | Stability |
 | ---- | ----------- | ---------- | --------- |
 | By | Gauge | Int | Development |
 
 ### oracledb.session.wait.time
 
-Cumulative time sessions spent in non-idle waits, in seconds (converted from centiseconds). Sourced from v$sysstat name non-idle wait time.
+Cumulative time sessions spent in non-idle waits, in seconds.
 
 | Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability |
 | ---- | ----------- | ---------- | ----------------------- | --------- | --------- |
@@ -567,21 +567,21 @@ Cumulative time sessions spent in non-idle waits, in seconds (converted from cen
 
 | Name | Description | Values | Requirement Level | Semantic Convention |
 | ---- | ----------- | ------ | ----------------- | ------------------- |
-| oracledb.session.wait.state | Whether the session wait time/count is for idle or non-idle wait events. Oracle's v$sysstat currently exposes only the non-idle aggregate. | Str: ``non_idle`` | Recommended | - |
+| oracledb.session.wait.state | Whether the session wait time/count is for idle or non-idle wait events. | Str: ``non_idle`` | Recommended | - |
 
 ### oracledb.session.waits
 
-Cumulative number of non-idle waits across sessions. Sourced from v$sysstat name non-idle wait count.
+Cumulative number of non-idle waits across sessions.
 
 | Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability |
 | ---- | ----------- | ---------- | ----------------------- | --------- | --------- |
-| {waits} | Sum | Int | Cumulative | true | Development |
+| {wait} | Sum | Int | Cumulative | true | Development |
 
 #### Attributes
 
 | Name | Description | Values | Requirement Level | Semantic Convention |
 | ---- | ----------- | ------ | ----------------- | ------------------- |
-| oracledb.session.wait.state | Whether the session wait time/count is for idle or non-idle wait events. Oracle's v$sysstat currently exposes only the non-idle aggregate. | Str: ``non_idle`` | Recommended | - |
+| oracledb.session.wait.state | Whether the session wait time/count is for idle or non-idle wait events. | Str: ``non_idle`` | Recommended | - |
 
 ### oracledb.shared_pool.utilization
 

receiver/oracledbreceiver/internal/metadata/generated_metrics.go

@@ -251,7 +251,7 @@ attributes:
     description: "The timestamp when the session logged on, in ISO 8601 format (UTC)."
     type: string
   oracledb.session.wait.state:
-    description: Whether the session wait time/count is for idle or non-idle wait events. Oracle's v$sysstat currently exposes only the non-idle aggregate.
+    description: Whether the session wait time/count is for idle or non-idle wait events.
     type: string
     enum: [non_idle]
   oracledb.sid:
@@ -578,23 +578,23 @@ metrics:
       value_type: double
     unit: "%"
   oracledb.jvm.memory.committed:
-    description: Committed (total) size in bytes of Oracle's in-database JVM (OJVM) call heap. Sourced from v$sysstat name java call heap total size. Mirrors semconv jvm.memory.committed for the embedded OJVM.
+    description: Committed (total) size in bytes of Oracle's in-database JVM (OJVM) call heap.
     enabled: false
     stability: development
     gauge:
       value_type: int
       input_type: string
     unit: By
   oracledb.jvm.memory.live:
-    description: Size in bytes of live objects in Oracle's in-database JVM (OJVM) call heap. Sourced from v$sysstat name java call heap live size. No semconv jvm.memory equivalent.
+    description: Size in bytes of live objects in Oracle's in-database JVM (OJVM) call heap.
     enabled: false
     stability: development
     gauge:
       value_type: int
       input_type: string
     unit: By
   oracledb.jvm.memory.used:
-    description: Used size in bytes of Oracle's in-database JVM (OJVM) call heap. Sourced from v$sysstat name java call heap used size. Mirrors semconv jvm.memory.used for the embedded OJVM.
+    description: Used size in bytes of Oracle's in-database JVM (OJVM) call heap.
     enabled: false
     stability: development
     gauge:
@@ -629,15 +629,15 @@ metrics:
       input_type: string
     unit: "{operation}"
   oracledb.os.swaps:
-    description: Number of OS swap operations, as accounted by Oracle. Sourced from v$sysstat name OS Swaps.
+    description: Number of OS swap operations.
     enabled: false
     stability: development
     sum:
       aggregation_temporality: cumulative
       monotonic: true
       value_type: int
       input_type: string
-    unit: "{swaps}"
+    unit: "{swap}"
   oracledb.parallel_operations_downgraded_1_to_25_pct:
     description: Number of times parallel execution was requested and the degree of parallelism was reduced down to 1-25% because of insufficient parallel execution servers
     enabled: false
@@ -867,7 +867,7 @@ metrics:
       value_type: double
     unit: "%"
   oracledb.session.stored_procedure.usage:
-    description: Memory in bytes currently allocated for stored procedures in the session. Sourced from v$sysstat name session stored procedure space.
+    description: Memory in bytes currently allocated for stored procedures in the session.
     enabled: false
     stability: development
     gauge:
@@ -877,7 +877,7 @@ metrics:
   oracledb.session.wait.time:
     attributes:
       - oracledb.session.wait.state
-    description: Cumulative time sessions spent in non-idle waits, in seconds (converted from centiseconds). Sourced from v$sysstat name non-idle wait time.
+    description: Cumulative time sessions spent in non-idle waits, in seconds.
     enabled: false
     stability: development
     sum:
@@ -888,15 +888,15 @@ metrics:
   oracledb.session.waits:
     attributes:
       - oracledb.session.wait.state
-    description: Cumulative number of non-idle waits across sessions. Sourced from v$sysstat name non-idle wait count.
+    description: Cumulative number of non-idle waits across sessions.
     enabled: false
     stability: development
     sum:
       aggregation_temporality: cumulative
       monotonic: true
       value_type: int
       input_type: string
-    unit: "{waits}"
+    unit: "{wait}"
   oracledb.sessions.limit:
     description: Maximum limit of active sessions, -1 if unlimited.
     enabled: true