Added a new session plugin useful for desktop based applications that don't send very many events but are long lived.

Author: niemyjski

Source/Shared/Exceptionless.Portable.csproj

@@ -60,6 +60,7 @@
     <Compile Include="Dependency\TinyIoC.cs" />
     <Compile Include="Events\EventSubmissionEventArgsBase.cs" />
     <Compile Include="Events\EventSubmittedEventArgs.cs" />
+    <Compile Include="Plugins\Default\025_SessionIdManagementPlugin.cs" />
     <Compile Include="Plugins\Default\030_DuplicateCheckerPlugin.cs" />
     <Compile Include="Plugins\ContextData.cs" />
     <Compile Include="Plugins\Default\1000_CancelSessionsWithNoUserPlugin.cs" />

Source/Shared/Extensions/ExceptionlessConfigurationExtensions.cs

@@ -8,6 +8,7 @@
 using Exceptionless.Logging;
 using Exceptionless.Models;
 using Exceptionless.Models.Data;
+using Exceptionless.Plugins;
 using Exceptionless.Storage;
 
 namespace Exceptionless {
@@ -86,11 +87,21 @@ public static string GetInstallId(this ExceptionlessConfiguration config) {
             return persistedClientData[INSTALL_ID_KEY];
         }
 
-        public static void UseSessions(this ExceptionlessConfiguration config, bool sendHeartbeats = true) {
+        /// <summary>
+        /// Automatically send session start, session heartbeats and session end events.
+        /// </summary>
+        /// <param name="config">Exceptionless configuration</param>
+        /// <param name="sendHeartbeats">Controls whether heartbeat events are sent on an interval.</param>
+        /// <param name="heartbeatInterval">The interval at which heartbeats are sent after the last sent event. The default is 30 seconds.</param>
+        /// <param name="useSessionIdManagement">Allows you to manually control the session id. This is only recommended for single user desktop environments.</param>
+        public static void UseSessions(this ExceptionlessConfiguration config, bool sendHeartbeats = true, TimeSpan? heartbeatInterval = null, bool useSessionIdManagement = false) {
             config.SessionsEnabled = true;
 
+            if (useSessionIdManagement) 
+                config.AddPlugin<SessionIdManagementPlugin>();
+
             if (sendHeartbeats)
-                config.AddPlugin<HeartbeatPlugin>();
+                config.AddPlugin(new HeartbeatPlugin(heartbeatInterval));
         }
 
         public static InMemoryExceptionlessLog UseInMemoryLogger(this ExceptionlessConfiguration config, LogLevel minLogLevel = LogLevel.Info) {

Source/Shared/Plugins/Default/025_SessionIdManagementPlugin.cs

@@ -0,0 +1,20 @@
+using System;
+
+namespace Exceptionless.Plugins {
+    [Priority(25)]
+    public class SessionIdManagementPlugin : IEventPlugin {
+        private string _sessionId;
+        public void Run(EventPluginContext context) {
+            if (context.Event.IsSessionStart() || String.IsNullOrEmpty(_sessionId))
+                _sessionId = Guid.NewGuid().ToString("N");
+
+            if (context.Event.IsSessionStart())
+                context.Event.ReferenceId = _sessionId;
+            else
+                context.Event.SetEventReference("session", _sessionId);
+
+            if (context.Event.IsSessionEnd())
+                _sessionId = null;
+        }
+    }
+}