Accounting – RADIUS Session Accounting and User Activity Reports
Overview
Section titled “Overview”The Accounting page provides detailed RADIUS accounting records for all authenticated sessions processed by MideyeServer. Each entry captures the session timestamp, authenticated username, mobile number, RADIUS client, LDAP profile, group membership, and department — giving administrators a complete audit trail of user activity.
Use accounting data for compliance reporting, license usage analysis, department-level authentication statistics, and billing purposes. The page supports multi-dimensional filtering and CSV export, enabling you to generate targeted reports for specific time periods, user populations, or organizational units.
A unique user counter provides a quick summary of how many distinct users authenticated within the selected filter criteria — useful for license compliance and capacity planning.
Access & Permissions
Section titled “Access & Permissions”Required Role: ROOT, SUPER_ADMIN, ADMIN, or OPERATOR
Navigation: Home → Logs → Accounting
| Role | View Accounting | Export CSV |
|---|---|---|
| ROOT | ✅ | ✅ |
| SUPER_ADMIN | ✅ | ✅ |
| ADMIN | ✅ | ✅ |
| OPERATOR | ✅ | ✅ |
Features & Configuration
Section titled “Features & Configuration”Viewing Accounting Records
Section titled “Viewing Accounting Records”The data grid displays accounting entries with server-side pagination and sorting. Records are sorted by time in descending order by default, with today’s date range pre-selected.
| Column | Default Visible | Description |
|---|---|---|
| Time | ✅ | Timestamp of the accounting event |
| Username | ✅ | Authenticated user identity |
| RADIUS Client Name | ❌ (hidden) | Name of the NAS that initiated the session |
| MSISDN | ✅ | Mobile phone number |
| LDAP Profile Name | ✅ | Directory profile used for authentication |
| Group Name | ✅ | LDAP group membership |
| Department Name | ✅ | Organizational department |
Unique User Count
Section titled “Unique User Count”Above the data grid, a summary indicator displays: “Number of unique users: N” — showing the count of distinct users matching the current filter criteria. This counter updates automatically when filters change.
Filtering Accounting Data
Section titled “Filtering Accounting Data”Click the Filter icon in the toolbar to open the filter panel. All filter values are debounced (1-second delay).
| Filter | Type | Description |
|---|---|---|
| Start Date | Date picker | Beginning of the reporting period (defaults to today at midnight) |
| End Date | Date picker | End of the reporting period (defaults to end of today) |
| Username | Text input | Search by username |
| RADIUS Clients | Multi-select | Filter by one or more RADIUS client names |
| Groups | Multi-select | Filter by LDAP group membership |
| LDAP Profiles | Multi-select | Filter by directory profile |
| Departments | Multi-select | Filter by organizational department |
All multi-select dropdown options are dynamically populated from the available accounting data, ensuring only relevant filter values are presented.
Exporting Accounting Data to CSV
Section titled “Exporting Accounting Data to CSV”Click the Export (download) icon in the data grid toolbar to open the export dialog.
Export Dialog:
- Confirmation message: “Do you want to export the accounting search result to CSV file?”
- The export uses the current filter criteria to determine which records to include.
- On confirmation, the browser downloads a CSV file.
CSV File Details:
| Header | Field |
|---|---|
| Time | Session timestamp |
| Username | User identity |
| Msisdn | Mobile phone number |
| RadiusClient | NAS device name |
| LdapProfile | Directory profile name |
| Group | Group membership |
| Department | Department name |
Filename format: accounting_yyyyMMddHHmmss.csv
Field Reference
Section titled “Field Reference”| Field Name | Type | Required | Description |
|---|---|---|---|
| time | ZonedDateTime | Yes | Timestamp of the accounting event |
| username | String | Yes | Authenticated user identity |
| msisdn | String | Yes | Mobile phone number |
| radiusClientName | String | Yes | Name of the RADIUS client (NAS) |
| ldapProfileName | String | No | LDAP profile used for authentication |
| groupName | String | No | LDAP group membership |
| departmentName | String | No | Organizational department |
Actions
Section titled “Actions”Filter
Section titled “Filter”Purpose: Generate targeted accounting reports by restricting the data to specific criteria. Steps:
- Click the Filter icon.
- Set date range and any additional filters.
- Click Apply.
Result: Data grid and unique user count update to reflect the filtered dataset.
Export
Section titled “Export”Purpose: Download accounting data as a CSV file for offline analysis or compliance reporting. Prerequisites: At least one accounting record must match the current filter criteria. Steps:
- Click the Export (download) icon in the toolbar.
- Confirm the export in the dialog.
Result: A CSV file is downloaded to the browser with all matching accounting records.
Refresh
Section titled “Refresh”Purpose: Reload accounting data from the server. Steps: Click the Refresh (loop) icon in the toolbar. Result: Data grid and unique user count refresh with the latest data.
Common Use Cases
Section titled “Common Use Cases”Monthly User Activity Report
Section titled “Monthly User Activity Report”- Set the Start Date to the first day of the month and End Date to the last day.
- Review the unique user count for license compliance.
- Export to CSV for detailed analysis.
Department-Level Authentication Statistics
Section titled “Department-Level Authentication Statistics”- Filter by a specific Department using the multi-select filter.
- Review the total records and unique user count.
- Repeat for other departments or export each for comparison.
Identifying Unused RADIUS Clients
Section titled “Identifying Unused RADIUS Clients”- Set a broad date range (e.g., last 90 days).
- Compare the RADIUS Clients that appear in accounting data against your configured clients.
- Clients with no accounting entries may be candidates for decommissioning.
Troubleshooting
Section titled “Troubleshooting”| Issue | Possible Cause | Resolution |
|---|---|---|
| No accounting records | Date range too narrow | Expand the date range |
| Export downloads empty file | No records match filters | Verify filters and date range |
| LDAP Profile or Group shows empty | User authenticated via database, not LDAP | These fields are only populated for directory-authenticated users |
| Filter dropdown shows no options | No data exists for that filter dimension | Ensure accounting records exist for the selected time range |
Related Pages
Section titled “Related Pages”- Authentication Logs — View individual authentication events with detailed results
- RADIUS Sessions — Monitor active RADIUS accounting sessions in real-time
- RADIUS Clients — Manage the NAS devices that generate accounting records
- LDAP Profiles — Configure the directory profiles used for user authentication