feat(AGE-298) : enable auto instrumentation without middleware-run

Author: mw-advait

dev-requirements.txt

@@ -257,7 +257,7 @@ opentelemetry-propagator-aws-xray==1.0.2
     #   opentelemetry-instrumentation-botocore
 opentelemetry-propagator-b3==1.27.0
     # via middleware-io (pyproject.toml)
-opentelemetry-propagator-gcp==1.7.0
+opentelemetry-propagator-gcp==1.9.0
     # via middleware-io (pyproject.toml)
 opentelemetry-propagator-jaeger==1.27.0
     # via middleware-io (pyproject.toml)
@@ -272,7 +272,7 @@ opentelemetry-resource-detector-azure==0.1.5
     # via middleware-io (pyproject.toml)
 opentelemetry-resourcedetector-docker==0.4.0
     # via middleware-io (pyproject.toml)
-opentelemetry-resourcedetector-gcp==1.7.0a0
+opentelemetry-resourcedetector-gcp==1.9.0a0
     # via middleware-io (pyproject.toml)
 opentelemetry-sdk==1.27.0
     # via

middleware/__init__.py

@@ -1,4 +1,4 @@
-from middleware.distro import mw_tracker, custom_record_exception_wrapper, record_exception
+from middleware.distro import mw_tracker, mw_tracker_internal, custom_record_exception_wrapper, record_exception
 from opentelemetry.sdk.trace import Span
 from middleware.options import (
     MWOptions,
@@ -15,8 +15,9 @@
 )
 
 __all__ = [
-    "mw_tracker",
+    "mw_tracker_internal",
     "record_exception",
+    "mw_tracker",
     "MWOptions",
     "DETECT_AWS_BEANSTALK",
     "DETECT_AWS_EC2",

middleware/distro.py

@@ -29,7 +29,7 @@
 )
 
 
-def mw_tracker(
+def mw_tracker_internal(
     options: Optional[MWOptions] = None,
 ):
     """
@@ -246,7 +246,38 @@ def custom_record_exception(span: Span, exc: Exception):
     )
 
 
+def mw_tracker(options: Optional[MWOptions] = None):
+    """
+    Configures the OpenTelemetry SDK to send telemetry to middleware.
 
+    Args:
+        options (MWOptions, optional): the MWOptions used to
+        configure the the SDK. These options can be set either as parameters
+        to this function or through environment variables
+
+    Example
+    --------
+    >>> from middleware import mw_tracker, MWOptions, record_exception, DETECT_AWS_EC2
+    >>> mw_tracker(
+    >>>     MWOptions(
+    >>>         access_token="whkvkobudfitutobptgonaezuxpjjypnejbb",
+    >>>         target="https://myapp.middleware.io:443",
+    >>>         console_exporter=True,
+    >>>         debug_log_file=True,
+    >>>         service_name="MyPythonServer",
+    >>>         otel_propagators = "b3,tracecontext",
+    >>>         custom_resource_attributes="call_id=12345678, request_id=987654321",
+    >>>         detectors=[DETECT_AWS_EC2]
+    >>>     )
+    >>> )
+
+    """
+    distro = MiddlewareDistro()
+    distro._configure(options=options)
+    # global isTracker, distro_called
+    # if isTracker:
+    #     distro_called = True
+    #     mw_tracker_internal(options=options)
 
 # pylint: disable=too-few-public-methods
 class MiddlewareDistro(BaseDistro):
@@ -264,8 +295,11 @@ class MiddlewareDistro(BaseDistro):
     distro = "middleware.opentelemetry.distro:MiddlewareDistro"
     """
 
-    def _configure(self, **kwargs):
+    def _configure(self, options: Optional[MWOptions] = None, **kwargs):
         global isTracker, distro_called
         distro_called = True
         if not isTracker:
-            mw_tracker()
+            mw_tracker_internal()
+        elif isTracker and options is not None:
+            mw_tracker_internal(options=options)
+

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "middleware-io"
-version = "2.4.0"
+version = "2.4.1rc11"
 requires-python = ">=3.8"
 description = "Middleware's APM tool enables Python developers to effortlessly monitor their applications, gathering distributed tracing, metrics, logs, and profiling data for valuable insights and performance optimization."
 authors = [{ name = "middleware-dev" }]
@@ -35,10 +35,10 @@ dependencies =[
     "opentelemetry-propagator-jaeger==1.27.0",
     "opentelemetry-propagator-aws-xray==1.0.2",
     "opentelemetry-propagator-ot-trace==0.48b0",
-    "opentelemetry-propagator-gcp==1.7.0",
+    "opentelemetry-propagator-gcp==1.9.0",
     "opentelemetry-sdk-extension-aws==2.0.2",
     "opentelemetry-resource-detector-azure==0.1.5",
-    "opentelemetry-resourcedetector-gcp==1.7.0a0",
+    "opentelemetry-resourcedetector-gcp==1.9.0a0",
     "opentelemetry-resourcedetector-docker==0.4.0",
     "gitpython>=3.1.0",