enable metrics

Author: jaydeluca

.gitignore

@@ -57,7 +57,7 @@ derby.log
 hs_err_pid*
 replay_pid*
 .attach_pid*
-**/.telemetry*
+.telemetry*
 
 !java-agent/benchmark/releases/*.jar
 

docs/instrumentation-list.yaml

@@ -167,6 +167,22 @@ libraries:
     target_versions:
       javaagent:
       - org.apache.httpcomponents.client5:httpclient5:[5.0,)
+    metrics:
+    - name: http.client.request.duration
+      description: Duration of HTTP client requests.
+      type: HISTOGRAM
+      unit: s
+      attributes:
+      - name: http.request.method
+        type: STRING
+      - name: http.response.status_code
+        type: LONG
+      - name: network.protocol.version
+        type: STRING
+      - name: server.address
+        type: STRING
+      - name: server.port
+        type: LONG
   - name: apache-dbcp-2.0
     source_path: instrumentation/apache-dbcp-2.0
     scope:
@@ -176,6 +192,38 @@ libraries:
       - org.apache.commons:commons-dbcp2:[2,)
       library:
       - org.apache.commons:commons-dbcp2:2.0
+    metrics:
+    - name: db.client.connections.usage
+      description: The number of connections that are currently in state described
+        by the state attribute.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+      - name: state
+        type: STRING
+    - name: db.client.connections.max
+      description: The maximum number of open connections allowed.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.idle.min
+      description: The minimum number of idle open connections allowed.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.idle.max
+      description: The maximum number of idle open connections allowed.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
   armeria:
   - name: armeria-1.3
     source_path: instrumentation/armeria/armeria-1.3
@@ -294,6 +342,35 @@ libraries:
       - software.amazon.awssdk:sqs:2.2.0
       - software.amazon.awssdk:sns:2.2.0
       - software.amazon.awssdk:lambda:2.2.0
+    configurations:
+    - name: otel.instrumentation.messaging.experimental.receive-telemetry.enabled
+      description: Enables experimental receive telemetry for AWS SDK instrumentation.
+      type: boolean
+      default: false
+    - name: otel.instrumentation.messaging.experimental.capture-headers
+      description: Allows configuring headers to capture as span attributes.
+      type: list
+      default: ''
+    - name: otel.instrumentation.aws-sdk.experimental-span-attributes
+      description: Enables experimental span attributes for AWS SDK instrumentation.
+      type: boolean
+      default: false
+    - name: otel.instrumentation.aws-sdk.experimental-use-propagator-for-messaging
+      description: Determines whether the configured TextMapPropagator should be used
+        to inject into supported messaging attributes (for SQS).
+      type: boolean
+      default: false
+    - name: otel.instrumentation.genai.capture-message-content
+      description: Determines whether Generative AI events include full content of
+        user and assistant messages. Note that full content can have data privacy
+        and size concerns and care should be taken when enabling this
+      type: boolean
+      default: false
+    - name: otel.instrumentation.aws-sdk.experimental-record-individual-http-error
+      description: Determines whether errors returned by each individual HTTP request
+        should be recorded as events for the SDK span.
+      type: boolean
+      default: false
   azure:
   - name: azure-core-1.36
     source_path: instrumentation/azure-core/azure-core-1.36
@@ -318,6 +395,8 @@ libraries:
       - com.azure:azure-core:[1.14.0,1.19.0)
   c3p0:
   - name: c3p0-0.9
+    description: The c3p0 instrumentation provides connection pool metrics for c3p0
+      data sources.
     source_path: instrumentation/c3p0-0.9
     scope:
       name: io.opentelemetry.c3p0-0.9
@@ -326,14 +405,40 @@ libraries:
       - com.mchange:c3p0:(,)
       library:
       - com.mchange:c3p0:0.9.2
+    metrics:
+    - name: db.client.connections.usage
+      description: The number of connections that are currently in state described
+        by the state attribute.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+      - name: state
+        type: STRING
+    - name: db.client.connections.pending_requests
+      description: The number of pending requests for an open connection, cumulative
+        for the entire pool.
+      type: LONG_SUM
+      unit: requests
+      attributes:
+      - name: pool.name
+        type: STRING
   camel:
   - name: camel-2.20
+    description: This instrumentation provides support for Apache Camel and generates
+      spans for each route execution.
     source_path: instrumentation/camel-2.20
     scope:
       name: io.opentelemetry.camel-2.20
     target_versions:
       javaagent:
       - org.apache.camel:camel-core:[2.19,3)
+    configurations:
+    - name: otel.instrumentation.camel.experimental-span-attributes
+      description: Enable the capture of experimental span attributes.
+      type: boolean
+      default: false
   cassandra:
   - name: cassandra-4.0
     description: |
@@ -396,6 +501,8 @@ libraries:
       default: true
   couchbase:
   - name: couchbase-3.1.6
+    description: |
+      Couchbase instrumentation is owned upstream. This Couchbase instrumentation works by intercepting the constructor of the CoreEnvironment.Builder class. On construction, it automatically sets the Couchbase requestTracer to use an OpenTelemetryRequestTracer that wraps the agent's TracerProvider. This enables distributed tracing for Couchbase operations using OpenTelemetry, without requiring manual configuration by the user.
     source_path: instrumentation/couchbase/couchbase-3.1.6
     scope:
       name: io.opentelemetry.couchbase-3.1.6
@@ -409,21 +516,37 @@ libraries:
     target_versions:
       javaagent:
       - com.couchbase.client:java-client:[2.6.0,3)
+    configurations:
+    - name: otel.instrumentation.couchbase.experimental-span-attributes
+      description: Enables experimental span attributes couchbase.operation_id and
+        couchbase.local.address
+      type: boolean
+      default: false
   - name: couchbase-2.0
     source_path: instrumentation/couchbase/couchbase-2.0
     scope:
       name: io.opentelemetry.couchbase-2.0
     target_versions:
       javaagent:
       - com.couchbase.client:java-client:[2,3)
+    configurations:
+    - name: otel.instrumentation.couchbase.experimental-span-attributes
+      description: Enables experimental span attributes couchbase.operation_id and
+        couchbase.local.address
+      type: boolean
+      default: false
   - name: couchbase-3.2
+    description: |
+      Couchbase instrumentation is owned upstream. This Couchbase instrumentation works by intercepting the constructor of the CoreEnvironment.Builder class. On construction, it automatically sets the Couchbase requestTracer to use an OpenTelemetryRequestTracer that wraps the agent's TracerProvider. This enables distributed tracing for Couchbase operations using OpenTelemetry, without requiring manual configuration by the user.
     source_path: instrumentation/couchbase/couchbase-3.2
     scope:
       name: io.opentelemetry.couchbase-3.2
     target_versions:
       javaagent:
       - com.couchbase.client:java-client:[3.2.0,)
   - name: couchbase-3.1
+    description: |
+      Couchbase instrumentation is owned upstream. This instrumentation hooks into the CoreEnvironment.Builder constructor and automatically sets the Couchbase requestTracer to use an OpenTelemetry tracer from the agent. This enables distributed tracing for Couchbase operations using OpenTelemetry, without requiring manual configuration by the user.
     source_path: instrumentation/couchbase/couchbase-3.1
     scope:
       name: io.opentelemetry.couchbase-3.1
@@ -432,20 +555,37 @@ libraries:
       - com.couchbase.client:java-client:[3.1,3.1.6)
   dropwizard:
   - name: dropwizard-metrics-4.0
+    description: |
+      The dropwizard-metrics instrumentation for the dropwizard/codahale metrics library produces OpenTelemetry compliant versions of the metrics generated by the MetricRegistry.
+      The Dropwizard metrics API does not have a concept of metric labels/tags/attributes, thus the data produced by this integration might be of very low quality, depending on how the API is used in the instrumented application.
     disabled_by_default: true
     source_path: instrumentation/dropwizard/dropwizard-metrics-4.0
     scope:
       name: io.opentelemetry.dropwizard-metrics-4.0
     target_versions:
       javaagent:
       - io.dropwizard.metrics:metrics-core:[4.0.0,)
+    configurations:
+    - name: otel.instrumentation.dropwizard-metrics.enabled
+      description: Enables the dropwizard metrics instrumentation.
+      type: boolean
+      default: false
   - name: dropwizard-views-0.7
     source_path: instrumentation/dropwizard/dropwizard-views-0.7
     scope:
       name: io.opentelemetry.dropwizard-views-0.7
     target_versions:
       javaagent:
       - io.dropwizard:dropwizard-views:(,3.0.0)
+    configurations:
+    - name: otel.instrumentation.common.experimental.view-telemetry.enabled
+      description: Enables experimental view telemetry.
+      type: boolean
+      default: false
+    - name: otel.instrumentation.common.experimental.controller-telemetry.enabled
+      description: Enables experimental controller telemetry.
+      type: boolean
+      default: false
   elasticsearch:
   - name: elasticsearch-rest-6.4
     source_path: instrumentation/elasticsearch/elasticsearch-rest-6.4
@@ -668,6 +808,69 @@ libraries:
       - com.zaxxer:HikariCP:[3.0.0,)
       library:
       - com.zaxxer:HikariCP:3.0.0
+    metrics:
+    - name: db.client.connections.wait_time
+      description: The time it took to obtain an open connection from the pool.
+      type: HISTOGRAM
+      unit: ms
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.usage
+      description: The number of connections that are currently in state described
+        by the state attribute.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+      - name: state
+        type: STRING
+    - name: db.client.connections.pending_requests
+      description: The number of pending requests for an open connection, cumulative
+        for the entire pool.
+      type: LONG_SUM
+      unit: requests
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.timeouts
+      description: The number of connection timeouts that have occurred trying to
+        obtain a connection from the pool.
+      type: LONG_SUM
+      unit: timeouts
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.max
+      description: The maximum number of open connections allowed.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.create_time
+      description: The time it took to create a new connection.
+      type: HISTOGRAM
+      unit: ms
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.idle.min
+      description: The minimum number of idle open connections allowed.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.use_time
+      description: The time between borrowing a connection and returning it to the
+        pool.
+      type: HISTOGRAM
+      unit: ms
+      attributes:
+      - name: pool.name
+        type: STRING
   http:
   - name: http-url-connection
     source_path: instrumentation/http-url-connection
@@ -1910,6 +2113,46 @@ libraries:
     target_versions:
       javaagent:
       - org.apache.tomcat:tomcat-jdbc:[8.5.0,)
+    metrics:
+    - name: db.client.connections.usage
+      description: The number of connections that are currently in state described
+        by the state attribute.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+      - name: state
+        type: STRING
+    - name: db.client.connections.pending_requests
+      description: The number of pending requests for an open connection, cumulative
+        for the entire pool.
+      type: LONG_SUM
+      unit: requests
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.max
+      description: The maximum number of open connections allowed.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.idle.min
+      description: The minimum number of idle open connections allowed.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
+    - name: db.client.connections.idle.max
+      description: The maximum number of idle open connections allowed.
+      type: LONG_SUM
+      unit: connections
+      attributes:
+      - name: pool.name
+        type: STRING
   twilio:
   - name: twilio-6.6
     source_path: instrumentation/twilio-6.6