monocle-apptrace 0.0.1__tar.gz → 0.1.0__tar.gz

monocle_apptrace-0.1.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+## 0.1.0 (Aug 27, 2024)
+
+- Fixed LlamaIndex tracing bugs ([#32](https://github.com/monocle2ai/monocle/pull/32))
+- Added support to add AWS cloud infra attributes ([#29](https://github.com/monocle2ai/monocle/pull/29))
+- Added support to add Azure cloud infra attributes ([#23](https://github.com/monocle2ai/monocle/pull/23))
+- Added support for adding provider name in LLM span in traces ([#22](https://github.com/monocle2ai/monocle/pull/22))
+- Added a default file span exporter ([#21](https://github.com/monocle2ai/monocle/pull/21))
+- Moved input and output context and prompts from attributes to events ([#15](https://github.com/monocle2ai/monocle/pull/15))
+
+
+
+
+
+
+## 0.0.1 (Jul 17, 2024)
+
+- First monocle release

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/Monocle_User_Guide.md

@@ -37,8 +37,7 @@ from langchain_openai import OpenAI
 from langchain.prompts import PromptTemplate
 
 # Call the setup Monocle telemetry method
-setup_monocle_telemetry(workflow_name = "simple_math_app",
-        span_processors=[BatchSpanProcessor(ConsoleSpanExporter())])
+setup_monocle_telemetry(workflow_name = "simple_math_app")
 
 llm = OpenAI()
 prompt = PromptTemplate.from_template("1 + {number} = ")
@@ -51,6 +50,19 @@ chain = LLMChain(llm=llm, prompt=prompt)
 chain.invoke({"number":2}, {"callbacks":[handler]})
     
 ```
+
+### Accessing monocle trace
+By default monocle generate traces in a json file created in the local directory where the application is running. The file name by default is monocle_trace_{workflow_name}\_{trace_id}\_{timestamp}.json where the trace_id is a unique number generated by monocle for every trace. Please refere to [Trace span json](Monocle_User_Guide.md#trace-span-json). The file path and format can be changed by setting those properties as argement to ```setup_monocle_telemetry()```. For example,
+```
+setup_monocle_telemetry(workflow_name = "simple_math_app",
+    span_processors=[BatchSpanProcessor(FileSpanExporter(
+        out_path = "/tmp",
+        file_prefix = "map_app_prod_trace_",
+        time_format = "%Y-%m-%d"))
+    ])
+```
+To print the trace on the console, use ```ConsoleSpanExporter()``` instead of ```FileSpanExporter()```
+
 ### Leveraging Monocle's extensibility to handle customization 
 When the out of box features from app frameworks are not sufficent, the app developers have to add custom code. For example, if you are extending a LLM class in LlamaIndex to use a model hosted in NVIDIA Triton. This new class is not know to Monocle. You can specify this new class method part of Monocle enabling API and it will be able to trace it.
 
@@ -83,13 +95,13 @@ setup_monocle_telemetry(
         wrapper_methods=[
             WrapperMethod(
                 package="langchain.schema.runnable",
-                object="RunnableParallel",
+                object_name="RunnableParallel",
                 method="invoke",
                 span_name="langchain.workflow",
                 wrapper=task_wrapper),
             WrapperMethod(
                 package="langchain.schema.runnable",
-                object="RunnableParallel",
+                object_name="RunnableParallel",
                 method="ainvoke",
                 span_name="langchain.workflow",
                 wrapper=atask_wrapper)
@@ -110,7 +122,7 @@ Monocle generates spans which adhere to [Tracing API | OpenTelemetry](https://op
 | Span JSON      | Description     |
 | ------------- | ------------- |
 | {||
-|  "```name```": "langchain.workflow",|span name and is configurable in [__init.py__](src/monocle_apptrace/langchain/__init__.py) or in ```setup_okahu_telemetry(...)```|
+|  "```name```": "langchain.workflow",|span name and is configurable in [__init.py__](src/monocle_apptrace/langchain/__init__.py) or in ```setup_monocle_telemetry(...)```|
 |  "```context```": {|this gets autogenerated|
 |      "```trace_id```": "0xe5269f0e534efa098b240f974220d6b7",||
 |         "```span_id```": "0x30b13075eca52f44",||
@@ -124,7 +136,7 @@ Monocle generates spans which adhere to [Tracing API | OpenTelemetry](https://op
 |   "```status_code```": "UNSET"| status of span to OK or ERROR. Default is UNSET|
 |  },||
 |"```attributes```": {||
-|  "workflow_name": "ml_rag_app",|defines the name of the service being set in ```setup_okahu_telemetry(...)``` during initialization of instrumentation|
+|  "workflow_name": "ml_rag_app",|defines the name of the service being set in ```setup_monocle_telemetry(...)``` during initialization of instrumentation|
 |  "workflow_type": "workflow.langchain"|type of framework that generated this span|
 |  },||
 |"```events```": [|captures the log records|

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: monocle_apptrace
-Version: 0.0.1
+Version: 0.1.0
 Summary: package with monocle genAI tracing
 Project-URL: Homepage, https://github.com/monocle2ai/monocle
 Project-URL: Issues, https://github.com/monocle2ai/monocle/issues
@@ -27,6 +27,7 @@ Requires-Dist: llama-index-embeddings-huggingface==0.2.0; extra == 'dev'
 Requires-Dist: llama-index-vector-stores-chroma==0.1.9; extra == 'dev'
 Requires-Dist: llama-index==0.10.30; extra == 'dev'
 Requires-Dist: numpy==1.26.4; extra == 'dev'
+Requires-Dist: parameterized==0.9.0; extra == 'dev'
 Requires-Dist: pytest==8.0.0; extra == 'dev'
 Requires-Dist: sentence-transformers==2.6.1; extra == 'dev'
 Requires-Dist: types-requests==2.31.0.20240106; extra == 'dev'
@@ -63,7 +64,7 @@ The traces are compatible with OpenTelemetry format. They are further enriched t
 ```
 - Enable Monocle tracing in your app by adding following
 ```
-    setup_okahu_telemetry(workflow_name="your-app-name")
+    setup_monocle_telemetry(workflow_name="your-app-name")
 ```
 Please refer to [Monocle user guide](Monocle_User_Guide.md) for more details
 

monocle_apptrace-0.1.0/Pipfile.lock

@@ -0,0 +1,46 @@
+{
+    "_meta": {
+        "hash": {
+            "sha256": "48ca59749d628df4416e69ea793ec7181fe158afbd8741c25e6aa27d8074bbb1"
+        },
+        "pipfile-spec": 6,
+        "requires": {
+            "python_version": "3.11"
+        },
+        "sources": [
+            {
+                "name": "pypi",
+                "url": "https://pypi.org/simple",
+                "verify_ssl": true
+            }
+        ]
+    },
+    "default": {
+        "build": {
+            "hashes": [
+                "sha256:526263f4870c26f26c433545579475377b2b7588b6f1eac76a001e873ae3e19d",
+                "sha256:75e10f767a433d9a86e50d83f418e83efc18ede923ee5ff7df93b6cb0306c5d4"
+            ],
+            "index": "pypi",
+            "markers": "python_version >= '3.8'",
+            "version": "==1.2.1"
+        },
+        "packaging": {
+            "hashes": [
+                "sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002",
+                "sha256:5b8f2217dbdbd2f7f384c41c628544e6d52f2d0f53c6d0c3ea61aa5d1d7ff124"
+            ],
+            "markers": "python_version >= '3.8'",
+            "version": "==24.1"
+        },
+        "pyproject-hooks": {
+            "hashes": [
+                "sha256:4b37730834edbd6bd37f26ece6b44802fb1c1ee2ece0e54ddff8bfc06db86965",
+                "sha256:7ceeefe9aec63a1064c18d939bdc3adf2d8aa1988a510afec15151578b232aa2"
+            ],
+            "markers": "python_version >= '3.7'",
+            "version": "==1.1.0"
+        }
+    },
+    "develop": {}
+}

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/README.md

@@ -29,7 +29,7 @@ The traces are compatible with OpenTelemetry format. They are further enriched t
 ```
 - Enable Monocle tracing in your app by adding following
 ```
-    setup_okahu_telemetry(workflow_name="your-app-name")
+    setup_monocle_telemetry(workflow_name="your-app-name")
 ```
 Please refer to [Monocle user guide](Monocle_User_Guide.md) for more details
 

monocle_apptrace-0.1.0/monocle_trace_file_test_0x8e5ff83c337b2649098910e1db3c8173_2024-08-27.json

@@ -0,0 +1,24 @@
+{
+    "name": "dummy.span",
+    "context": {
+        "trace_id": "0x8e5ff83c337b2649098910e1db3c8173",
+        "span_id": "0x2bbee7a930714909",
+        "trace_state": "[]"
+    },
+    "kind": "SpanKind.INTERNAL",
+    "parent_id": null,
+    "start_time": "2024-08-27T06:18:15.315360Z",
+    "end_time": "2024-08-27T06:18:15.315549Z",
+    "status": {
+        "status_code": "UNSET"
+    },
+    "attributes": {},
+    "events": [],
+    "links": [],
+    "resource": {
+        "attributes": {
+            "service.name": "file_test"
+        },
+        "schema_url": ""
+    }
+}

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "monocle_apptrace"
-version = "0.0.1"
+version = "0.1.0"
 authors = []
 description = "package with monocle genAI tracing"
 readme = "README.md"
@@ -42,7 +42,8 @@ dev = [
   'pytest==8.0.0',
   'llama-index==0.10.30',
   'llama-index-embeddings-huggingface==0.2.0',
-  'llama-index-vector-stores-chroma==0.1.9'
+  'llama-index-vector-stores-chroma==0.1.9',
+  'parameterized==0.9.0'
 ]
 
 [project.urls]

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/src/monocle_apptrace/README.md

@@ -62,13 +62,13 @@ setup_monocle_telemetry(
         wrapper_methods=[
             WrapperMethod(
                 package="langchain.schema.runnable",
-                object="RunnableParallel",
+                object_name="RunnableParallel",
                 method="invoke",
                 span_name="langchain.workflow",
                 wrapper=task_wrapper),
             WrapperMethod(
                 package="langchain.schema.runnable",
-                object="RunnableParallel",
+                object_name="RunnableParallel",
                 method="ainvoke",
                 span_name="langchain.workflow",
                 wrapper=atask_wrapper)

monocle_apptrace-0.1.0/src/monocle_apptrace/constants.py

@@ -0,0 +1,22 @@
+# Azure environment constants
+AZURE_ML_ENDPOINT_ENV_NAME = "AZUREML_ENTRY_SCRIPT"
+AZURE_FUNCTION_WORKER_ENV_NAME = "FUNCTIONS_WORKER_RUNTIME"
+AZURE_APP_SERVICE_ENV_NAME = "WEBSITE_SITE_NAME"
+AWS_LAMBDA_ENV_NAME = "AWS_LAMBDA_RUNTIME_API"
+
+# Azure naming reference can be found here
+# https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/ready/azure-best-practices/resource-abbreviations
+AZURE_FUNCTION_NAME = "azure.func"
+AZURE_APP_SERVICE_NAME = "azure.asp"
+AZURE_ML_SERVICE_NAME = "azure.mlw"
+AWS_LAMBDA_SERVICE_NAME = "aws.lambda"
+
+azure_service_map = {
+    AZURE_ML_ENDPOINT_ENV_NAME: AZURE_ML_SERVICE_NAME,
+    AZURE_APP_SERVICE_ENV_NAME: AZURE_APP_SERVICE_NAME,
+    AZURE_FUNCTION_WORKER_ENV_NAME: AZURE_FUNCTION_NAME
+}
+
+aws_service_map = {
+    AWS_LAMBDA_ENV_NAME: AWS_LAMBDA_SERVICE_NAME
+}

monocle_apptrace-0.1.0/src/monocle_apptrace/exporters/file_exporter.py

@@ -0,0 +1,63 @@
+#pylint: disable=consider-using-with
+
+from os import linesep, path
+from io import TextIOWrapper
+from datetime import datetime
+from typing import Optional, Callable, Sequence
+from opentelemetry.sdk.trace import ReadableSpan
+from opentelemetry.sdk.trace.export import SpanExporter, SpanExportResult
+from opentelemetry.sdk.resources import SERVICE_NAME
+
+DEFAULT_FILE_PREFIX:str = "monocle_trace_"
+DEFAULT_TIME_FORMAT:str = "%Y-%m-%d_%H.%M.%S"
+
+class FileSpanExporter(SpanExporter):
+    current_trace_id: int = None
+    current_file_path: str = None
+
+    def __init__(
+        self,
+        service_name: Optional[str] = None,
+        out_path:str = ".",
+        file_prefix = DEFAULT_FILE_PREFIX,
+        time_format = DEFAULT_TIME_FORMAT,
+        formatter: Callable[
+            [ReadableSpan], str
+        ] = lambda span: span.to_json()
+        + linesep,
+    ):
+        self.out_handle:TextIOWrapper = None
+        self.formatter = formatter
+        self.service_name = service_name
+        self.output_path = out_path
+        self.file_prefix = file_prefix
+        self.time_format = time_format
+
+    def export(self, spans: Sequence[ReadableSpan]) -> SpanExportResult:
+        for span in spans:
+            if span.context.trace_id != self.current_trace_id:
+                self.rotate_file(span.resource.attributes[SERVICE_NAME],
+                                span.context.trace_id)
+            self.out_handle.write(self.formatter(span))
+        self.out_handle.flush()
+        return SpanExportResult.SUCCESS
+
+    def rotate_file(self, trace_name:str, trace_id:int) -> None:
+        self.reset_handle()
+        self.current_file_path = path.join(self.output_path,
+                        self.file_prefix + trace_name + "_" + hex(trace_id) + "_"
+                        + datetime.now().strftime(self.time_format) + ".json")
+        self.out_handle = open(self.current_file_path, "w", encoding='UTF-8')
+        self.current_trace_id = trace_id
+
+    def force_flush(self, timeout_millis: int = 30000) -> bool:
+        self.out_handle.flush()
+        return True
+
+    def reset_handle(self) -> None:
+        if self.out_handle is not None:
+            self.out_handle.close()
+            self.out_handle = None
+
+    def shutdown(self) -> None:
+        self.reset_handle()

monocle_apptrace-0.1.0/src/monocle_apptrace/haystack/__init__.py

@@ -0,0 +1,9 @@
+
+import os
+import logging
+from monocle_apptrace.utils import load_wrapper_from_config
+
+logger = logging.getLogger(__name__)
+parent_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
+HAYSTACK_METHODS = load_wrapper_from_config(
+    os.path.join(parent_dir, 'wrapper_config', 'haystack_methods.json'))

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/src/monocle_apptrace/haystack/wrap_node.py

@@ -21,7 +21,7 @@ def wrap(tracer, to_wrap, wrapped, instance, args, kwargs):
         workflow_name = span.resource.attributes.get("service.name")
         span.set_attribute("workflow_name",workflow_name)
         span.set_attribute("workflow_type", WORKFLOW_TYPE_MAP["haystack"])
-        
+
         response = wrapped(*args, **kwargs)
 
     return response

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/src/monocle_apptrace/haystack/wrap_openai.py

@@ -1,5 +1,3 @@
-
-
 import logging
 from opentelemetry import context as context_api
 from opentelemetry.instrumentation.utils import _SUPPRESS_INSTRUMENTATION_KEY
@@ -17,9 +15,7 @@ def _set_input_attributes(span, kwargs, instance, args):
 
     if 'model' in instance.__dict__:
         model_name = instance.__dict__.get("model")
-        set_span_attribute(span, "openai_model_name", model_name)
-
-    return
+        set_span_attribute(span, "model_name", model_name)
 
 @dont_throw
 def _set_response_attributes(span, response):
@@ -39,14 +35,10 @@ def wrap_openai(tracer, to_wrap, wrapped, instance, args, kwargs):
     with tracer.start_as_current_span("haystack.openai") as span:
         if span.is_recording():
             _set_input_attributes(span, kwargs, instance, args)
-
-
-        
         response = wrapped(*args, **kwargs)
 
         if response:
             if span.is_recording():
                 _set_response_attributes(span, response)
-                
 
         return response

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/src/monocle_apptrace/haystack/wrap_pipeline.py

@@ -1,5 +1,3 @@
-
-
 import logging
 from opentelemetry import context as context_api
 from opentelemetry.context import attach, set_value
@@ -18,13 +16,12 @@ def wrap(tracer, to_wrap, wrapped, instance, args, kwargs):
     name = "haystack_pipeline"
     attach(set_value("workflow_name", name))
     inputs = set()
-    input = get_workflow_input(args, inputs)
+    workflow_input = get_workflow_input(args, inputs)
 
     with tracer.start_as_current_span(f"{name}.workflow") as span:
-        span.set_attribute(PROMPT_INPUT_KEY, input)
+        span.set_attribute(PROMPT_INPUT_KEY, workflow_input)
         workflow_name = span.resource.attributes.get("service.name")
         set_workflow_attributes(span, workflow_name)
-        
         response = wrapped(*args, **kwargs)
         set_workflow_output(span, response)
     return response
@@ -37,12 +34,12 @@ def get_workflow_input(args, inputs):
     for value in args[0].values():
         for text in value.values():
             inputs.add(text)
-    
-    input: str = ""
+
+    workflow_input: str = ""
 
     for input_str in inputs:
-        input = input + input_str
-    return input
+        workflow_input = workflow_input + input_str
+    return workflow_input
 
 def set_workflow_attributes(span, workflow_name):
     span.set_attribute("workflow_name",workflow_name)

{monocle_apptrace-0.0.1 → monocle_apptrace-0.1.0}/src/monocle_apptrace/instrumentor.py

@@ -10,25 +10,26 @@ from opentelemetry.sdk.trace import TracerProvider, Span
 from opentelemetry.sdk.trace.export import BatchSpanProcessor, SpanProcessor
 from opentelemetry.sdk.resources import SERVICE_NAME, Resource
 from opentelemetry import trace
+from opentelemetry.context import get_value, attach, set_value
 from monocle_apptrace.wrap_common import CONTEXT_PROPERTIES_KEY
 from monocle_apptrace.wrapper import INBUILT_METHODS_LIST, WrapperMethod
-from opentelemetry.context import get_value, attach, set_value
+from monocle_apptrace.exporters.file_exporter import FileSpanExporter
 
 
 logger = logging.getLogger(__name__)
 
-_instruments = ("langchain >= 0.0.346",)
+_instruments = ()
 
 class MonocleInstrumentor(BaseInstrumentor):
-    
+
     workflow_name: str = ""
     user_wrapper_methods: list[WrapperMethod] = []
     instrumented_method_list: list[object] = []
-    
+
     def __init__(
             self,
-            user_wrapper_methods: list[WrapperMethod] = []) -> None:
-        self.user_wrapper_methods = user_wrapper_methods
+            user_wrapper_methods: list[WrapperMethod] = None) -> None:
+        self.user_wrapper_methods = user_wrapper_methods or []
         super().__init__()
 
     def instrumentation_dependencies(self) -> Collection[str]:
@@ -63,11 +64,11 @@ class MonocleInstrumentor(BaseInstrumentor):
                 self.instrumented_method_list.append(wrapped_method)
             except Exception as ex:
                 if wrapped_method in user_method_list:
-                    logger.error(f"""_instrument wrap Exception: {str(ex)} 
+                    logger.error(f"""_instrument wrap Exception: {str(ex)}
                                 for package: {wrap_package},
                                 object:{wrap_object},
                                 method:{wrap_method}""")
-            
+
 
     def _uninstrument(self, **kwargs):
         for wrapped_method in self.instrumented_method_list:
@@ -80,33 +81,33 @@ class MonocleInstrumentor(BaseInstrumentor):
                     wrap_method,
                 )
             except Exception as ex:
-                logger.error(f"""_instrument unwrap Exception: {str(ex)} 
+                logger.error(f"""_instrument unwrap Exception: {str(ex)}
                              for package: {wrap_package},
                              object:{wrap_object},
                              method:{wrap_method}""")
-           
 
 def setup_monocle_telemetry(
         workflow_name: str,
-        span_processors: List[SpanProcessor] = [],
-        wrapper_methods: List[WrapperMethod] = []):
+        span_processors: List[SpanProcessor] = None,
+        wrapper_methods: List[WrapperMethod] = None):
     resource = Resource(attributes={
         SERVICE_NAME: workflow_name
     })
-    traceProvider = TracerProvider(resource=resource)
-    tracerProviderDefault = trace.get_tracer_provider()
-    providerType = type(tracerProviderDefault).__name__
-    isProxyProvider = "Proxy" in providerType
+    span_processors = span_processors or [BatchSpanProcessor(FileSpanExporter())]
+    trace_provider = TracerProvider(resource=resource)
+    tracer_provider_default = trace.get_tracer_provider()
+    provider_type = type(tracer_provider_default).__name__
+    is_proxy_provider = "Proxy" in provider_type
     for processor in span_processors:
         processor.on_start = on_processor_start
-        if not isProxyProvider:
-            tracerProviderDefault.add_span_processor(processor)
+        if not is_proxy_provider:
+            tracer_provider_default.add_span_processor(processor)
         else :
-            traceProvider.add_span_processor(processor)
-    if isProxyProvider :
-        trace.set_tracer_provider(traceProvider)
-    instrumentor = MonocleInstrumentor(user_wrapper_methods=wrapper_methods)
-    instrumentor.app_name = workflow_name
+            trace_provider.add_span_processor(processor)
+    if is_proxy_provider :
+        trace.set_tracer_provider(trace_provider)
+    instrumentor = MonocleInstrumentor(user_wrapper_methods=wrapper_methods or [])
+    # instrumentor.app_name = workflow_name
     if not instrumentor.is_instrumented_by_opentelemetry:
         instrumentor.instrument()
 
@@ -117,11 +118,7 @@ def on_processor_start(span: Span, parent_context):
         for key, value in context_properties.items():
             span.set_attribute(
                 f"{CONTEXT_PROPERTIES_KEY}.{key}", value
-            )    
+            )
 
 def set_context_properties(properties: dict) -> None:
     attach(set_value(CONTEXT_PROPERTIES_KEY, properties))
-
-
-
-

monocle_apptrace-0.1.0/src/monocle_apptrace/langchain/__init__.py

@@ -0,0 +1,6 @@
+import os
+from monocle_apptrace.utils import load_wrapper_from_config
+
+parent_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
+LANGCHAIN_METHODS = load_wrapper_from_config(
+    os.path.join(parent_dir, 'wrapper_config', 'lang_chain_methods.json'))

monocle_apptrace-0.1.0/src/monocle_apptrace/llamaindex/__init__.py

@@ -0,0 +1,15 @@
+
+#pylint: disable=protected-access
+import os
+from monocle_apptrace.utils import load_wrapper_from_config
+
+def get_llm_span_name_for_openai(instance):
+    if (hasattr(instance, "_is_azure_client")
+        and callable(getattr(instance, "_is_azure_client"))
+        and instance._is_azure_client()):
+        return "llamaindex.azure_openai"
+    return "llamaindex.openai"
+
+parent_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
+LLAMAINDEX_METHODS = load_wrapper_from_config(
+    os.path.join(parent_dir, 'wrapper_config', 'llama_index_methods.json'))

monocle_apptrace-0.1.0/src/monocle_apptrace/utils.py

@@ -0,0 +1,73 @@
+import logging
+import json
+from importlib import import_module
+import os
+from opentelemetry.trace import Span
+from monocle_apptrace.constants import azure_service_map, aws_service_map
+
+def set_span_attribute(span, name, value):
+    if value is not None:
+        if value != "":
+            span.set_attribute(name, value)
+
+def dont_throw(func):
+    """
+    A decorator that wraps the passed in function and logs exceptions instead of throwing them.
+
+    @param func: The function to wrap
+    @return: The wrapper function
+    """
+    # Obtain a logger specific to the function's module
+    logger = logging.getLogger(func.__module__)
+    # pylint: disable=inconsistent-return-statements
+    def wrapper(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+        except Exception as ex:
+            logger.warning("Failed to execute %s, error: %s", func.__name__, str(ex))
+    return wrapper
+
+def with_tracer_wrapper(func):
+    """Helper for providing tracer for wrapper functions."""
+
+    def _with_tracer(tracer, to_wrap):
+        def wrapper(wrapped, instance, args, kwargs):
+            return func(tracer, to_wrap, wrapped, instance, args, kwargs)
+
+        return wrapper
+
+    return _with_tracer
+
+def resolve_from_alias(my_map, alias):
+    """Find a alias that is not none from list of aliases"""
+
+    for i in alias:
+        if i in my_map.keys():
+            return my_map[i]
+    return None
+
+def load_wrapper_from_config(config_file_path: str, module_name: str = None):
+    wrapper_methods = []
+    with open(config_file_path, encoding='UTF-8') as config_file:
+        json_data = json.load(config_file)
+        wrapper_methods = json_data["wrapper_methods"]
+        for wrapper_method in wrapper_methods:
+            wrapper_method["wrapper"] = get_wrapper_method(
+                wrapper_method["wrapper_package"], wrapper_method["wrapper_method"])
+            if "span_name_getter_method" in wrapper_method :
+                wrapper_method["span_name_getter"] = get_wrapper_method(
+                    wrapper_method["span_name_getter_package"],
+                    wrapper_method["span_name_getter_method"])
+        return wrapper_methods
+
+def get_wrapper_method(package_name: str, method_name: str):
+    wrapper_module = import_module("monocle_apptrace." + package_name)
+    return getattr(wrapper_module, method_name)
+
+def update_span_with_infra_name(span: Span, span_key: str):
+    for key,val  in azure_service_map.items():
+        if key in os.environ:
+            span.set_attribute(span_key, val)
+    for key,val  in aws_service_map.items():
+        if key in os.environ:
+            span.set_attribute(span_key, val)