Reporting and Analytics
OPBX provides reporting tools to monitor call activity, analyze usage patterns, and manage active calls in real time.
Purpose
Use the reporting modules to:
- Review call detail records (CDR)
- Export call data to CSV
- Monitor active calls
- View aggregate statistics
note
Detailed documentation for CDR and live monitoring has moved to dedicated module pages:
- Call Logs — Call detail records, filters, and export
- Live Calls — Real-time call monitoring and disconnect
Available Reports
| Report | Location | Description |
|---|---|---|
| Call Detail Records | Call Logs in the sidebar | Complete call history from Cloudonix CDR webhooks |
| Live Calls | Live Calls in the sidebar | Real-time view of active sessions |
| Call Notifications Logs | Call Notifications settings | Webhook delivery audit log |
| Blocked Call Logs | Inbound Blacklist | Log of blocked inbound calls |
Aggregate Statistics
The CDR API provides aggregate metrics for the filtered dataset:
| Metric | Description |
|---|---|
| Total Calls | Number of calls in the selected period |
| Total Duration | Sum of all call durations |
| Total Billable Seconds | Sum of answered call durations |
| Average Duration | Mean call length |
| Total Cost | Sum of sell costs |
| By Disposition | Grouped counts by final disposition |
Exporting Data
To export CDR data:
- Go to Call Logs
- Apply filters
- Click Export
- The system streams a CSV export
tip
Large exports are processed in chunks of 1000 records to handle high-volume datasets.
Permissions
| Resource | Owner | PBX Admin | PBX User | Reporter |
|---|---|---|---|---|
| Call Logs | Yes | Yes | Own only | Yes |
| Live Calls | Yes | Yes | No | No |
| Statistics | Yes | Yes | Yes | Yes |
| Exports | Yes | Yes | Yes | Yes |
Related API Endpoints
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /v1/call-detail-records | List CDR records |
| GET | /v1/call-detail-records/{call_detail_record} | Show a CDR record |
| GET | /v1/call-detail-records/export | Export CDR to CSV |
| GET | /v1/call-detail-records/statistics | Aggregate statistics |
| GET | /v1/session-updates/active | List active calls |
| GET | /v1/session-updates/active/stats | Active call statistics |
| DELETE | /v1/session-updates/{sessionId}/disconnect | Disconnect an active call |
See the OPBX REST API reference for full schemas.
Best Practices
- Review CDR data weekly for unusual patterns
- Filter by disposition to find failed calls
- Export data for billing reconciliation
- Keep Live Calls open during peak hours
Related Modules
- Call Logs — Detailed CDR documentation
- Live Calls — Real-time monitoring documentation
- Call Notifications — Webhook event configuration