Process sessions
Use Process Sessions to view historical session data for the processes you monitor with the Process Manager service. Each row is one process session recorded by the Workstation Agent — which process ran, who ran it, on which machine, for how long, how much of that time was idle, and why the session ended. You can view session data for standalone and network floating licenses.
Open the OpenLM Platform app launcher (grid icon, top-right) and select Agents → Process Sessions.
Before you start: Register the processes you want to monitor in Process Manager and install the Workstation Agent on each target machine.
Related: Usage
Process session data does not appear in Usage. Usage shows license sessions collected through the OpenLM Broker — for example in Currently Consumed Licenses and License Activity — not Workstation Agent process sessions.
Prerequisites
- Workstation Agent: Install the Workstation Agent on each target machine. You can monitor connected agents in Agent Activity Manager.
- Process Manager: Register the processes you want to monitor.
The Process Sessions report
The Process Sessions report — one row per session, with dropdown filters, date ranges, and CSV export.
Each row is one recorded session, with the following columns:
| Column | What it shows |
|---|---|
| Process Name | The monitored process the session belongs to |
| Username | The user who ran the process |
| Host Name | The workstation the session ran on |
| Total Idle Time | How long the process sat idle during the session — N/A when no idle time was recorded |
| Session Duration | The total length of the session |
| Session Start Time | When the session started |
| Session End Time | When the session ended |
| Shutdown Reason | Why the session ended — see Shutdown reasons |
| DLL Name | The DLL the session was tracked against, for processes with DLLs attached in Process Manager |
| Product Version | The version of the application that ran |
Start and end times follow the date format and time zone from your platform settings. Durations display as hours, minutes, and seconds (for example, 01h 10m 00s); durations longer than a day include a days part (for example, 7 days 10h 01m 38s).
To show, hide, or pin columns, open the column menu (the ⋮ icon at the right of the header row) and select Columns. Process Name, Username, Shutdown Reason, and DLL Name are always visible. The grid remembers your layout in the browser.
Show, hide, or pin columns from the column menu.
Shutdown reasons
The Shutdown Reason column tells you how each session ended:
| Reason | The session ended because… |
|---|---|
| Normal | The process exited normally — for example, the user closed the application. |
| Suspend | The Workstation Agent suspended the idle process to release its license (the Suspension release method). |
| Extension | A harvesting extension saved the user's work and closed the application (the Extension release method). |
| Script | A procedure — a scripted list of release actions — closed the process. |
| AdminShutdown | An administrative shutdown ended the session. |
| AgentOffline | The Workstation Agent went offline before the session ended. |
| Unknown | No recognized shutdown reason was reported. |
In practice you should never see Unknown. Every session ends with one of the other reasons above — including sessions where something went wrong during the release flow. If Unknown does appear, treat it as unexpected and contact OpenLM support.
Filter the report
The dropdowns above the table filter the report by the values recorded in your sessions:
- Username, Host Name, Process Name, Dll Name, Shutdown Reason — Select one or more values in each dropdown, then select Apply. Each dropdown loads its values from your recorded sessions, and all except Shutdown Reason (a fixed list) have a search box. In Dll Name, choose No DLL to match sessions recorded without a DLL.
- Values within one dropdown are combined with OR; different dropdowns are combined with AND.
- Clear empties all five dropdowns and both date ranges, and reloads the report.
Filter dropdowns are searchable, and you can select multiple values.
Filter by date
Two independent date-range pickers narrow the report by time — Select Session Start filters on when sessions started, and Select Session End on when they ended. Each opens a calendar with a Select Preset list (Last 7 Days, Last 30 Days, Last 60 Days, Last 180 Days, or Last 360 Days), or pick Custom and select a start and end date. Date ranges apply immediately when you pick them — no Apply needed.
Pick a preset or a custom range — the report reloads immediately.
Search and refresh
- Search highlights matching text in the rows currently on screen (process, user, host, shutdown reason, DLL, and version values). It doesn't change which rows are shown — use the filters for that.
- Refresh reloads the report with the current filters.
Export to CSV
Select the export button (next to Refresh) to download the report as Process Sessions.csv. The export includes the entire filtered report — not only the current page — and only the columns currently visible in the grid. Select Apply before exporting so the CSV matches the report on screen.
Pagination
The report follows the Number of records per page setting in UI Configurations (25 rows per page when not set). Switch to 50 or 100 with Items per page at the bottom of the table.
You can also view process session data in your BI tool for advanced analysis — see the Process Session report.