Automatic spans collection for Redis (#93)

Automatic spans collection for Redis

Author: SergeyKanzhelev

CHANGELOG.md

@@ -11,6 +11,9 @@ the release.
   and process links, annotations and messages.
 - ASP.NET Core collector now uses `http.route` for the span name.
 - Initial implementation of Resource Specification.
+- Plug in to collect Redis calls made using StackExchange.Redis package.
+- Object of type `ISpanData` can be created using only Abstractions package.
+- Number of minor APIs adjustments.
 
 ## 0.1.0-alpha-33381
 

OpenCensus.sln

@@ -63,6 +63,10 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OpenCensus.Exporter.Stackdr
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OpenCensus.Exporter.ApplicationInsights.Tests", "test\OpenCensus.Exporter.ApplicationInsights.Tests\OpenCensus.Exporter.ApplicationInsights.Tests.csproj", "{1FA1F509-7722-48E3-9A35-16CBB6774957}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OpenCensus.Collector.StackExchangeRedis", "src\OpenCensus.Collector.StackExchangeRedis\OpenCensus.Collector.StackExchangeRedis.csproj", "{6B681D72-D68A-44CC-8C75-53B9A322E6EC}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OpenCensus.Collector.StackExchangeRedis.Tests", "test\OpenCensus.Collector.StackExchangeRedis.Tests\OpenCensus.Collector.StackExchangeRedis.Tests.csproj", "{CA98AF29-0852-4ADD-A66B-7E96266EE7B7}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -133,6 +137,14 @@ Global
 		{1FA1F509-7722-48E3-9A35-16CBB6774957}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{1FA1F509-7722-48E3-9A35-16CBB6774957}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{1FA1F509-7722-48E3-9A35-16CBB6774957}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6B681D72-D68A-44CC-8C75-53B9A322E6EC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6B681D72-D68A-44CC-8C75-53B9A322E6EC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6B681D72-D68A-44CC-8C75-53B9A322E6EC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6B681D72-D68A-44CC-8C75-53B9A322E6EC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{CA98AF29-0852-4ADD-A66B-7E96266EE7B7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{CA98AF29-0852-4ADD-A66B-7E96266EE7B7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{CA98AF29-0852-4ADD-A66B-7E96266EE7B7}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{CA98AF29-0852-4ADD-A66B-7E96266EE7B7}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

README.md

@@ -32,6 +32,7 @@ We encourage contributions. Use tags [up-for-grabs][up-for-grabs-issues] and
 | ----------------------- | ---------------- | -----------------|
 | Asp.Net Core            | [![MyGet Nightly][opencensus-collect-aspnetcore-myget-image]][opencensus-collect-aspnetcore-myget-url]       | [![NuGet Release][opencensus-collect-aspnetcore-nuget-image]][opencensus-collect-aspnetcore-nuget-url]   |
 | .Net Core HttpClient    | [![MyGet Nightly][opencensus-collect-deps-myget-image]][opencensus-collect-deps-myget-url]                   | [![NuGet Release][opencensus-collect-deps-nuget-image]][opencensus-collect-deps-nuget-url]               |
+| StackExchange.Redis     | [![MyGet Nightly][opencensus-collect-stackexchange-redis-myget-image]][opencensus-collect-stackexchange-redis-myget-url]    | [![NuGet Release][opencensus-collect-stackexchange-redis-nuget-image]][opencensus-collect-stackexchange-redis-nuget-url]|
 
 ### Exporters Packages
 
@@ -109,6 +110,41 @@ Outgoing http calls made by .NET Core `HttpClient` can be automatically tracked.
         var depCollector = app.ApplicationServices.GetService<DependenciesCollector>();
     ```
 
+### Using StackExchange.Redis collector
+
+Outgoing http calls to Redis made usign StackExchange.Redis library can be automatically tracked.
+
+1. Install package to your project:
+   [OpenCensus.Collector.StackExchangeRedis][opencensus-collect-stackexchange-redis-nuget-url]
+
+2. Make sure `ITracer`, `ISampler`, and `IExportComponent` registered in DI.
+    ``` csharp
+    services.AddSingleton<ITracer>(Tracing.Tracer);
+    services.AddSingleton<ISampler>(Samplers.AlwaysSample);
+    services.AddSingleton<IExportComponent>(Tracing.ExportComponent);
+    ```
+
+3. Configure data collection singletons in ConfigureServices method:
+    ``` csharp
+    public void ConfigureServices(IServiceCollection services)
+    {
+        // ...
+        services.AddSingleton<StackExchangeRedisCallsCollectorOptions>(new StackExchangeRedisCallsCollectorOptions());
+        services.AddSingleton<StackExchangeRedisCallsCollector>();
+    ```
+
+4. Initiate data collection by instantiating singleton in Configure method
+    ``` csharp
+    public void Configure(IApplicationBuilder app, /*... other arguments*/ )
+    {
+        // ...
+        var redisCollector = app.ApplicationServices.GetService<StackExchangeRedisCallsCollector>();
+
+        // use collector to configure the profiler
+        ConnectionMultiplexer connection = ConnectionMultiplexer.Connect("localhost:6379");
+        connection.RegisterProfiler(redisCollector.GetProfilerSessionsFactory());
+    ```
+
 ## OpenCensus QuickStart: exporting data
 
 ### Using Zipkin exporter
@@ -236,6 +272,8 @@ deprecate it for 18 months before removing it, if possible.
 [opencensus-collect-aspnetcore-myget-url]: https://www.myget.org/feed/opencensus/package/nuget/OpenCensus.Collector.AspNetCore
 [opencensus-collect-deps-myget-image]:https://img.shields.io/myget/opencensus/vpre/OpenCensus.Collector.Dependencies.svg
 [opencensus-collect-deps-myget-url]: https://www.myget.org/feed/opencensus/package/nuget/OpenCensus.Collector.Dependencies
+[opencensus-collect-stackexchange-redis-myget-image]:https://img.shields.io/myget/opencensus/vpre/OpenCensus.Collector.StackExchangeRedis.svg
+[opencensus-collect-stackexchange-redis-myget-url]: https://www.myget.org/feed/opencensus/package/nuget/OpenCensus.Collector.StackExchangeRedis
 [opencensus-nuget-image]:https://img.shields.io/nuget/vpre/OpenCensus.svg
 [opencensus-nuget-url]:https://www.nuget.org/packages/OpenCensus
 [opencensus-abs-nuget-image]:https://img.shields.io/nuget/vpre/OpenCensus.Abstractions.svg
@@ -252,6 +290,8 @@ deprecate it for 18 months before removing it, if possible.
 [opencensus-collect-aspnetcore-nuget-url]: https://www.nuget.org/packages/OpenCensus.Collector.AspNetCore
 [opencensus-collect-deps-nuget-image]:https://img.shields.io/nuget/vpre/OpenCensus.Collector.Dependencies.svg
 [opencensus-collect-deps-nuget-url]: https://www.nuget.org/packages/OpenCensus.Collector.Dependencies
+[opencensus-collect-stackexchange-redis-nuget-image]:https://img.shields.io/nuget/vpre/OpenCensus.Collector.StackExchangeRedis.svg
+[opencensus-collect-stackexchange-redis-nuget-url]: https://www.nuget.org/packages/OpenCensus.Collector.StackExchangeRedis
 [up-for-grabs-issues]: https://github.com/census-instrumentation/opencensus-csharp/issues?q=is%3Aissue+is%3Aopen+label%3Aup-for-grabs
 [good-first-issues]: https://github.com/census-instrumentation/opencensus-csharp/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22
 [zipkin-get-started]: https://zipkin.io/pages/quickstart.html

src/OpenCensus/Common/Duration.cs …enCensus.Abstractions/Common/Duration.cssrc/OpenCensus/Common/Duration.cs renamed to src/OpenCensus.Abstractions/Common/Duration.cs src/OpenCensus/Common/Duration.cs renamed to src/OpenCensus.Abstractions/Common/Duration.cs

@@ -26,13 +26,11 @@
     </PackageReference>
   </ItemGroup>
   <ItemGroup>
-    <Folder Include="Common\" />
     <Folder Include="Internal\" />
     <Folder Include="Stats\" />
     <Folder Include="Tags\" />
   </ItemGroup>
   <ItemGroup>
-    <Compile Remove="Utils\Arrays.cs" />
     <Compile Remove="Utils\AttributesWithCapacity.cs" />
   </ItemGroup>
 </Project>

src/OpenCensus/Common/Timestamp.cs …nCensus.Abstractions/Common/Timestamp.cssrc/OpenCensus/Common/Timestamp.cs renamed to src/OpenCensus.Abstractions/Common/Timestamp.cs src/OpenCensus/Common/Timestamp.cs renamed to src/OpenCensus.Abstractions/Common/Timestamp.cs

@@ -17,7 +17,8 @@
 namespace OpenCensus.Tags
 {
     using System.Collections.Generic;
-    using OpenCensus.Utils.Abstractions;
+    using OpenCensus.Abstractions.Utils;
+    using OpenCensus.Utils;
 
     /// <summary>
     /// Collection of tags.

src/OpenCensus.Abstractions/OpenCensus.Abstractions.csproj

@@ -20,7 +20,7 @@ namespace OpenCensus.Trace
     using System.Collections.Generic;
     using System.Collections.ObjectModel;
     using System.Linq;
-    using OpenCensus.Utils;
+    using OpenCensus.Abstractions.Utils;
 
     public sealed class Annotation : IAnnotation
     {