openlit 1.34.23__py3-none-any.whl → 1.34.25__py3-none-any.whl

openlit/instrumentation/pinecone/__init__.py

@@ -1,66 +1,174 @@
-# pylint: disable=useless-return, bad-staticmethod-argument, disable=duplicate-code
 """Initializer of Auto Instrumentation of Pinecone Functions"""
+
 from typing import Collection
 import importlib.metadata
 from opentelemetry.instrumentation.instrumentor import BaseInstrumentor
 from wrapt import wrap_function_wrapper
 
 from openlit.instrumentation.pinecone.pinecone import general_wrap
+from openlit.instrumentation.pinecone.async_pinecone import async_general_wrap
 
-_instruments = ("pinecone-client >= 2.2.0",)
+_instruments = ("pinecone >= 7.3.0",)
 
 class PineconeInstrumentor(BaseInstrumentor):
-    """An instrumentor for Pinecone's client library."""
+    """
+    An instrumentor for Pinecone's client library.
+    """
 
     def instrumentation_dependencies(self) -> Collection[str]:
         return _instruments
 
     def _instrument(self, **kwargs):
-        application_name = kwargs.get("application_name")
-        environment = kwargs.get("environment")
+        version = importlib.metadata.version("pinecone")
+        environment = kwargs.get("environment", "default")
+        application_name = kwargs.get("application_name", "default")
         tracer = kwargs.get("tracer")
+        pricing_info = kwargs.get("pricing_info", {})
+        capture_message_content = kwargs.get("capture_message_content", False)
         metrics = kwargs.get("metrics_dict")
-        pricing_info = kwargs.get("pricing_info")
-        capture_message_content = kwargs.get("capture_message_content")
         disable_metrics = kwargs.get("disable_metrics")
-        version = importlib.metadata.version("pinecone-client")
 
+        # Sync operations
         wrap_function_wrapper(
-            "pinecone.control.pinecone",  
+            "pinecone.pinecone",
             "Pinecone.create_index",
-            general_wrap("pinecone.create_index", version, environment, application_name,
-                 tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+            general_wrap("pinecone.create_collection", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.pinecone",
+            "Pinecone.create_index_for_model",
+            general_wrap("pinecone.create_collection", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
         )
 
         wrap_function_wrapper(
-            "pinecone.data.index",  
+            "pinecone.db_data.index",
             "Index.upsert",
             general_wrap("pinecone.upsert", version, environment, application_name,
-                 tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index",
+            "Index.upsert_records",
+            general_wrap("pinecone.upsert_records", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
         )
 
         wrap_function_wrapper(
-            "pinecone.data.index",  
+            "pinecone.db_data.index",
             "Index.query",
             general_wrap("pinecone.query", version, environment, application_name,
-                 tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index",
+            "Index.search",
+            general_wrap("pinecone.search", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
         )
 
         wrap_function_wrapper(
-            "pinecone.data.index",  
+            "pinecone.db_data.index",
+            "Index.fetch",
+            general_wrap("pinecone.fetch", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index",
+            "Index.search_records",
+            general_wrap("pinecone.search_records", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index",
             "Index.update",
             general_wrap("pinecone.update", version, environment, application_name,
-                 tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
         )
 
         wrap_function_wrapper(
-            "pinecone.data.index",  
+            "pinecone.db_data.index",
             "Index.delete",
             general_wrap("pinecone.delete", version, environment, application_name,
-                 tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
         )
 
+        # Async operations
+        wrap_function_wrapper(
+            "pinecone.pinecone_asyncio",
+            "PineconeAsyncio.create_index",
+            async_general_wrap("pinecone.create_index", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.pinecone_asyncio",
+            "PineconeAsyncio.create_index_for_model",
+            async_general_wrap("pinecone.create_index", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index_asyncio",
+            "_IndexAsyncio.upsert",
+            async_general_wrap("pinecone.upsert", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index_asyncio",
+            "_IndexAsyncio.upsert_records",
+            async_general_wrap("pinecone.upsert_records", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index_asyncio",
+            "_IndexAsyncio.query",
+            async_general_wrap("pinecone.query", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index_asyncio",
+            "_IndexAsyncio.search",
+            async_general_wrap("pinecone.search", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index_asyncio",
+            "_IndexAsyncio.fetch",
+            async_general_wrap("pinecone.fetch", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index_asyncio",
+            "_IndexAsyncio.search_records",
+            async_general_wrap("pinecone.search_records", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index_asyncio",
+            "_IndexAsyncio.update",
+            async_general_wrap("pinecone.update", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
+
+        wrap_function_wrapper(
+            "pinecone.db_data.index_asyncio",
+            "_IndexAsyncio.delete",
+            async_general_wrap("pinecone.delete", version, environment, application_name,
+                tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+        )
 
-    @staticmethod
     def _uninstrument(self, **kwargs):
         pass

openlit/instrumentation/pinecone/async_pinecone.py

@@ -0,0 +1,58 @@
+"""
+Module for monitoring Pinecone async API calls.
+"""
+
+import time
+from opentelemetry.trace import SpanKind
+from opentelemetry import context as context_api
+from openlit.__helpers import (
+    handle_exception,
+    set_server_address_and_port,
+)
+from openlit.instrumentation.pinecone.utils import (
+    process_vectordb_response,
+    DB_OPERATION_MAP,
+)
+
+def async_general_wrap(gen_ai_endpoint, version, environment, application_name,
+    tracer, pricing_info, capture_message_content, metrics, disable_metrics):
+    """
+    Generates a telemetry wrapper for Pinecone async function calls.
+    """
+
+    async def wrapper(wrapped, instance, args, kwargs):
+        """
+        Wraps the Pinecone async function call.
+        """
+
+        if context_api.get_value(context_api._SUPPRESS_INSTRUMENTATION_KEY):
+            return await wrapped(*args, **kwargs)
+
+        # Get server address and port using the standard helper
+        server_address, server_port = set_server_address_and_port(instance, "pinecone.io", 443)
+
+        db_operation = DB_OPERATION_MAP.get(gen_ai_endpoint, "unknown")
+        if db_operation == "create_collection":
+            namespace = kwargs.get("name") or (args[0] if args else "unknown")
+        else:
+            namespace = kwargs.get("namespace") or (args[0] if args else "unknown")
+        span_name = f"{db_operation} {namespace}"
+
+        with tracer.start_as_current_span(span_name, kind=SpanKind.CLIENT) as span:
+            try:
+                start_time = time.time()
+                response = await wrapped(*args, **kwargs)
+
+                # Process response and generate telemetry
+                response = process_vectordb_response(
+                    response, db_operation, server_address, server_port,
+                    environment, application_name, metrics, start_time, span,
+                    capture_message_content, disable_metrics, version, instance, args, **kwargs
+                )
+
+            except Exception as e:
+                handle_exception(span, e)
+
+            return response
+
+    return wrapper

openlit/instrumentation/pinecone/pinecone.py

@@ -1,173 +1,58 @@
-# pylint: disable=duplicate-code, broad-exception-caught, too-many-statements, unused-argument, possibly-used-before-assignment
 """
-Module for monitoring Pinecone.
+Module for monitoring Pinecone API calls.
 """
 
-import logging
-from opentelemetry.trace import SpanKind, Status, StatusCode
-from opentelemetry.sdk.resources import SERVICE_NAME, TELEMETRY_SDK_NAME, DEPLOYMENT_ENVIRONMENT
-from openlit.__helpers import handle_exception
-from openlit.semcov import SemanticConvention
-
-# Initialize logger for logging potential issues and operations
-logger = logging.getLogger(__name__)
-
-def object_count(obj):
-    """
-    Counts Length of object if it exists, Else returns None
-    """
-
-    if obj:
-        return len(obj)
-
-    return None
+import time
+from opentelemetry.trace import SpanKind
+from opentelemetry import context as context_api
+from openlit.__helpers import (
+    handle_exception,
+    set_server_address_and_port,
+)
+from openlit.instrumentation.pinecone.utils import (
+    process_vectordb_response,
+    DB_OPERATION_MAP,
+)
 
 def general_wrap(gen_ai_endpoint, version, environment, application_name,
-                 tracer, pricing_info, capture_message_content, metrics, disable_metrics):
+    tracer, pricing_info, capture_message_content, metrics, disable_metrics):
     """
-    Wraps a Pinecone operation to trace and log its execution metrics.
-
-    This function is intended to wrap around Pinecone operations in order to
-    measure their execution time, log relevant information, and trace the execution
-    using OpenTelemetry. This helps in monitoring and debugging operations within
-    the Pinecone space.
-
-    Parameters:
-    - pinecone_operation (str): The specific Pinecone operation being monitored.
-                                Examples include 'create_index', 'query', 'upsert', etc.
-    - version (str): The version of the application interfacing with Pinecone.
-    - environment (str): The deployment environment, such as 'production' or 'development'.
-    - application_name (str): The name of the application performing the Pinecone operation.
-    - tracer (opentelemetry.trace.Tracer): An object used for OpenTelemetry tracing.
-    - pricing_info (dict): Information about pricing, not used in current implementation.
-    - capture_message_content (bool): A flag indicating whether the content of responses should be traced.
-
-    Returns:
-    - function: A decorator function that, when applied, wraps the target function with
-                additional functionality for tracing and logging Pinecone operations.
+    Generates a telemetry wrapper for Pinecone function calls.
     """
 
     def wrapper(wrapped, instance, args, kwargs):
         """
-        Executes the wrapped Pinecone operation, adding tracing and logging.
-
-        This inner wrapper function captures the execution of Pinecone operations,
-        annotating the operation with relevant metrics and tracing information, and
-        ensuring any exceptions are caught and logged appropriately.
-
-        Parameters:
-        - wrapped (Callable): The Pinecone operation to be wrapped and executed.
-        - instance (object): The instance on which the operation is called (for class methods).
-        - args (tuple): Positional arguments for the Pinecone operation.
-        - kwargs (dict): Keyword arguments for the Pinecone operation.
-
-        Returns:
-        - Any: The result of executing the wrapped Pinecone operation.
+        Wraps the Pinecone function call.
         """
 
-        with tracer.start_as_current_span(gen_ai_endpoint, kind= SpanKind.CLIENT) as span:
-            response = wrapped(*args, **kwargs)
-
-            try:
-                span.set_attribute(TELEMETRY_SDK_NAME, "openlit")
-                span.set_attribute(SemanticConvention.GEN_AI_ENDPOINT,
-                                   gen_ai_endpoint)
-                span.set_attribute(DEPLOYMENT_ENVIRONMENT,
-                                   environment)
-                span.set_attribute(SERVICE_NAME,
-                                   application_name)
-                span.set_attribute(SemanticConvention.GEN_AI_OPERATION,
-                                   SemanticConvention.GEN_AI_OPERATION_TYPE_VECTORDB)
-                span.set_attribute(SemanticConvention.DB_SYSTEM_NAME,
-                                   SemanticConvention.DB_SYSTEM_PINECONE)
-
-                if gen_ai_endpoint == "pinecone.create_index":
-                    db_operation = SemanticConvention.DB_OPERATION_CREATE_INDEX
-                    span.set_attribute(SemanticConvention.DB_OPERATION_NAME,
-                                       SemanticConvention.DB_OPERATION_CREATE_INDEX)
-                    span.set_attribute(SemanticConvention.DB_INDEX_NAME,
-                                       kwargs.get("name", ""))
-                    span.set_attribute(SemanticConvention.DB_INDEX_DIMENSION,
-                                       kwargs.get("dimensions", ""))
-                    span.set_attribute(SemanticConvention.DB_INDEX_METRIC,
-                                       kwargs.get("metric", ""))
-                    span.set_attribute(SemanticConvention.DB_INDEX_SPEC,
-                                       str(kwargs.get("spec", "")))
+        if context_api.get_value(context_api._SUPPRESS_INSTRUMENTATION_KEY):
+            return wrapped(*args, **kwargs)
 
-                elif gen_ai_endpoint == "pinecone.query":
-                    db_operation = SemanticConvention.DB_OPERATION_QUERY
-                    span.set_attribute(SemanticConvention.DB_OPERATION_NAME,
-                                       SemanticConvention.DB_OPERATION_QUERY)
-                    span.set_attribute(SemanticConvention.DB_STATEMENT,
-                                       str(kwargs.get("vector")))
-                    span.set_attribute(SemanticConvention.DB_N_RESULTS,
-                                       kwargs.get("top_k", ""))
-                    span.set_attribute(SemanticConvention.DB_FILTER,
-                                       str(kwargs.get("filter", "")))
-                    span.set_attribute(SemanticConvention.DB_NAMESPACE,
-                                       str(kwargs.get("namespace", "")))
+        # Get server address and port using the standard helper
+        server_address, server_port = set_server_address_and_port(instance, "pinecone.io", 443)
 
-                elif gen_ai_endpoint == "pinecone.update":
-                    db_operation = SemanticConvention.DB_OPERATION_UPDATE
-                    span.set_attribute(SemanticConvention.DB_OPERATION_NAME,
-                                       SemanticConvention.DB_OPERATION_UPDATE)
-                    span.set_attribute(SemanticConvention.DB_UPDATE_ID,
-                                       kwargs.get("id",""))
-                    span.set_attribute(SemanticConvention.DB_UPDATE_VALUES,
-                                       str(kwargs.get("values",[])))
-                    span.set_attribute(SemanticConvention.DB_NAMESPACE,
-                                       str(kwargs.get("namespace", "")))
-                    span.set_attribute(SemanticConvention.DB_UPDATE_METADATA,
-                                       str(kwargs.get("set_metadata", "")))
+        db_operation = DB_OPERATION_MAP.get(gen_ai_endpoint, "unknown")
+        if db_operation == "create_collection":
+            namespace = kwargs.get("name") or (args[0] if args else "unknown")
+        else:
+            namespace = kwargs.get("namespace") or (args[0] if args else "unknown")
+        span_name = f"{db_operation} {namespace}"
 
-                elif gen_ai_endpoint == "pinecone.upsert":
-                    db_operation = SemanticConvention.DB_OPERATION_UPSERT
-                    span.set_attribute(SemanticConvention.DB_OPERATION_NAME,
-                                       SemanticConvention.DB_OPERATION_UPSERT)
-                    span.set_attribute(SemanticConvention.DB_VECTOR_COUNT,
-                                       object_count(kwargs.get("vectors")))
-
-                elif gen_ai_endpoint == "pinecone.delete":
-                    db_operation = SemanticConvention.DB_OPERATION_DELETE
-                    span.set_attribute(SemanticConvention.DB_OPERATION_NAME,
-                                       SemanticConvention.DB_OPERATION_DELETE)
-                    span.set_attribute(SemanticConvention.DB_ID_COUNT,
-                                       object_count(kwargs.get("ids")))
-                    span.set_attribute(SemanticConvention.DB_FILTER,
-                                       str(kwargs.get("filter", "")))
-                    span.set_attribute(SemanticConvention.DB_DELETE_ALL,
-                                       kwargs.get("delete_all", False))
-                    span.set_attribute(SemanticConvention.DB_NAMESPACE,
-                                       kwargs.get("namespace", ""))
-
-                span.set_status(Status(StatusCode.OK))
-
-                if disable_metrics is False:
-                    attributes = {
-                        TELEMETRY_SDK_NAME:
-                            "openlit",
-                        SERVICE_NAME:
-                            application_name,
-                        SemanticConvention.DB_SYSTEM_NAME:
-                            SemanticConvention.DB_SYSTEM_PINECONE,
-                        DEPLOYMENT_ENVIRONMENT:
-                            environment,
-                        SemanticConvention.GEN_AI_OPERATION:
-                            SemanticConvention.GEN_AI_OPERATION_TYPE_VECTORDB,
-                        SemanticConvention.DB_OPERATION_NAME:
-                            db_operation
-                    }
-
-                    metrics["db_requests"].add(1, attributes)
+        with tracer.start_as_current_span(span_name, kind=SpanKind.CLIENT) as span:
+            try:
+                start_time = time.time()
+                response = wrapped(*args, **kwargs)
 
-                # Return original response
-                return response
+                # Process response and generate telemetry
+                response = process_vectordb_response(
+                    response, db_operation, server_address, server_port,
+                    environment, application_name, metrics, start_time, span,
+                    capture_message_content, disable_metrics, version, instance, args, **kwargs
+                )
 
             except Exception as e:
                 handle_exception(span, e)
-                logger.error("Error in trace creation: %s", e)
 
-                # Return original response
-                return response
+            return response
 
     return wrapper

openlit/instrumentation/pinecone/utils.py

@@ -0,0 +1,186 @@
+"""
+Pinecone OpenTelemetry instrumentation utility functions
+"""
+import time
+
+from opentelemetry.trace import Status, StatusCode
+
+from openlit.__helpers import (
+    common_db_span_attributes,
+    record_db_metrics,
+)
+from openlit.semcov import SemanticConvention
+
+# Operation mapping for simple span naming
+DB_OPERATION_MAP = {
+    "pinecone.create_collection": SemanticConvention.DB_OPERATION_CREATE_COLLECTION,
+    "pinecone.upsert": SemanticConvention.DB_OPERATION_UPSERT,
+    "pinecone.query": SemanticConvention.DB_OPERATION_QUERY,
+    "pinecone.search": SemanticConvention.DB_OPERATION_SEARCH,
+    "pinecone.fetch": SemanticConvention.DB_OPERATION_FETCH,
+    "pinecone.update": SemanticConvention.DB_OPERATION_UPDATE,
+    "pinecone.delete": SemanticConvention.DB_OPERATION_DELETE,
+    "pinecone.upsert_records": SemanticConvention.DB_OPERATION_UPSERT,
+    "pinecone.search_records": SemanticConvention.DB_OPERATION_QUERY,
+}
+
+def object_count(obj):
+    """
+    Counts length of object if it exists, else returns 0.
+    """
+    return len(obj) if obj else 0
+
+def common_vectordb_logic(scope, environment, application_name,
+    metrics, capture_message_content, disable_metrics, version, instance=None):
+    """
+    Process vector database request and generate telemetry.
+    """
+
+    scope._end_time = time.time()
+
+    # Set common database span attributes using helper
+    common_db_span_attributes(scope, SemanticConvention.DB_SYSTEM_PINECONE, scope._server_address, scope._server_port,
+        environment, application_name, version)
+
+    # Set DB operation specific attributes
+    scope._span.set_attribute(SemanticConvention.DB_OPERATION_NAME, scope._db_operation)
+    scope._span.set_attribute(SemanticConvention.DB_CLIENT_OPERATION_DURATION, scope._end_time - scope._start_time)
+
+    # Set Create Index operation specific attributes
+    if scope._db_operation == SemanticConvention.DB_OPERATION_CREATE_COLLECTION:
+        # Standard database attributes
+        scope._span.set_attribute(SemanticConvention.DB_COLLECTION_NAME, scope._kwargs.get("name", ""))
+
+        # Vector database specific attributes (extensions)
+        scope._span.set_attribute(SemanticConvention.DB_COLLECTION_DIMENSION, scope._kwargs.get("dimension", -1))
+        scope._span.set_attribute(SemanticConvention.DB_SEARCH_SIMILARITY_METRIC, scope._kwargs.get("metric", "cosine"))
+        scope._span.set_attribute(SemanticConvention.DB_COLLECTION_SPEC, str(scope._kwargs.get("spec", "")))
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_SEARCH:
+        namespace = scope._kwargs.get("namespace", "default") or (scope._args[0] if scope._args else "unknown")
+        query = scope._kwargs.get("query", {})
+
+        # Extract query text or vector from different possible locations
+        query_text = query.get("inputs", {}).get("text", "")
+        query_vector = query.get("vector", {})
+        query_content = query_text or str(query_vector)
+
+        # Standard database attributes
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, query_content)
+        scope._span.set_attribute(SemanticConvention.DB_NAMESPACE, namespace)
+
+        # Vector database specific attributes (extensions)
+        scope._span.set_attribute(SemanticConvention.DB_VECTOR_QUERY_TOP_K, query.get("top_k", -1))
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {namespace} "
+            f"top_k={query.get('top_k', -1)} "
+            f"text={query_text} "
+            f"vector={query_vector}")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_QUERY:
+        namespace = scope._kwargs.get("namespace", "default") or (scope._args[0] if scope._args else "unknown")
+        query = scope._kwargs.get("vector", [])
+
+        # Standard database attributes
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(query))
+        scope._span.set_attribute(SemanticConvention.DB_NAMESPACE, namespace)
+
+        # Vector database specific attributes (extensions)
+        scope._span.set_attribute(SemanticConvention.DB_VECTOR_QUERY_TOP_K, scope._kwargs.get("top_k", ""))
+        scope._span.set_attribute(SemanticConvention.DB_FILTER, str(scope._kwargs.get("filter", "")))
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {namespace} "
+            f"top_k={scope._kwargs.get('top_k', -1)} "
+            f"filtered={scope._kwargs.get('filter', '')} "
+            f"vector={scope._kwargs.get('vector', '')}")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_FETCH:
+        namespace = scope._kwargs.get("namespace", "default") or (scope._args[0] if scope._args else "unknown")
+        query = scope._kwargs.get("ids", [])
+
+        # Standard database attributes
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(query))
+        scope._span.set_attribute(SemanticConvention.DB_NAMESPACE, namespace)
+
+        # Vector database specific attributes (extensions)
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {namespace} "
+            f"ids={query}")
+        scope._span.set_attribute(SemanticConvention.DB_RESPONSE_RETURNED_ROWS, object_count(scope._response.vectors))
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_UPDATE:
+        namespace = scope._kwargs.get("namespace") or (scope._args[0] if scope._args else "unknown")
+        query = scope._kwargs.get("id", "")
+
+        # Standard database attributes
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, query)
+        scope._span.set_attribute(SemanticConvention.DB_NAMESPACE, namespace)
+
+        # Vector database specific attributes (extensions)
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {namespace} "
+            f"id={query} "
+            f"values={scope._kwargs.get('values', [])} "
+            f"set_metadata={scope._kwargs.get('set_metadata', '')}")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_UPSERT:
+        namespace = scope._kwargs.get("namespace") or (scope._args[0] if scope._args else "unknown")
+        query = scope._kwargs.get("vectors") or (scope._args[1] if len(scope._args) > 1 else None)
+
+        # Standard database attributes
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(query))
+        scope._span.set_attribute(SemanticConvention.DB_NAMESPACE, namespace)
+
+        # Vector database specific attributes (extensions)
+        scope._span.set_attribute(SemanticConvention.DB_VECTOR_COUNT, object_count(query))
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {namespace} vectors_count={object_count(query)}")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_DELETE:
+        namespace = scope._kwargs.get("namespace") or (scope._args[0] if scope._args else "unknown")
+        query = scope._kwargs.get("ids") or (scope._args[1] if len(scope._args) > 1 else None)
+
+        # Standard database attributes
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(query))
+        scope._span.set_attribute(SemanticConvention.DB_NAMESPACE, namespace)
+
+        # Vector database specific attributes (extensions)
+        scope._span.set_attribute(SemanticConvention.DB_ID_COUNT, object_count(scope._kwargs.get("ids")))
+        scope._span.set_attribute(SemanticConvention.DB_FILTER, str(scope._kwargs.get("filter", "")))
+        scope._span.set_attribute(SemanticConvention.DB_DELETE_ALL, scope._kwargs.get("delete_all", False))
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {namespace} "
+            f"ids={query} "
+            f"filter={scope._kwargs.get('filter', '')} "
+            f"delete_all={scope._kwargs.get('delete_all', False)}")
+
+    scope._span.set_status(Status(StatusCode.OK))
+
+    # Record metrics using helper
+    if not disable_metrics:
+        record_db_metrics(metrics, SemanticConvention.DB_SYSTEM_PINECONE, scope._server_address, scope._server_port,
+            environment, application_name, scope._start_time, scope._end_time)
+
+def process_vectordb_response(response, db_operation, server_address, server_port,
+    environment, application_name, metrics, start_time, span,
+    capture_message_content=False, disable_metrics=False,
+    version="1.0.0", instance=None, args=None, **kwargs):
+    """
+    Process vector database response and generate telemetry following OpenTelemetry conventions.
+    """
+
+    scope = type("GenericScope", (), {})()
+
+    scope._start_time = start_time
+    scope._span = span
+    scope._kwargs = kwargs
+    scope._args = args or []
+    scope._db_operation = db_operation
+    scope._response = response
+    scope._server_address = server_address
+    scope._server_port = server_port
+
+    common_vectordb_logic(scope, environment, application_name,
+        metrics, capture_message_content, disable_metrics, version, instance)
+
+    return response