Merge pull request #199 from mathworks/timestamps

Add unsetTracerProvider and friends

Author: duncanpo

OtelMatlabProxyFactory.cpp

@@ -1,4 +1,4 @@
-// Copyright 2023-2024 The MathWorks, Inc.
+// Copyright 2023-2025 The MathWorks, Inc.
 
 #include "OtelMatlabProxyFactory.h"
 
@@ -8,7 +8,10 @@
 //#include "opentelemetry-matlab/trace/ScopeProxy.h"
 #include "opentelemetry-matlab/trace/SpanContextProxy.h"
 #include "opentelemetry-matlab/trace/TraceContextPropagatorProxy.h"
+#include "opentelemetry-matlab/trace/NoOpTracerProviderProxy.h"
+#include "opentelemetry-matlab/metrics/NoOpMeterProviderProxy.h"
 #include "opentelemetry-matlab/logs/LoggerProviderProxy.h"
+#include "opentelemetry-matlab/logs/NoOpLoggerProviderProxy.h"
 #include "opentelemetry-matlab/context/propagation/TextMapCarrierProxy.h"
 #include "opentelemetry-matlab/context/propagation/TextMapPropagatorProxy.h"
 #include "opentelemetry-matlab/context/propagation/CompositePropagatorProxy.h"
@@ -57,6 +60,9 @@ OtelMatlabProxyFactory::make_proxy(const libmexclass::proxy::ClassName& class_na
     REGISTER_PROXY(libmexclass.opentelemetry.SpanProxy, libmexclass::opentelemetry::SpanProxy);
     //REGISTER_PROXY(libmexclass.opentelemetry.ScopeProxy, libmexclass::opentelemetry::ScopeProxy);
     REGISTER_PROXY(libmexclass.opentelemetry.SpanContextProxy, libmexclass::opentelemetry::SpanContextProxy);
+    REGISTER_PROXY(libmexclass.opentelemetry.NoOpTracerProviderProxy, libmexclass::opentelemetry::NoOpTracerProviderProxy);
+    REGISTER_PROXY(libmexclass.opentelemetry.NoOpMeterProviderProxy, libmexclass::opentelemetry::NoOpMeterProviderProxy);
+    REGISTER_PROXY(libmexclass.opentelemetry.NoOpLoggerProviderProxy, libmexclass::opentelemetry::NoOpLoggerProviderProxy);
     REGISTER_PROXY(libmexclass.opentelemetry.TextMapCarrierProxy, libmexclass::opentelemetry::TextMapCarrierProxy);
     REGISTER_PROXY(libmexclass.opentelemetry.ContextProxy, libmexclass::opentelemetry::ContextProxy);
     REGISTER_PROXY(libmexclass.opentelemetry.TokenProxy, libmexclass::opentelemetry::TokenProxy);

api/logs/+opentelemetry/+logs/+internal/NoOpLoggerProvider.m

@@ -0,0 +1,20 @@
+classdef NoOpLoggerProvider < handle
+    % A no-op logger provider does nothing and is used to disable logging.
+    % For internal use only.
+
+    % Copyright 2025 The MathWorks, Inc.
+
+    properties (Access=private)
+        Proxy   % Proxy object to interface C++ code
+    end
+
+    methods (Access=?opentelemetry.logs.Provider)
+        function obj = NoOpLoggerProvider()
+            % constructs a no-op LoggerProvider and sets it as the global
+            % instance
+            obj.Proxy = libmexclass.proxy.Proxy("Name", ...
+                "libmexclass.opentelemetry.NoOpLoggerProviderProxy", ...
+                "ConstructorArguments", {});
+        end
+    end
+end

api/logs/+opentelemetry/+logs/Provider.m

@@ -1,7 +1,7 @@
 classdef Provider
 % Get and set the global instance of logger provider
 
-% Copyright 2024 The MathWorks, Inc.
+% Copyright 2024-2025 The MathWorks, Inc.
 
     methods (Static)
         function p = getLoggerProvider()
@@ -19,10 +19,22 @@ function setLoggerProvider(p)
             %    OPENTELEMETRY.LOGS.PROVIDER.SETLOGGERPROVIDER(LP) sets
             %    LP as the global instance of logger provider.
             %
-            %    See also OPENTELEMETRY.LOGS.PROVIDER.GETTRACERPROVIDER
+            %    See also OPENTELEMETRY.LOGS.PROVIDER.GETLOGGERPROVIDER, 
+            %    OPENTELEMETRY.LOGS.PROVIDER.UNSETLOGGERPROVIDER
 
             p.setLoggerProvider();
         end
+
+        function unsetLoggerProvider()
+            % Unset the global instance of logger provider, which disables
+            % logging
+            %    OPENTELEMETRY.LOGS.PROVIDER.UNSETLOGGERPROVIDER() unsets
+            %    the global instance of logger provider.
+            %
+            %    See also OPENTELEMETRY.LOGS.PROVIDER.SETLOGGERPROVIDER
+
+            opentelemetry.logs.internal.NoOpLoggerProvider;
+        end
     end
 
 end

api/logs/include/opentelemetry-matlab/logs/NoOpLoggerProviderProxy.h

@@ -0,0 +1,29 @@
+// Copyright 2025 The MathWorks, Inc.
+
+#pragma once
+
+#include "libmexclass/proxy/Proxy.h"
+
+#include "opentelemetry/logs/logger_provider.h"
+#include "opentelemetry/logs/provider.h"
+#include "opentelemetry/logs/noop.h"
+
+namespace logs_api = opentelemetry::logs;
+namespace nostd = opentelemetry::nostd;
+
+namespace libmexclass::opentelemetry {
+class NoOpLoggerProviderProxy : public libmexclass::proxy::Proxy {
+  public:
+    NoOpLoggerProviderProxy(nostd::shared_ptr<logs_api::LoggerProvider> lp) : CppLoggerProvider(lp) {
+        // set as global LoggerProvider instance
+        logs_api::Provider::SetLoggerProvider(CppLoggerProvider);
+    } 
+
+    static libmexclass::proxy::MakeResult make(const libmexclass::proxy::FunctionArguments& constructor_arguments) {
+        return std::make_shared<NoOpLoggerProviderProxy>(nostd::shared_ptr<logs_api::LoggerProvider>(new logs_api::NoopLoggerProvider()));
+    }
+
+  protected:
+    nostd::shared_ptr<logs_api::LoggerProvider> CppLoggerProvider;
+};
+} // namespace libmexclass::opentelemetry

api/metrics/+opentelemetry/+metrics/+internal/NoOpMeterProvider.m

@@ -0,0 +1,20 @@
+classdef NoOpMeterProvider < handle
+    % A no-op meter provider does nothing and is used to disable metrics.
+    % For internal use only.
+
+    % Copyright 2025 The MathWorks, Inc.
+
+    properties (Access=private)
+        Proxy   % Proxy object to interface C++ code
+    end
+
+    methods (Access=?opentelemetry.metrics.Provider)
+        function obj = NoOpMeterProvider()
+            % constructs a no-op MeterProvider and sets it as the global
+            % instance
+            obj.Proxy = libmexclass.proxy.Proxy("Name", ...
+                "libmexclass.opentelemetry.NoOpMeterProviderProxy", ...
+                "ConstructorArguments", {});
+        end
+    end
+end

api/metrics/+opentelemetry/+metrics/Provider.m

@@ -1,7 +1,7 @@
 classdef Provider
 % Get and set the global instance of meter provider
 
-% Copyright 2023 The MathWorks, Inc.
+% Copyright 2023-2025 The MathWorks, Inc.
 
     methods (Static)
         function p = getMeterProvider()
@@ -19,9 +19,21 @@ function setMeterProvider(p)
             %    OPENTELEMETRY.METRICS.PROVIDER.GETMETERPROVIDER(MP) sets
             %    MP as the global instance of meter provider.
             %
-            %    See also OPENTELEMETRY.METRICS.PROVIDER.GETMETERPROVIDER
+            %    See also OPENTELEMETRY.METRICS.PROVIDER.GETMETERPROVIDER, 
+            %    OPENTELEMETRY.METRICS.PROVIDER.UNSETMETERPROVIDER
             p.setMeterProvider();
         end
+
+        function unsetMeterProvider()
+            % Unset the global instance of meter provider, which disables
+            % metrics
+            %    OPENTELEMETRY.METRICS.PROVIDER.UNSETMETERPROVIDER() unsets
+            %    the global instance of meter provider.
+            %
+            %    See also OPENTELEMETRY.METRICS.PROVIDER.SETMETERPROVIDER
+
+            opentelemetry.metrics.internal.NoOpMeterProvider;
+        end
     end
 
 end

api/metrics/include/opentelemetry-matlab/metrics/NoOpMeterProviderProxy.h

@@ -0,0 +1,29 @@
+// Copyright 2025 The MathWorks, Inc.
+
+#pragma once
+
+#include "libmexclass/proxy/Proxy.h"
+
+#include "opentelemetry/metrics/meter_provider.h"
+#include "opentelemetry/metrics/provider.h"
+#include "opentelemetry/metrics/noop.h"
+
+namespace metrics_api = opentelemetry::metrics;
+namespace nostd = opentelemetry::nostd;
+
+namespace libmexclass::opentelemetry {
+class NoOpMeterProviderProxy : public libmexclass::proxy::Proxy {
+  public:
+    NoOpMeterProviderProxy(nostd::shared_ptr<metrics_api::MeterProvider> mp) : CppMeterProvider(mp) {
+        // set as global MeterProvider instance
+        metrics_api::Provider::SetMeterProvider(CppMeterProvider);
+    } 
+
+    static libmexclass::proxy::MakeResult make(const libmexclass::proxy::FunctionArguments& constructor_arguments) {
+        return std::make_shared<NoOpMeterProviderProxy>(nostd::shared_ptr<metrics_api::MeterProvider>(new metrics_api::NoopMeterProvider()));
+    }
+
+  protected:
+    nostd::shared_ptr<metrics_api::MeterProvider> CppMeterProvider;
+};
+} // namespace libmexclass::opentelemetry

api/trace/+opentelemetry/+trace/+internal/NoOpTracerProvider.m

@@ -0,0 +1,20 @@
+classdef NoOpTracerProvider < handle
+    % A no-op tracer provider does nothing and is used to disable tracing.
+    % For internal use only.
+
+    % Copyright 2025 The MathWorks, Inc.
+
+    properties (Access=private)
+        Proxy   % Proxy object to interface C++ code
+    end
+
+    methods (Access=?opentelemetry.trace.Provider)
+        function obj = NoOpTracerProvider()
+            % constructs a no-op TracerProvider and sets it as the global
+            % instance
+            obj.Proxy = libmexclass.proxy.Proxy("Name", ...
+                "libmexclass.opentelemetry.NoOpTracerProviderProxy", ...
+                "ConstructorArguments", {});
+        end
+    end
+end

api/trace/+opentelemetry/+trace/Provider.m

@@ -1,7 +1,7 @@
 classdef Provider
 % Get and set the global instance of tracer provider
 
-% Copyright 2023 The MathWorks, Inc.
+% Copyright 2023-2025 The MathWorks, Inc.
 
     methods (Static)
         function p = getTracerProvider()
@@ -16,13 +16,25 @@
 
         function setTracerProvider(p)
             % Set the global instance of tracer provider
-            %    OPENTELEMETRY.TRACE.PROVIDER.GETTRACERPROVIDER(TP) sets
+            %    OPENTELEMETRY.TRACE.PROVIDER.SETTRACERPROVIDER(TP) sets
             %    TP as the global instance of tracer provider.
             %
-            %    See also OPENTELEMETRY.TRACE.PROVIDER.GETTRACERPROVIDER
+            %    See also OPENTELEMETRY.TRACE.PROVIDER.GETTRACERPROVIDER, 
+            %    OPENTELEMETRY.TRACE.PROVIDER.UNSETTRACERPROVIDER
 
             p.setTracerProvider();
         end
+
+        function unsetTracerProvider()
+            % Unset the global instance of tracer provider, which disables
+            % tracing
+            %    OPENTELEMETRY.TRACE.PROVIDER.UNSETTRACERPROVIDER() unsets
+            %    the global instance of tracer provider.
+            %
+            %    See also OPENTELEMETRY.TRACE.PROVIDER.SETTRACERPROVIDER
+
+            opentelemetry.trace.internal.NoOpTracerProvider;
+        end
     end
 
 end

api/trace/include/opentelemetry-matlab/trace/NoOpTracerProviderProxy.h

@@ -0,0 +1,29 @@
+// Copyright 2025 The MathWorks, Inc.
+
+#pragma once
+
+#include "libmexclass/proxy/Proxy.h"
+
+#include "opentelemetry/trace/tracer_provider.h"
+#include "opentelemetry/trace/provider.h"
+#include "opentelemetry/trace/noop.h"
+
+namespace trace_api = opentelemetry::trace;
+namespace nostd = opentelemetry::nostd;
+
+namespace libmexclass::opentelemetry {
+class NoOpTracerProviderProxy : public libmexclass::proxy::Proxy {
+  public:
+    NoOpTracerProviderProxy(nostd::shared_ptr<trace_api::TracerProvider> tp) : CppTracerProvider(tp) {
+        // set as global TracerProvider instance
+        trace_api::Provider::SetTracerProvider(CppTracerProvider);
+    } 
+
+    static libmexclass::proxy::MakeResult make(const libmexclass::proxy::FunctionArguments& constructor_arguments) {
+        return std::make_shared<NoOpTracerProviderProxy>(nostd::shared_ptr<trace_api::TracerProvider>(new trace_api::NoopTracerProvider()));
+    }
+
+  protected:
+    nostd::shared_ptr<trace_api::TracerProvider> CppTracerProvider;
+};
+} // namespace libmexclass::opentelemetry