User Sessions - exceptionless/Exceptionless GitHub Wiki

With user session tracking, you can easily see what a user is doing that leads up to an event occurrence, or just see how they are using your app.

Each session has a list of events (feature usages, exceptions, log messages, etc) that the user triggered. Each can be clicked on to drill down.

Exceptionless User Session Events

Browser and environment information, along with any other data that persists throughout the user session is stored as well.

Once you set up session tracking, you can find the report under Reports > Sessions, or click on the unique session id in any event's overview tab.

Exceptionless Sessions Report

Turn On Session Tracking

Set a default user identity via the following client methods to send the user ID for each event. Once set, it will be applied for all future events.

C# Example

using Exceptionless;
ExceptionlessClient.Default.Configuration.SetUserIdentity("UNIQUE_ID_OR_EMAIL_ADDRESS", "Display Name");

Javascript Example

exceptionless.ExceptionlessClient.default.config.setUserIdentity('UNIQUE_ID_OR_EMAIL_ADDRESS', 'Display Name');

Please Note: In WinForms and WPF applications, a plugin will automatically set the default user to the Environment.UserName if the default user hasn’t been already set. Likewise, if you are in a web environment, we will set the default user to the request principal’s identity if the default user hasn’t already been set.

If you are using WinForms, WPF, or a Browser App, you can enable sessions by calling the UseSessions extension method.

C# Example

using Exceptionless;
ExceptionlessClient.Default.Configuration.UseSessions();

Javascript Example

exceptionless.ExceptionlessClient.default.config.useSessions();

Manually Send SessionStart, SessionEnd, and heartbeat Events

You can use our client API to start, update, or end a session. Just remember, a user identity must be set.

C# Example

using Exceptionless;
ExceptionlessClient.Default.SubmitSessionStart();
ExceptionlessClient.Default.SubmitSessionHeartbeat();
ExceptionlessClient.Default.SubmitSessionEnd();

Javascript Example

exceptionless.ExceptionlessClient.default.submitSessionStart();
exceptionless.ExceptionlessClient.default.submitSessionHeartbeat();
exceptionless.ExceptionlessClient.default.submitSessionEnd();

Disable Heartbeat

If you would like to disable the near real-time session tracking heartbeat that goes out ever 30 seconds, you can pass false as an argument to the UseSessions() method.