openlit 1.34.26__tar.gz → 1.34.27__tar.gz

{openlit-1.34.26 → openlit-1.34.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: openlit
-Version: 1.34.26
+Version: 1.34.27
 Summary: OpenTelemetry-native Auto instrumentation library for monitoring LLM Applications and GPUs, facilitating the integration of observability into your GenAI-driven projects
 License: Apache-2.0
 Keywords: OpenTelemetry,otel,otlp,llm,tracing,openai,anthropic,claude,cohere,llm monitoring,observability,monitoring,gpt,Generative AI,chatGPT,gpu

{openlit-1.34.26 → openlit-1.34.27}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "openlit"
-version = "1.34.26"
+version = "1.34.27"
 description = "OpenTelemetry-native Auto instrumentation library for monitoring LLM Applications and GPUs, facilitating the integration of observability into your GenAI-driven projects"
 authors = ["OpenLIT"]
 license = "Apache-2.0"

openlit-1.34.27/src/openlit/instrumentation/astra/__init__.py

@@ -0,0 +1,90 @@
+"""
+OpenLIT AstraDB Instrumentation
+"""
+
+from typing import Collection
+import importlib.metadata
+from opentelemetry.instrumentation.instrumentor import BaseInstrumentor
+from wrapt import wrap_function_wrapper
+
+from openlit.instrumentation.astra.astra import general_wrap
+from openlit.instrumentation.astra.async_astra import async_general_wrap
+
+_instruments = ("astrapy >= 1.5.2",)
+
+# AstraDB sync operations
+ASTRA_SYNC_OPERATIONS = [
+    # Database operations
+    ("astrapy.database", "Database.create_collection", "astra.create_collection"),
+    ("astrapy.database", "Database.drop_collection", "astra.drop_collection"),
+
+    # Collection operations
+    ("astrapy.collection", "Collection.insert_one", "astra.insert_one"),
+    ("astrapy.collection", "Collection.insert_many", "astra.insert_many"),
+    ("astrapy.collection", "Collection.update_one", "astra.update_one"),
+    ("astrapy.collection", "Collection.update_many", "astra.update_many"),
+    ("astrapy.collection", "Collection.find_one_and_update", "astra.find_one_and_update"),
+    ("astrapy.collection", "Collection.find", "astra.find"),
+    ("astrapy.collection", "Collection.replace_one", "astra.replace_one"),
+    ("astrapy.collection", "Collection.find_one_and_delete", "astra.find_one_and_delete"),
+    ("astrapy.collection", "Collection.delete_one", "astra.delete_one"),
+    ("astrapy.collection", "Collection.delete_many", "astra.delete_many"),
+]
+
+# AstraDB async operations
+ASTRA_ASYNC_OPERATIONS = [
+    # Async Database operations
+    ("astrapy.database", "AsyncDatabase.create_collection", "astra.create_collection"),
+    ("astrapy.database", "AsyncDatabase.drop_collection", "astra.drop_collection"),
+
+    # Async Collection operations
+    ("astrapy.collection", "AsyncCollection.insert_one", "astra.insert_one"),
+    ("astrapy.collection", "AsyncCollection.insert_many", "astra.insert_many"),
+    ("astrapy.collection", "AsyncCollection.update_one", "astra.update_one"),
+    ("astrapy.collection", "AsyncCollection.update_many", "astra.update_many"),
+    ("astrapy.collection", "AsyncCollection.find_one_and_update", "astra.find_one_and_update"),
+    ("astrapy.collection", "AsyncCollection.find", "astra.find"),
+    ("astrapy.collection", "AsyncCollection.replace_one", "astra.replace_one"),
+    ("astrapy.collection", "AsyncCollection.find_one_and_delete", "astra.find_one_and_delete"),
+    ("astrapy.collection", "AsyncCollection.delete_one", "astra.delete_one"),
+    ("astrapy.collection", "AsyncCollection.delete_many", "astra.delete_many"),
+]
+
+class AstraInstrumentor(BaseInstrumentor):
+    """
+    An instrumentor for AstraDB's client library.
+    """
+
+    def instrumentation_dependencies(self) -> Collection[str]:
+        return _instruments
+
+    def _instrument(self, **kwargs):
+        version = importlib.metadata.version("astrapy")
+        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")
+        disable_metrics = kwargs.get("disable_metrics")
+
+        # Wrap sync operations
+        for module, class_method, endpoint in ASTRA_SYNC_OPERATIONS:
+            wrap_function_wrapper(
+                module,
+                class_method,
+                general_wrap(endpoint, version, environment, application_name,
+                    tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+            )
+
+        # Wrap async operations
+        for module, class_method, endpoint in ASTRA_ASYNC_OPERATIONS:
+            wrap_function_wrapper(
+                module,
+                class_method,
+                async_general_wrap(endpoint, version, environment, application_name,
+                    tracer, pricing_info, capture_message_content, metrics, disable_metrics),
+            )
+
+    def _uninstrument(self, **kwargs):
+        pass

openlit-1.34.27/src/openlit/instrumentation/astra/astra.py

@@ -0,0 +1,55 @@
+"""
+Module for monitoring AstraDB API calls.
+"""
+
+import time
+from opentelemetry.trace import SpanKind
+from opentelemetry import context as context_api
+from openlit.__helpers import handle_exception
+from openlit.instrumentation.astra.utils import (
+    process_astra_response,
+    DB_OPERATION_MAP,
+    set_server_address_and_port,
+)
+
+def general_wrap(gen_ai_endpoint, version, environment, application_name,
+    tracer, pricing_info, capture_message_content, metrics, disable_metrics):
+    """
+    Generates a telemetry wrapper for AstraDB function calls.
+    """
+    def wrapper(wrapped, instance, args, kwargs):
+        # CRITICAL: Suppression check
+        if context_api.get_value(context_api._SUPPRESS_INSTRUMENTATION_KEY):
+            return wrapped(*args, **kwargs)
+
+        # Get server address and port using the standard helper
+        server_address, server_port = set_server_address_and_port(instance)
+
+        db_operation = DB_OPERATION_MAP.get(gen_ai_endpoint, "unknown")
+
+        # Handle upsert detection for replace operations
+        if db_operation == "DB_OPERATION_REPLACE" and kwargs.get("upsert"):
+            db_operation = "DB_OPERATION_UPSERT"
+
+        # Get collection name for span naming
+        collection_name = getattr(instance, "name", "unknown")
+        span_name = f"{db_operation} {collection_name}"
+
+        with tracer.start_as_current_span(span_name, kind=SpanKind.CLIENT) as span:
+            start_time = time.time()
+            response = wrapped(*args, **kwargs)
+
+            try:
+                # Process response and generate telemetry
+                response = process_astra_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-1.34.27/src/openlit/instrumentation/astra/async_astra.py

@@ -0,0 +1,55 @@
+"""
+Module for monitoring AstraDB async API calls.
+"""
+
+import time
+from opentelemetry.trace import SpanKind
+from opentelemetry import context as context_api
+from openlit.__helpers import handle_exception
+from openlit.instrumentation.astra.utils import (
+    process_astra_response,
+    DB_OPERATION_MAP,
+    set_server_address_and_port,
+)
+
+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 AstraDB async function calls.
+    """
+    async def wrapper(wrapped, instance, args, kwargs):
+        # CRITICAL: Suppression check
+        if context_api.get_value(context_api._SUPPRESS_INSTRUMENTATION_KEY):
+            return wrapped(*args, **kwargs)
+
+        # Get server address and port using the standard helper
+        server_address, server_port = set_server_address_and_port(instance)
+
+        db_operation = DB_OPERATION_MAP.get(gen_ai_endpoint, "unknown")
+
+        # Handle upsert detection for replace operations
+        if db_operation == "DB_OPERATION_REPLACE" and kwargs.get("upsert"):
+            db_operation = "DB_OPERATION_UPSERT"
+
+        # Get collection name for span naming
+        collection_name = getattr(instance, "name", "unknown")
+        span_name = f"{db_operation} {collection_name}"
+
+        with tracer.start_as_current_span(span_name, kind=SpanKind.CLIENT) as span:
+            start_time = time.time()
+            response = await wrapped(*args, **kwargs)
+
+            try:
+                # Process response and generate telemetry
+                response = process_astra_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-1.34.27/src/openlit/instrumentation/astra/utils.py

@@ -0,0 +1,277 @@
+"""
+Utility functions for AstraDB instrumentation.
+"""
+
+import time
+from urllib.parse import urlparse
+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 = {
+    "astra.create_collection": SemanticConvention.DB_OPERATION_CREATE_COLLECTION,
+    "astra.drop_collection": SemanticConvention.DB_OPERATION_DELETE_COLLECTION,
+    "astra.insert": SemanticConvention.DB_OPERATION_INSERT,
+    "astra.insert_one": SemanticConvention.DB_OPERATION_INSERT,
+    "astra.insert_many": SemanticConvention.DB_OPERATION_INSERT,
+    "astra.update": SemanticConvention.DB_OPERATION_UPDATE,
+    "astra.update_one": SemanticConvention.DB_OPERATION_UPDATE,
+    "astra.update_many": SemanticConvention.DB_OPERATION_UPDATE,
+    "astra.find": SemanticConvention.DB_OPERATION_SELECT,
+    "astra.find_one_and_update": SemanticConvention.DB_OPERATION_REPLACE,
+    "astra.replace_one": SemanticConvention.DB_OPERATION_REPLACE,
+    "astra.find_one_and_delete": SemanticConvention.DB_OPERATION_FIND_AND_DELETE,
+    "astra.delete": SemanticConvention.DB_OPERATION_DELETE,
+    "astra.delete_one": SemanticConvention.DB_OPERATION_DELETE,
+    "astra.delete_many": SemanticConvention.DB_OPERATION_DELETE,
+}
+
+def object_count(obj):
+    """
+    Counts length of object if it exists, else returns 0.
+    """
+    if isinstance(obj, list):
+        return len(obj)
+    elif obj is not None:
+        return 1
+    return 0
+
+def set_server_address_and_port(instance):
+    """
+    Extracts server address and port from AstraDB client instance.
+
+    Args:
+        instance: AstraDB client instance
+
+    Returns:
+        tuple: (server_address, server_port)
+    """
+    server_address = "astra.datastax.com"
+    server_port = 443
+
+    # Try getting api_endpoint from instance or its database
+    api_endpoint = getattr(instance, "api_endpoint", None)
+    if not api_endpoint:
+        # Try getting from database attribute
+        database = getattr(instance, "database", None)
+        if database:
+            api_endpoint = getattr(database, "api_endpoint", None)
+
+    if api_endpoint and isinstance(api_endpoint, str):
+        if api_endpoint.startswith(("http://", "https://")):
+            try:
+                parsed = urlparse(api_endpoint)
+                server_address = parsed.hostname or server_address
+                server_port = parsed.port or server_port
+            except Exception:
+                pass
+        else:
+            # Handle cases like "hostname:port" or just "hostname"
+            if ":" in api_endpoint:
+                parts = api_endpoint.split(":")
+                server_address = parts[0]
+                try:
+                    server_port = int(parts[1])
+                except (ValueError, IndexError):
+                    pass
+            else:
+                server_address = api_endpoint
+
+    return server_address, server_port
+
+def common_astra_logic(scope, environment, application_name,
+    metrics, capture_message_content, disable_metrics, version,
+    instance=None, endpoint=None):
+    """
+    Process AstraDB request and generate telemetry.
+
+    Args:
+        scope: Scope object containing span, response, and operation details
+        environment: Deployment environment
+        application_name: Name of the application
+        metrics: Metrics dictionary for recording telemetry
+        capture_message_content: Flag to capture message content
+        disable_metrics: Flag to disable metrics collection
+        version: Version of the AstraDB client
+        instance: AstraDB client instance
+        endpoint: Operation endpoint for differentiation
+    """
+    scope._end_time = time.time()
+
+    # Set common database span attributes using helper
+    common_db_span_attributes(scope, SemanticConvention.DB_SYSTEM_ASTRA,
+        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)
+
+    # Get collection name from instance
+    collection_name = getattr(instance, "name", "unknown")
+    scope._span.set_attribute(SemanticConvention.DB_COLLECTION_NAME, collection_name)
+
+    if scope._db_operation == SemanticConvention.DB_OPERATION_CREATE_COLLECTION:
+        # Handle create_collection operation
+        scope._span.set_attribute(SemanticConvention.DB_COLLECTION_DIMENSION,
+            scope._kwargs.get("dimension", -1))
+        scope._span.set_attribute(SemanticConvention.DB_INDEX_METRIC,
+            str(scope._kwargs.get("metric", "")))
+
+        # Set namespace if available in response
+        if scope._response and hasattr(scope._response, "keyspace"):
+            scope._span.set_attribute(SemanticConvention.DB_NAMESPACE, scope._response.keyspace)
+
+        if scope._response and hasattr(scope._response, "name"):
+            scope._span.set_attribute(SemanticConvention.DB_COLLECTION_NAME, scope._response.name)
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {collection_name} "
+            f"dimension={scope._kwargs.get('dimension', 'None')} "
+            f"metric={scope._kwargs.get('metric', 'None')}")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_DELETE_COLLECTION:
+        # Handle drop_collection operation
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {collection_name}")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_INSERT:
+        # Handle insert operations (insert_one, insert_many, regular insert)
+        documents = scope._args[0] if scope._args else scope._kwargs.get("documents", [])
+
+        scope._span.set_attribute(SemanticConvention.DB_DOCUMENTS_COUNT, object_count(documents))
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(documents))
+
+        # Response metrics
+        if scope._response and hasattr(scope._response, "inserted_ids"):
+            scope._span.set_attribute(SemanticConvention.DB_RESPONSE_RETURNED_ROWS,
+                len(scope._response.inserted_ids))
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {collection_name} "
+            f"documents_count={object_count(documents)}")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_UPDATE:
+        # Handle update operations (update_one, update_many, regular update)
+        update_query = scope._args[1] if len(scope._args) > 1 else scope._kwargs.get("update", {})
+        filter_query = scope._args[0] if scope._args else scope._kwargs.get("filter", {})
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(update_query))
+        scope._span.set_attribute(SemanticConvention.DB_FILTER, str(filter_query))
+
+        # Response metrics
+        if scope._response and hasattr(scope._response, "update_info"):
+            scope._span.set_attribute(SemanticConvention.DB_RESPONSE_RETURNED_ROWS,
+                scope._response.update_info.get("nModified", 0))
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {collection_name} "
+            f"filter={str(filter_query)[:100]}... "
+            f"update={str(update_query)[:100]}...")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_REPLACE:
+        # Handle replace operations (find_one_and_update, replace_one)
+        filter_query = scope._args[0] if scope._args else scope._kwargs.get("filter", {})
+
+        # Check if it's an upsert operation
+        if scope._kwargs.get("upsert"):
+            scope._db_operation = SemanticConvention.DB_OPERATION_UPSERT
+            scope._span.set_attribute(SemanticConvention.DB_OPERATION_NAME,
+                SemanticConvention.DB_OPERATION_UPSERT)
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(filter_query))
+        scope._span.set_attribute(SemanticConvention.DB_FILTER, str(filter_query))
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {collection_name} "
+            f"filter={str(filter_query)[:100]}... "
+            f"upsert={scope._kwargs.get('upsert', False)}")
+
+    elif scope._db_operation == SemanticConvention.DB_OPERATION_SELECT:
+        # Handle find operations
+        filter_query = scope._args[0] if scope._args else scope._kwargs.get("filter", {})
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(filter_query))
+        scope._span.set_attribute(SemanticConvention.DB_FILTER, str(filter_query))
+
+        # Response metrics
+        if scope._response and hasattr(scope._response, "__len__"):
+            scope._span.set_attribute(SemanticConvention.DB_RESPONSE_RETURNED_ROWS,
+                len(scope._response))
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {collection_name} "
+            f"filter={str(filter_query)[:100]}...")
+
+    elif scope._db_operation in [SemanticConvention.DB_OPERATION_DELETE,
+                                 SemanticConvention.DB_OPERATION_FIND_AND_DELETE]:
+        # Handle delete operations (delete_one, delete_many, find_one_and_delete)
+        filter_query = scope._args[0] if scope._args else scope._kwargs.get("filter", {})
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_TEXT, str(filter_query))
+        scope._span.set_attribute(SemanticConvention.DB_FILTER, str(filter_query))
+
+        # Response metrics
+        if scope._response and hasattr(scope._response, "deleted_count"):
+            scope._span.set_attribute(SemanticConvention.DB_RESPONSE_RETURNED_ROWS,
+                scope._response.deleted_count)
+
+        scope._span.set_attribute(SemanticConvention.DB_QUERY_SUMMARY,
+            f"{scope._db_operation} {collection_name} "
+            f"filter={str(filter_query)[:100]}...")
+
+    scope._span.set_status(Status(StatusCode.OK))
+
+    # Record metrics using helper
+    if not disable_metrics:
+        record_db_metrics(metrics, SemanticConvention.DB_SYSTEM_ASTRA,
+            scope._server_address, scope._server_port, environment, application_name,
+            scope._start_time, scope._end_time)
+
+def process_astra_response(response, db_operation, server_address, server_port,
+    environment, application_name, metrics, start_time, span,
+    capture_message_content, disable_metrics, version, instance, args, **kwargs):
+    """
+    Process AstraDB response and generate telemetry.
+
+    Args:
+        response: Response from AstraDB operation
+        db_operation: Database operation type
+        server_address: Server address
+        server_port: Server port
+        environment: Deployment environment
+        application_name: Application name
+        metrics: Metrics dictionary
+        start_time: Start time of the operation
+        span: OpenTelemetry span
+        capture_message_content: Flag to capture message content
+        disable_metrics: Flag to disable metrics
+        version: AstraDB client version
+        instance: AstraDB client instance
+        args: Positional arguments
+        **kwargs: Keyword arguments
+
+    Returns:
+        Original response
+    """
+
+    # Create a scope object to hold all the context
+    scope = type("GenericScope", (), {})()
+    scope._response = response
+    scope._db_operation = db_operation
+    scope._server_address = server_address
+    scope._server_port = server_port
+    scope._start_time = start_time
+    scope._span = span
+    scope._kwargs = kwargs
+    scope._args = args
+
+    # Process the response using common logic
+    common_astra_logic(scope, environment, application_name,
+        metrics, capture_message_content, disable_metrics, version, instance)
+
+    return response

openlit-1.34.27/src/openlit/instrumentation/milvus/__init__.py

@@ -0,0 +1,56 @@
+"""
+OpenLIT Milvus Instrumentation
+"""
+
+from typing import Collection
+import importlib.metadata
+from opentelemetry.instrumentation.instrumentor import BaseInstrumentor
+from wrapt import wrap_function_wrapper
+
+from openlit.instrumentation.milvus.milvus import general_wrap
+
+_instruments = ("pymilvus >= 2.4.3",)
+
+# Operations to wrap for Milvus client
+MILVUS_OPERATIONS = [
+    ("create_collection", "milvus.create_collection"),
+    ("drop_collection", "milvus.drop_collection"),
+    ("insert", "milvus.insert"),
+    ("upsert", "milvus.upsert"),
+    ("search", "milvus.search"),
+    ("query", "milvus.query"),
+    ("get", "milvus.get"),
+    ("delete", "milvus.delete"),
+]
+
+class MilvusInstrumentor(BaseInstrumentor):
+    """
+    An instrumentor for Milvus's client library.
+    """
+
+    def instrumentation_dependencies(self) -> Collection[str]:
+        return _instruments
+
+    def _instrument(self, **kwargs):
+        version = importlib.metadata.version("pymilvus")
+        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")
+        disable_metrics = kwargs.get("disable_metrics")
+
+        # Wrap operations
+        for method_name, endpoint in MILVUS_OPERATIONS:
+            wrap_function_wrapper(
+                "pymilvus",
+                f"MilvusClient.{method_name}",
+                general_wrap(
+                    endpoint, version, environment, application_name, tracer,
+                    pricing_info, capture_message_content, metrics, disable_metrics
+                ),
+            )
+
+    def _uninstrument(self, **kwargs):
+        pass

openlit-1.34.27/src/openlit/instrumentation/milvus/milvus.py

@@ -0,0 +1,52 @@
+"""
+Module for monitoring Milvus API calls.
+"""
+
+import time
+from opentelemetry.trace import SpanKind
+from opentelemetry import context as context_api
+from openlit.__helpers import handle_exception
+from openlit.instrumentation.milvus.utils import (
+    process_milvus_response,
+    DB_OPERATION_MAP,
+    set_server_address_and_port,
+)
+
+def general_wrap(gen_ai_endpoint, version, environment, application_name,
+    tracer, pricing_info, capture_message_content, metrics, disable_metrics):
+    """
+    Generates a telemetry wrapper for Milvus function calls.
+    """
+    def wrapper(wrapped, instance, args, kwargs):
+        # CRITICAL: Suppression check
+        if context_api.get_value(context_api._SUPPRESS_INSTRUMENTATION_KEY):
+            return wrapped(*args, **kwargs)
+
+        # Get server address and port using the standard helper
+        server_address, server_port = set_server_address_and_port(instance)
+
+        db_operation = DB_OPERATION_MAP.get(gen_ai_endpoint, "unknown")
+        if db_operation == "create_collection":
+            collection_name = kwargs.get("collection_name") or (args[0] if args else "unknown")
+        else:
+            collection_name = kwargs.get("collection_name", "unknown")
+        span_name = f"{db_operation} {collection_name}"
+
+        with tracer.start_as_current_span(span_name, kind=SpanKind.CLIENT) as span:
+            start_time = time.time()
+            response = wrapped(*args, **kwargs)
+
+            try:
+                # Process response and generate telemetry
+                response = process_milvus_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