Named tracers

samples/Exporters/TestApplicationInsights.cs

@@ -26,7 +26,6 @@ namespace Samples
     using OpenTelemetry.Stats.Measures;
     using OpenTelemetry.Tags;
     using OpenTelemetry.Trace;
-    using OpenTelemetry.Trace.Config;
     using OpenTelemetry.Trace.Export;
     using OpenTelemetry.Trace.Sampler;
 
@@ -59,7 +58,8 @@ internal static object Run()
 
             var tagContextBuilder = Tagger.CurrentBuilder.Put(FrontendKey, TagValue.Create("mobile-ios9.3.5"));
 
-            var tracer = new Tracer(new BatchingSpanProcessor(exporter), TraceConfig.Default);
+            var tracerFactory = new TracerFactory(new BatchingSpanProcessor(exporter));
+            var tracer = tracerFactory.GetTracer(string.Empty);
             var spanBuilder = tracer
                 .SpanBuilder("incoming request")
                 .SetRecordEvents(true)

samples/Exporters/TestHttpClient.cs

@@ -22,7 +22,6 @@ namespace Samples
     using OpenTelemetry.Collector.Dependencies;
     using OpenTelemetry.Exporter.Zipkin;
     using OpenTelemetry.Trace;
-    using OpenTelemetry.Trace.Config;
     using OpenTelemetry.Trace.Export;
     using OpenTelemetry.Trace.Sampler;
 
@@ -39,8 +38,9 @@ internal static object Run()
                     ServiceName = typeof(Program).Assembly.GetName().Name,
                 });
 
-            var tracer = new Tracer(new BatchingSpanProcessor(exporter), TraceConfig.Default);
-            using (new DependenciesCollector(new DependenciesCollectorOptions(), tracer, Samplers.AlwaysSample))
+            var tracerFactory = new TracerFactory(new BatchingSpanProcessor(exporter));
+            var tracer = tracerFactory.GetTracer(string.Empty);
+            using (new DependenciesCollector(new DependenciesCollectorOptions(), tracerFactory, Samplers.AlwaysSample))
             {
                 using (tracer.WithSpan(tracer.SpanBuilder("incoming request").SetSampler(Samplers.AlwaysSample).StartSpan()))
                 {

samples/Exporters/TestJaeger.cs

@@ -20,9 +20,7 @@ namespace Samples
     using System.Collections.Generic;
     using System.Threading;
     using OpenTelemetry.Exporter.Jaeger;
-    using OpenTelemetry.Exporter.Jaeger.Implementation;
     using OpenTelemetry.Trace;
-    using OpenTelemetry.Trace.Config;
     using OpenTelemetry.Trace.Export;
 
     internal class TestJaeger
@@ -41,7 +39,8 @@ internal static object Run(string host, int port)
                 jaegerOptions);
 
             // Create a tracer. You may also need to register it as a global instance to make auto-collectors work..
-            var tracer = new Tracer(new BatchingSpanProcessor(exporter), TraceConfig.Default);
+            var tracerFactory = new TracerFactory(new BatchingSpanProcessor(exporter));
+            var tracer = tracerFactory.GetTracer(string.Empty);
 
             // Create a scoped span. It will end automatically when using statement ends
             using (tracer.WithSpan(tracer.SpanBuilder("Main").StartSpan()))
@@ -59,7 +58,7 @@ internal static object Run(string host, int port)
             return null;
         }
 
-        private static void DoWork(int i, Tracer tracer)
+        private static void DoWork(int i, ITracer tracer)
         {
             // Start another span. If another span was already started, it'll use that span as the parent span.
             // In this example, the main method already started a span, so that'll be the parent span, and this will be

samples/Exporters/TestLightstep.cs

@@ -7,7 +7,6 @@ namespace Samples
     using System.Threading;
     using OpenTelemetry.Exporter.LightStep;
     using OpenTelemetry.Trace;
-    using OpenTelemetry.Trace.Config;
     using OpenTelemetry.Trace.Export;
 
     internal class TestLightstep
@@ -21,7 +20,8 @@ internal static object Run(string accessToken)
                     ServiceName = "tracing-to-lightstep-service",
                 });
 
-            var tracer = new Tracer(new BatchingSpanProcessor(exporter), TraceConfig.Default);
+            var tracerFactory = new TracerFactory(new BatchingSpanProcessor(exporter));
+            var tracer = tracerFactory.GetTracer(string.Empty);
 
             using (tracer.WithSpan(tracer.SpanBuilder("Main").StartSpan()))
             {
@@ -38,7 +38,7 @@ internal static object Run(string accessToken)
             return null;
         }
 
-        private static void DoWork(int i, Tracer tracer)
+        private static void DoWork(int i, ITracer tracer)
         {
             using (tracer.WithSpan(tracer.SpanBuilder("DoWork").StartSpan()))
             {

samples/Exporters/TestRedis.cs

@@ -22,7 +22,6 @@ namespace Samples
     using OpenTelemetry.Collector.StackExchangeRedis;
     using OpenTelemetry.Exporter.Zipkin;
     using OpenTelemetry.Trace;
-    using OpenTelemetry.Trace.Config;
     using OpenTelemetry.Trace.Export;
     using StackExchange.Redis;
 
@@ -39,7 +38,8 @@ internal static object Run(string zipkinUri)
                 });
 
             // Create a tracer. You may also need to register it as a global instance to make auto-collectors work..
-            var tracer = new Tracer(new BatchingSpanProcessor(exporter), TraceConfig.Default);
+            var tracerFactory = new TracerFactory(new BatchingSpanProcessor(exporter));
+            var tracer = tracerFactory.GetTracer(string.Empty);
 
             var collector = new StackExchangeRedisCallsCollector(tracer);
 
@@ -65,7 +65,7 @@ internal static object Run(string zipkinUri)
             return null;
         }
 
-        private static void DoWork(IDatabase db, Tracer tracer)
+        private static void DoWork(IDatabase db, ITracer tracer)
         {
             // Start another span. If another span was already started, it'll use that span as the parent span.
             // In this example, the main method already started a span, so that'll be the parent span, and this will be

samples/Exporters/TestStackdriver.cs

@@ -25,7 +25,6 @@ namespace Samples
     using OpenTelemetry.Stats.Measures;
     using OpenTelemetry.Tags;
     using OpenTelemetry.Trace;
-    using OpenTelemetry.Trace.Config;
     using OpenTelemetry.Trace.Export;
     using OpenTelemetry.Trace.Sampler;
 
@@ -57,7 +56,8 @@ internal static object Run(string projectId)
                 Stats.ViewManager);
             metricExporter.Start();
 
-            var tracer = new Tracer(new BatchingSpanProcessor(spanExporter), TraceConfig.Default);
+            var tracerFactory = new TracerFactory(new BatchingSpanProcessor(spanExporter));
+            var tracer = tracerFactory.GetTracer(string.Empty);
 
             var tagContextBuilder = Tagger.CurrentBuilder.Put(FrontendKey, TagValue.Create("mobile-ios9.3.5"));
 

samples/Exporters/TestZipkin.cs

@@ -21,7 +21,6 @@ namespace Samples
     using System.Threading;
     using OpenTelemetry.Exporter.Zipkin;
     using OpenTelemetry.Trace;
-    using OpenTelemetry.Trace.Config;
     using OpenTelemetry.Trace.Export;
 
     internal class TestZipkin
@@ -37,7 +36,8 @@ internal static object Run(string zipkinUri)
                 });
 
             // Create a tracer. You may also need to register it as a global instance to make auto-collectors work..
-            var tracer = new Tracer(new BatchingSpanProcessor(exporter), TraceConfig.Default);
+            var tracerFactory = new TracerFactory(new BatchingSpanProcessor(exporter));
+            var tracer = tracerFactory.GetTracer(string.Empty);
 
             // Create a scoped span. It will end automatically when using statement ends
             using (tracer.WithSpan(tracer.SpanBuilder("Main").StartSpan()))
@@ -54,7 +54,7 @@ internal static object Run(string zipkinUri)
             return null;
         }
 
-        private static void DoWork(int i, Tracer tracer)
+        private static void DoWork(int i, ITracer tracer)
         {
             // Start another span. If another span was already started, it'll use that span as the parent span.
             // In this example, the main method already started a span, so that'll be the parent span, and this will be

samples/LoggingTracer/LoggingTracer.Demo.AspNetCore/LoggingTracerExtensions.cs

@@ -15,7 +15,7 @@ internal static class LoggingTracerExtensions
     {
         internal static void AddLoggingTracer(this IServiceCollection services)
         {
-            services.AddSingleton<ITracer, LoggingTracer>();
+            services.AddSingleton<ITracerFactory, LoggingTracerFactory>();
 
             services.AddSingleton(Samplers.AlwaysSample);
             services.AddSingleton<RequestsCollectorOptions>();

samples/LoggingTracer/LoggingTracer.Demo.ConsoleApp/Program.cs

@@ -9,19 +9,20 @@ namespace LoggingTracer.Demo.ConsoleApp
 
     public class Program
     {
-        private static ITracer tracer = new LoggingTracer();
-
         public static async Task Main(string[] args)
         {
+            var tracerFactory = new LoggingTracerFactory();
+            var tracer = tracerFactory.GetTracer("ConsoleApp", "semver:1.0.0");
+
             var builder = tracer.SpanBuilder("Main (span1)");
             using (tracer.WithSpan(builder.StartSpan()))
             {
                 await Task.Delay(100);
-                await Foo();
+                await Foo(tracer);
             }
         }
 
-        private static async Task Foo()
+        private static async Task Foo(ITracer tracer)
         {
             var builder = tracer.SpanBuilder("Foo (span2)");
             using (tracer.WithSpan(builder.StartSpan()))

samples/LoggingTracer/LoggingTracer/LoggingTracer.cs

@@ -2,6 +2,9 @@
 // Copyright (c) PlaceholderCompany. All rights reserved.
 // </copyright>
 
+using System.Linq;
+using OpenTelemetry.Resources;
+
 namespace LoggingTracer
 {
     using System;
@@ -10,6 +13,14 @@ namespace LoggingTracer
 
     public class LoggingTracer : ITracer
     {
+        private string prefix;
+
+        internal LoggingTracer(Resource libraryResource)
+        {
+            this.prefix = "Tracer(" + string.Join(", ", libraryResource.Labels.Select(l => l.Value).ToArray()) + ")";
+            Logger.Log($"{prefix}.ctor()");
+        }
+
         public ISpan CurrentSpan => CurrentSpanUtils.CurrentSpan;
 
         public IBinaryFormat BinaryFormat => new LoggingBinaryFormat();
@@ -18,13 +29,13 @@ public class LoggingTracer : ITracer
 
         public ISpanBuilder SpanBuilder(string spanName)
         {
-            Logger.Log($"Tracer.SpanBuilder({spanName})");
+            Logger.Log($"{prefix}.SpanBuilder({spanName})");
             return new LoggingSpanBuilder(spanName, SpanKind.Internal);
         }
 
         public IDisposable WithSpan(ISpan span)
         {
-            Logger.Log("Tracer.WithSpan");
+            Logger.Log($"{prefix}.WithSpan");
             return new CurrentSpanUtils.LoggingScope(span);
         }
     }

samples/LoggingTracer/LoggingTracer/LoggingTracerFactory.cs

@@ -0,0 +1,35 @@
+// <copyright file="LoggingTracerFactory.cs" company="PlaceholderCompany">
+// Copyright (c) PlaceholderCompany. All rights reserved.
+// </copyright>
+
+using System.Collections.Generic;
+using OpenTelemetry.Resources;
+
+namespace LoggingTracer
+{
+    using OpenTelemetry.Context;
+    using OpenTelemetry.Context.Propagation;
+    using OpenTelemetry.Trace;
+
+    public class LoggingTracerFactory : ITracerFactory
+    {
+        public override ITracer GetTracer(string name, string version = null)
+        {
+            Logger.Log($"TracerFactory.GetTracer('{name}', '{version}')");
+
+            // Create a Resource from "name" and "version" information.
+            var labels = new Dictionary<string, string>();
+            if (!string.IsNullOrEmpty(name))
+            {
+                labels.Add("name", name);
+                if (!string.IsNullOrEmpty(version))
+                {
+                    labels.Add("version", version);
+                }
+            }
+            var libraryResource = Resource.Create(labels);
+
+            return new LoggingTracer(libraryResource);
+        }
+    }
+}

src/OpenTelemetry.Abstractions/Trace/ITracerFactory.cs

@@ -0,0 +1,35 @@
+// <copyright file="ITracerFactory.cs" company="OpenTelemetry Authors">
+// Copyright 2018, OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// </copyright>
+
+namespace OpenTelemetry.Trace
+{
+    using OpenTelemetry.Context;
+    using OpenTelemetry.Context.Propagation;
+
+    /// <summary>
+    /// Creates Tracers for an instrumentation library.
+    /// </summary>
+    public abstract class ITracerFactory
+    {
+        /// <summary>
+        /// Returns an ITracer for a given name and version.
+        /// </summary>
+        /// <param name="name">Name of the instrumentation library.</param>
+        /// <param name="version">Version of the instrumentation library (optional).</param>
+        /// <returns>Tracer for the given name and version information.</returns>
+        public abstract ITracer GetTracer(string name, string version = null);
+    }
+}