couchbase 3.7.0 → 3.8.0

data/lib/couchbase/utils/observability_constants.rb

@@ -0,0 +1,200 @@
+# frozen_string_literal: true
+
+#  Copyright 2025-Present Couchbase, Inc.
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+module Couchbase
+  module Observability # rubocop:disable Metrics/ModuleLength
+    OP_GET = "get"
+    OP_GET_MULTI = "get_multi"
+    OP_GET_AND_LOCK = "get_and_lock"
+    OP_GET_AND_TOUCH = "get_and_touch"
+    OP_GET_ALL_REPLICAS = "get_all_replicas"
+    OP_GET_ANY_REPLICA = "get_any_replica"
+    OP_GET_REPLICA = "get_replica"
+    OP_EXISTS = "exists"
+    OP_REPLACE = "replace"
+    OP_UPSERT = "upsert"
+    OP_UPSERT_MULTI = "upsert_multi"
+    OP_REMOVE = "remove"
+    OP_REMOVE_MULTI = "remove_multi"
+    OP_INSERT = "insert"
+    OP_TOUCH = "touch"
+    OP_UNLOCK = "unlock"
+    OP_LOOKUP_IN = "lookup_in"
+    OP_LOOKUP_IN_ALL_REPLICAS = "lookup_in_all_replicas"
+    OP_LOOKUP_IN_ANY_REPLICA = "lookup_in_any_replica"
+    OP_LOOKUP_IN_REPLICA = "lookup_in_replica"
+    OP_MUTATE_IN = "mutate_in"
+    OP_SCAN = "scan"
+    OP_INCREMENT = "increment"
+    OP_DECREMENT = "decrement"
+    OP_APPEND = "append"
+    OP_PREPEND = "prepend"
+
+    OP_QUERY = "query"
+    OP_SEARCH_QUERY = "search"
+    OP_ANALYTICS_QUERY = "analytics"
+    OP_VIEW_QUERY = "views"
+
+    OP_PING = "ping"
+    OP_DIAGNOSTICS = "diagnostics"
+
+    OP_BM_CREATE_BUCKET = "manager_buckets_create_bucket"
+    OP_BM_DROP_BUCKET = "manager_buckets_drop_bucket"
+    OP_BM_FLUSH_BUCKET = "manager_buckets_flush_bucket"
+    OP_BM_GET_ALL_BUCKETS = "manager_buckets_get_all_buckets"
+    OP_BM_GET_BUCKET = "manager_buckets_get_bucket"
+    OP_BM_UPDATE_BUCKET = "manager_buckets_update_bucket"
+
+    OP_CM_CREATE_COLLECTION = "manager_collections_create_collection"
+    OP_CM_UPDATE_COLLECTION = "manager_collections_update_collection"
+    OP_CM_DROP_COLLECTION = "manager_collections_drop_collection"
+    OP_CM_CREATE_SCOPE = "manager_collections_create_scope"
+    OP_CM_DROP_SCOPE = "manager_collections_drop_scope"
+    OP_CM_GET_ALL_SCOPES = "manager_collections_get_all_scopes"
+    OP_CM_GET_SCOPE = "manager_collections_get_scope"
+
+    OP_QM_BUILD_DEFERRED_INDEXES = "manager_query_build_deferred_indexes"
+    OP_QM_CREATE_INDEX = "manager_query_create_index"
+    OP_QM_CREATE_PRIMARY_INDEX = "manager_query_create_primary_index"
+    OP_QM_DROP_INDEX = "manager_query_drop_index"
+    OP_QM_DROP_PRIMARY_INDEX = "manager_query_drop_primary_index"
+    OP_QM_GET_ALL_INDEXES = "manager_query_get_all_indexes"
+    OP_QM_WATCH_INDEXES = "manager_query_watch_indexes"
+
+    OP_AM_CREATE_DATAVERSE = "manager_analytics_create_dataverse"
+    OP_AM_DROP_DATAVERSE = "manager_analytics_drop_dataverse"
+    OP_AM_CREATE_DATASET = "manager_analytics_create_dataset"
+    OP_AM_DROP_DATASET = "manager_analytics_drop_dataset"
+    OP_AM_GET_ALL_DATASETS = "manager_analytics_get_all_datasets"
+    OP_AM_CREATE_INDEX = "manager_analytics_create_index"
+    OP_AM_DROP_INDEX = "manager_analytics_drop_index"
+    OP_AM_GET_ALL_INDEXES = "manager_analytics_get_all_indexes"
+    OP_AM_CONNECT_LINK = "manager_analytics_connect_link"
+    OP_AM_DISCONNECT_LINK = "manager_analytics_disconnect_link"
+    OP_AM_GET_PENDING_MUTATIONS = "manager_analytics_get_pending_mutations"
+    OP_AM_CREATE_LINK = "manager_analytics_create_link"
+    OP_AM_REPLACE_LINK = "manager_analytics_replace_link"
+    OP_AM_DROP_LINK = "manager_analytics_drop_link"
+    OP_AM_GET_LINKS = "manager_analytics_get_links"
+
+    OP_SM_GET_INDEX = "manager_search_get_index"
+    OP_SM_GET_ALL_INDEXES = "manager_search_get_all_indexes"
+    OP_SM_UPSERT_INDEX = "manager_search_upsert_index"
+    OP_SM_DROP_INDEX = "manager_search_drop_index"
+    OP_SM_GET_INDEXED_DOCUMENTS_COUNT = "manager_search_get_indexed_documents_count"
+    OP_SM_GET_INDEX_STATS = "manager_search_get_index_stats"
+    OP_SM_GET_STATS = "manager_search_get_stats"
+    OP_SM_PAUSE_INGEST = "manager_search_pause_index"
+    OP_SM_RESUME_INGEST = "manager_search_resume_index"
+    OP_SM_ALLOW_QUERYING = "manager_search_allow_querying"
+    OP_SM_DISALLOW_QUERYING = "manager_search_disallow_querying"
+    OP_SM_FREEZE_PLAN = "manager_search_freeze_plan"
+    OP_SM_UNFREEZE_PLAN = "manager_search_unfreeze_plan"
+    OP_SM_ANALYZE_DOCUMENT = "manager_search_analyze_document"
+
+    OP_UM_DROP_GROUP = "manager_users_drop_group"
+    OP_UM_DROP_USER = "manager_users_drop_user"
+    OP_UM_GET_ALL_GROUPS = "manager_users_get_all_groups"
+    OP_UM_GET_ALL_USERS = "manager_users_get_all_users"
+    OP_UM_GET_GROUP = "manager_users_get_group"
+    OP_UM_GET_ROLES = "manager_users_get_roles"
+    OP_UM_GET_USER = "manager_users_get_user"
+    OP_UM_UPSERT_GROUP = "manager_users_upsert_group"
+    OP_UM_UPSERT_USER = "manager_users_upsert_user"
+    OP_UM_CHANGE_PASSWORD = "manager_users_change_password"
+
+    OP_VM_GET_DESIGN_DOCUMENT = "manager_views_get_design_document"
+    OP_VM_GET_ALL_DESIGN_DOCUMENTS = "manager_views_get_all_design_documents"
+    OP_VM_UPSERT_DESIGN_DOCUMENT = "manager_views_upsert_design_document"
+    OP_VM_DROP_DESIGN_DOCUMENT = "manager_views_drop_design_document"
+    OP_VM_PUBLISH_DESIGN_DOCUMENT = "manager_views_publish_design_document"
+
+    OP_LIST_EACH = "list_each"
+    OP_LIST_LENGTH = "list_length"
+    OP_LIST_PUSH = "list_push"
+    OP_LIST_UNSHIFT = "list_unshift"
+    OP_LIST_INSERT = "list_insert"
+    OP_LIST_AT = "list_at"
+    OP_LIST_DELETE_AT = "list_delete_at"
+    OP_LIST_CLEAR = "list_clear"
+
+    OP_MAP_EACH = "map_each"
+    OP_MAP_LENGTH = "map_length"
+    OP_MAP_CLEAR = "map_clear"
+    OP_MAP_FETCH = "map_fetch"
+    OP_MAP_DELETE = "map_delete"
+    OP_MAP_KEY_EXISTS = "map_key"
+    OP_MAP_STORE = "map_store"
+
+    OP_QUEUE_EACH = "queue_each"
+    OP_QUEUE_LENGTH = "queue_length"
+    OP_QUEUE_CLEAR = "queue_clear"
+    OP_QUEUE_PUSH = "queue_push"
+    OP_QUEUE_POP = "queue_pop"
+
+    OP_SET_EACH = "set_each"
+    OP_SET_LENGTH = "set_length"
+    OP_SET_ADD = "set_add"
+    OP_SET_CLEAR = "set_clear"
+    OP_SET_DELETE = "set_delete"
+
+    STEP_REQUEST_ENCODING = "request_encoding"
+    STEP_DISPATCH_TO_SERVER = "dispatch_to_server"
+
+    # Common attributes
+    ATTR_SYSTEM_NAME = "db.system.name"
+    ATTR_CLUSTER_NAME = "couchbase.cluster.name"
+    ATTR_CLUSTER_UUID = "couchbase.cluster.uuid"
+
+    # Operation-level attributes
+    ATTR_OPERATION_NAME = "db.operation.name"
+    ATTR_SERVICE = "couchbase.service"
+    ATTR_BUCKET_NAME = "db.namespace"
+    ATTR_SCOPE_NAME = "couchbase.scope.name"
+    ATTR_COLLECTION_NAME = "couchbase.collection.name"
+    ATTR_RETRIES = "couchbase.retries"
+    ATTR_DURABILITY = "couchbase.durability"
+    ATTR_QUERY_STATEMENT = "db.query.text"
+    ATTR_ERROR_TYPE = "error.type"
+
+    # Dispatch-level attributes
+    ATTR_LOCAL_ID = "couchbase.local_id"
+    ATTR_OPERATION_ID = "couchbase.operation_id"
+    ATTR_PEER_ADDRESS = "network.peer.address"
+    ATTR_PEER_PORT = "network.peer.port"
+    ATTR_SERVER_DURATION = "couchbase.server_duration"
+
+    # Reserved attributes
+    ATTR_RESERVED_UNIT = "__unit"
+
+    ATTR_VALUE_SYSTEM_NAME = "couchbase"
+
+    ATTR_VALUE_DURABILITY_MAJORITY = "majority"
+    ATTR_VALUE_DURABILITY_MAJORITY_AND_PERSIST_TO_ACTIVE = "majority_and_persist_active"
+    ATTR_VALUE_DURABILITY_PERSIST_TO_MAJORITY = "persist_majority"
+
+    ATTR_VALUE_SERVICE_KV = "kv"
+    ATTR_VALUE_SERVICE_QUERY = "query"
+    ATTR_VALUE_SERVICE_SEARCH = "search"
+    ATTR_VALUE_SERVICE_VIEWS = "views"
+    ATTR_VALUE_SERVICE_ANALYTICS = "analytics"
+    ATTR_VALUE_SERVICE_MANAGEMENT = "management"
+
+    ATTR_VALUE_RESERVED_UNIT_SECONDS = "s"
+
+    METER_NAME_OPERATION_DURATION = "db.client.operation.duration"
+  end
+end

data/lib/couchbase/utils/stdlib_logger_adapter.rb

@@ -43,9 +43,7 @@ module Couchbase
         )
       end
 
-      private
-
-      def map_spdlog_level(level)
+      def self.map_spdlog_level(level)
         case level
         when :trace, :debug
           ::Logger::Severity::DEBUG

data/lib/couchbase/version.rb

@@ -21,5 +21,5 @@ module Couchbase
   #   $ ruby -rcouchbase -e 'pp Couchbase::VERSION'
   #   {:sdk=>"3.4.0", :ruby_abi=>"3.1.0", :revision=>"416fe68e6029ec8a4c40611cf6e6b30d3b90d20f"}
   VERSION = {} unless defined?(VERSION) # rubocop:disable Style/MutableConstant
-  VERSION.update(:sdk => "3.7.0")
+  VERSION.update(:sdk => "3.8.0")
 end

data/lib/couchbase.rb

@@ -25,8 +25,8 @@ require "couchbase/railtie" if defined?(Rails)
 
 # @!macro uncommitted
 #   @couchbase.stability
-#     Uncommitted: This API may change in the future.
+#     **Uncommitted:** This API may change in the future.
 #
 # @!macro volatile
 #   @couchbase.stability
-#     Volatile: This API is subject to change at any time.
+#     **Volatile:** This API is subject to change at any time.

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: couchbase
 version: !ruby/object:Gem::Version
-  version: 3.7.0
+  version: 3.8.0
 platform: ruby
 authors:
 - Sergey Avseyev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-09-29 00:00:00.000000000 Z
+date: 2026-03-31 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: grpc
   requirement: !ruby/object:Gem::Requirement
@@ -2318,6 +2332,8 @@ files:
 - ext/couchbase/core/cluster_agent_config.hxx
 - ext/couchbase/core/cluster_credentials.cxx
 - ext/couchbase/core/cluster_credentials.hxx
+- ext/couchbase/core/cluster_label_listener.cxx
+- ext/couchbase/core/cluster_label_listener.hxx
 - ext/couchbase/core/cluster_options.cxx
 - ext/couchbase/core/cluster_options.hxx
 - ext/couchbase/core/cluster_options_fwd.hxx
@@ -2361,6 +2377,7 @@ files:
 - ext/couchbase/core/crypto/CMakeLists.txt
 - ext/couchbase/core/crypto/cbcrypto.cc
 - ext/couchbase/core/crypto/cbcrypto.h
+- ext/couchbase/core/deprecation_utils.hxx
 - ext/couchbase/core/design_document_namespace.hxx
 - ext/couchbase/core/design_document_namespace_fmt.hxx
 - ext/couchbase/core/diagnostics.hxx
@@ -2373,6 +2390,7 @@ files:
 - ext/couchbase/core/document_id.hxx
 - ext/couchbase/core/document_id_fmt.hxx
 - ext/couchbase/core/durability_options.hxx
+- ext/couchbase/core/error.hxx
 - ext/couchbase/core/error_context/analytics.hxx
 - ext/couchbase/core/error_context/analytics_json.hxx
 - ext/couchbase/core/error_context/base_error_context.hxx
@@ -2484,6 +2502,8 @@ files:
 - ext/couchbase/core/impl/numeric_range_facet.cxx
 - ext/couchbase/core/impl/numeric_range_facet_result.cxx
 - ext/couchbase/core/impl/numeric_range_query.cxx
+- ext/couchbase/core/impl/observability_recorder.cxx
+- ext/couchbase/core/impl/observability_recorder.hxx
 - ext/couchbase/core/impl/observe_poll.cxx
 - ext/couchbase/core/impl/observe_poll.hxx
 - ext/couchbase/core/impl/observe_seqno.cxx
@@ -2557,6 +2577,7 @@ files:
 - ext/couchbase/core/impl/vector_search.cxx
 - ext/couchbase/core/impl/view_error_category.cxx
 - ext/couchbase/core/impl/wildcard_query.cxx
+- ext/couchbase/core/impl/with_cancellation.hxx
 - ext/couchbase/core/impl/with_legacy_durability.hxx
 - ext/couchbase/core/io/config_tracker.cxx
 - ext/couchbase/core/io/config_tracker.hxx
@@ -2667,6 +2688,7 @@ files:
 - ext/couchbase/core/meta/features.hxx
 - ext/couchbase/core/meta/version.cxx
 - ext/couchbase/core/meta/version.hxx
+- ext/couchbase/core/metrics/constants.hxx
 - ext/couchbase/core/metrics/logging_meter.cxx
 - ext/couchbase/core/metrics/logging_meter.hxx
 - ext/couchbase/core/metrics/logging_meter_options.hxx
@@ -2886,6 +2908,8 @@ files:
 - ext/couchbase/core/operations_fwd.hxx
 - ext/couchbase/core/origin.cxx
 - ext/couchbase/core/origin.hxx
+- ext/couchbase/core/orphan_reporter.cxx
+- ext/couchbase/core/orphan_reporter.hxx
 - ext/couchbase/core/pending_operation.hxx
 - ext/couchbase/core/pending_operation_connection_info.hxx
 - ext/couchbase/core/ping_collector.hxx
@@ -3012,6 +3036,8 @@ files:
 - ext/couchbase/core/sasl/error_fmt.h
 - ext/couchbase/core/sasl/mechanism.cc
 - ext/couchbase/core/sasl/mechanism.h
+- ext/couchbase/core/sasl/oauthbearer/oauthbearer.cc
+- ext/couchbase/core/sasl/oauthbearer/oauthbearer.h
 - ext/couchbase/core/sasl/plain/plain.cc
 - ext/couchbase/core/sasl/plain/plain.h
 - ext/couchbase/core/sasl/scram-sha/scram-sha.cc
@@ -3031,6 +3057,8 @@ files:
 - ext/couchbase/core/stats_options.hxx
 - ext/couchbase/core/subdoc_options.hxx
 - ext/couchbase/core/timeout_defaults.hxx
+- ext/couchbase/core/tls_context_provider.cxx
+- ext/couchbase/core/tls_context_provider.hxx
 - ext/couchbase/core/tls_verify_mode.hxx
 - ext/couchbase/core/topology/capabilities.cxx
 - ext/couchbase/core/topology/capabilities.hxx
@@ -3044,6 +3072,7 @@ files:
 - ext/couchbase/core/topology/configuration_json.hxx
 - ext/couchbase/core/topology/error_map.hxx
 - ext/couchbase/core/topology/error_map_json.hxx
+- ext/couchbase/core/tracing/attribute_helpers.hxx
 - ext/couchbase/core/tracing/constants.hxx
 - ext/couchbase/core/tracing/noop_tracer.hxx
 - ext/couchbase/core/tracing/threshold_logging_options.hxx
@@ -3051,6 +3080,8 @@ files:
 - ext/couchbase/core/tracing/threshold_logging_tracer.hxx
 - ext/couchbase/core/tracing/tracer_wrapper.cxx
 - ext/couchbase/core/tracing/tracer_wrapper.hxx
+- ext/couchbase/core/tracing/wrapper_sdk_tracer.cxx
+- ext/couchbase/core/tracing/wrapper_sdk_tracer.hxx
 - ext/couchbase/core/transactions.hxx
 - ext/couchbase/core/transactions/active_transaction_record.cxx
 - ext/couchbase/core/transactions/active_transaction_record.hxx
@@ -3120,6 +3151,7 @@ files:
 - ext/couchbase/core/utils/binary.cxx
 - ext/couchbase/core/utils/binary.hxx
 - ext/couchbase/core/utils/byteswap.hxx
+- ext/couchbase/core/utils/concurrent_fixed_priority_queue.hxx
 - ext/couchbase/core/utils/connection_string.cxx
 - ext/couchbase/core/utils/connection_string.hxx
 - ext/couchbase/core/utils/crc32.hxx
@@ -3283,6 +3315,7 @@ files:
 - ext/couchbase/couchbase/increment_options.hxx
 - ext/couchbase/couchbase/insert_options.hxx
 - ext/couchbase/couchbase/ip_protocol.hxx
+- ext/couchbase/couchbase/jwt_authenticator.hxx
 - ext/couchbase/couchbase/logger.hxx
 - ext/couchbase/couchbase/lookup_in_all_replicas_options.hxx
 - ext/couchbase/couchbase/lookup_in_any_replica_options.hxx
@@ -3463,10 +3496,14 @@ files:
 - ext/rcb_exceptions.hxx
 - ext/rcb_extras.cxx
 - ext/rcb_extras.hxx
+- ext/rcb_hdr_histogram.cxx
+- ext/rcb_hdr_histogram.hxx
 - ext/rcb_logger.cxx
 - ext/rcb_logger.hxx
 - ext/rcb_multi.cxx
 - ext/rcb_multi.hxx
+- ext/rcb_observability.cxx
+- ext/rcb_observability.hxx
 - ext/rcb_query.cxx
 - ext/rcb_query.hxx
 - ext/rcb_range_scan.cxx
@@ -3516,6 +3553,12 @@ files:
 - lib/couchbase/management/search_index_manager.rb
 - lib/couchbase/management/user_manager.rb
 - lib/couchbase/management/view_index_manager.rb
+- lib/couchbase/metrics/logging_meter.rb
+- lib/couchbase/metrics/logging_value_recorder.rb
+- lib/couchbase/metrics/meter.rb
+- lib/couchbase/metrics/noop_meter.rb
+- lib/couchbase/metrics/noop_value_recorder.rb
+- lib/couchbase/metrics/value_recorder.rb
 - lib/couchbase/mutation_state.rb
 - lib/couchbase/options.rb
 - lib/couchbase/protostellar.rb
@@ -3591,9 +3634,18 @@ files:
 - lib/couchbase/scope.rb
 - lib/couchbase/search_options.rb
 - lib/couchbase/subdoc.rb
+- lib/couchbase/tracing/noop_span.rb
+- lib/couchbase/tracing/noop_tracer.rb
+- lib/couchbase/tracing/request_span.rb
+- lib/couchbase/tracing/request_tracer.rb
+- lib/couchbase/tracing/threshold_logging_span.rb
+- lib/couchbase/tracing/threshold_logging_tracer.rb
 - lib/couchbase/transcoder_flags.rb
 - lib/couchbase/utils.rb
 - lib/couchbase/utils/generic_logger_adapter.rb
+- lib/couchbase/utils/hdr_histogram.rb
+- lib/couchbase/utils/observability.rb
+- lib/couchbase/utils/observability_constants.rb
 - lib/couchbase/utils/stdlib_logger_adapter.rb
 - lib/couchbase/utils/time.rb
 - lib/couchbase/version.rb
@@ -3606,9 +3658,9 @@ metadata:
   homepage_uri: https://docs.couchbase.com/ruby-sdk/current/hello-world/start-using-sdk.html
   bug_tracker_uri: https://jira.issues.couchbase.com/browse/RCBC
   mailing_list_uri: https://www.couchbase.com/forums/c/ruby-sdk
-  source_code_uri: https://github.com/couchbase/couchbase-ruby-client/tree/3.7.0
-  changelog_uri: https://github.com/couchbase/couchbase-ruby-client/releases/tag/3.7.0
-  documentation_uri: https://docs.couchbase.com/sdk-api/couchbase-ruby-client-3.7.0/index.html
+  source_code_uri: https://github.com/couchbase/couchbase-ruby-client/tree/3.8.0
+  changelog_uri: https://github.com/couchbase/couchbase-ruby-client/releases/tag/3.8.0
+  documentation_uri: https://docs.couchbase.com/sdk-api/couchbase-ruby-client-3.8.0/index.html
   github_repo: https://github.com/couchbase/couchbase-ruby-client
   rubygems_mfa_required: 'true'
 post_install_message: 
@@ -3621,7 +3673,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="