groups:
  - id: metric.db.client.operation.duration
    type: metric
    metric_name: db.client.operation.duration
    brief: "Duration of database client operations."
    instrument: histogram
    unit: "s"
    stability: experimental
    extends: attributes.db.client

  - id: metric.db.client.connections.usage
    type: metric
    metric_name: db.client.connections.usage
    stability: experimental
    brief: "The number of connections that are currently in state described by the `state` attribute"
    instrument: updowncounter
    unit: "{connection}"
    attributes:
      - ref: db.client.connections.state
        requirement_level: required
      - ref: db.client.connections.pool.name
        requirement_level: required

  - id: metric.db.client.connections.idle.max
    type: metric
    metric_name: db.client.connections.idle.max
    stability: experimental
    brief: "The maximum number of idle open connections allowed"
    instrument: updowncounter
    unit: "{connection}"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required

  - id: metric.db.client.connections.idle.min
    type: metric
    metric_name: db.client.connections.idle.min
    stability: experimental
    brief: "The minimum number of idle open connections allowed"
    instrument: updowncounter
    unit: "{connection}"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required

  - id: metric.db.client.connections.max
    type: metric
    metric_name: db.client.connections.max
    stability: experimental
    brief: "The maximum number of open connections allowed"
    instrument: updowncounter
    unit: "{connection}"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required

  - id: metric.db.client.connections.pending_requests
    type: metric
    metric_name: db.client.connections.pending_requests
    stability: experimental
    brief: "The number of pending requests for an open connection, cumulative for the entire pool"
    instrument: updowncounter
    unit: "{request}"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required

  - id: metric.db.client.connections.timeouts
    type: metric
    metric_name: db.client.connections.timeouts
    stability: experimental
    brief: "The number of connection timeouts that have occurred trying to obtain a connection from the pool"
    instrument: counter
    unit: "{timeout}"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required

  - id: metric.db.client.connections.create_time
    type: metric
    metric_name: db.client.connections.create_time
    stability: experimental
    brief: "The time it took to create a new connection"
    instrument: histogram
    unit: "ms"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required

  - id: metric.db.client.connections.wait_time
    type: metric
    metric_name: db.client.connections.wait_time
    stability: experimental
    brief: "The time it took to obtain an open connection from the pool"
    instrument: histogram
    unit: "ms"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required

  - id: metric.db.client.connections.use_time
    type: metric
    metric_name: db.client.connections.use_time
    stability: experimental
    brief: "The time between borrowing a connection and returning it to the pool"
    instrument: histogram
    unit: "ms"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required