Session logging

Session logs capture all user activity and interactions during a Browsolate session.

Introduction

Browsolate logs all session activity for auditing and security purposes. These logs are accessible through AWS CloudWatch in the log group named browsolate-logs. Each day has its own logfile, named according to the format sessions-YYYY-MM-DD.

Logs are stored in the region where your Browsolate instance is deployed, and you can view them directly in CloudWatch.

Accessing Logs

  1. Navigate to AWS CloudWatch in your AWS Console.
  2. Select Log groups and find the log group named browsolate-logs.
  3. Inside this log group, you will find logs for each day, named in the format sessions-YYYY-MM-DD.
  4. Open the log for the desired date to view detailed session events.

Sample Log Entries

Logs capture key events such as the start and end of a session, along with various session parameters and configurations. Below are sample log entries for session start and session end events.

Sample Session Start Event:

{
    "event": "session_start",
    "sessionId": "SESSION:94e31200-7991-4c4b-8a3e-a211a43f8723",
    "startTime": "2024-10-23T10:18:34.838Z",
    "clipboardRead": true,
    "sessionExtensionTime": 30,
    "screenWidth": 1024,
    "customRequestHeaders": {
        "header1": "value1",
        "header2": "value2"
    },
    "urlEditable": false,
    "screenHeight": 768,
    "readOnly": false,
    "userAgent": "",
    "sessionExtensionAllowed": false,
    "url": "https://www.redacted  .com/",
    "logIndirectUrlNavigation": false,
    "navigation": true,
    "linkId": "",
    "clipboardWrite": true,
    "linkExpiry": -1,
    "logDirectUrlNavigation": false,
    "sessionLifetime": 300,
    "debugMode": false
}

Sample Session End Event:

{
    "event": "session_end",
    "sessionId": "SESSION:94e31200-7991-4c4b-8a3e-a211a43f8723",
    "startTime": "2024-10-23T10:18:34.838Z",
    "endTime": "2024-10-23T10:18:47.937Z",
    "sessionLengthSeconds": 13,
    "reason": "Session ended",
    "clipboardRead": true,
    "sessionExtensionTime": 30,
    "screenWidth": 1024,
    "customRequestHeaders": {
        "header1": "value1",
        "header2": "value2"
    },
    "urlEditable": false,
    "screenHeight": 768,
    "readOnly": false,
    "userAgent": "",
    "sessionExtensionAllowed": false,
    "url": "https://www.redacted.com/",
    "logIndirectUrlNavigation": false,
    "navigation": true,
    "linkId": "",
    "clipboardWrite": true,
    "linkExpiry": -1,
    "logDirectUrlNavigation": false,
    "sessionLifetime": 300,
    "debugMode": false
}