groups:
  - id: metric.db.client.operation.duration
    type: metric
    metric_name: db.client.operation.duration
    brief: "Duration of database client operations."
    note: >
      Batch operations SHOULD be recorded as a single operation.
    instrument: histogram
    unit: "s"
    stability: experimental
    extends: attributes.db.client.minimal
    attributes:
      - ref: db.collection.name
        requirement_level:
          conditionally_required: >
            If readily available. The collection name MAY be parsed from the query text,
            in which case it SHOULD be the first collection name in the query.
      - ref: db.system
        # TODO: Not adding to the minimal because of https://github.com/open-telemetry/build-tools/issues/192
        requirement_level: required
      - ref: network.peer.address
        brief: Peer address of the database node where the operation was performed.
        requirement_level:
          recommended: If applicable for this database system.
        note: >
          Semantic conventions for individual database systems SHOULD document whether `network.peer.*` attributes are applicable.
          Network peer address and port are useful when the application interacts with individual database nodes directly.

          If a database operation involved multiple network calls (for example retries), the address of the last contacted node SHOULD be used.
      - ref: network.peer.port
        requirement_level:
          recommended: If and only if `network.peer.address` is set.
      - ref: db.namespace
        requirement_level:
          conditionally_required: If available.
  - id: metric.db.client.connection.count
    type: metric
    metric_name: db.client.connection.count
    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.connection.idle.max
    type: metric
    metric_name: db.client.connection.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.connection.idle.min
    type: metric
    metric_name: db.client.connection.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.connection.max
    type: metric
    metric_name: db.client.connection.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.connection.pending_requests
    type: metric
    metric_name: db.client.connection.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.connection.timeouts
    type: metric
    metric_name: db.client.connection.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.connection.create_time
    type: metric
    metric_name: db.client.connection.create_time
    stability: experimental
    brief: "The time it took to create a new connection"
    instrument: histogram
    unit: "s"
    attributes:
      - ref: db.client.connections.pool.name
        requirement_level: required

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

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