Skip to main content

Reporting and Analytics

OPBX provides call detail records and real-time monitoring to help you track call activity and system performance.

Overview​

Reporting features include:

  • Call Logs (CDR) - Call detail records from Cloudonix
  • Live Calls - Real-time active call monitoring
  • Call Notifications - Webhook configuration for call events
  • Export - Download CDR data for analysis

Call Logs (CDR)​

What are Call Detail Records?​

Call Detail Records (CDR) are records received from Cloudonix at the end of each call. They contain:

  • Call duration and billable seconds
  • Call disposition (answered, busy, no answer, failed)
  • Caller and destination numbers
  • Call timestamps (start, answer, end)
  • Cost information (if available)
  • Raw CDR data from Cloudonix

Viewing Call Logs​

  1. Navigate to Call Logs in the sidebar
  2. View the list of call records
  3. Use filters to narrow results:
    • From number (caller)
    • To number (destination)
    • Date range
    • Disposition (answered, busy, etc.)

Call Log Details​

Each record shows:

  • Date/Time - When the call occurred
  • From - Caller number
  • To - Destination number
  • Duration - Total call duration in seconds
  • Billsec - Billable/connected duration
  • Disposition - Call outcome

Click on a record to view detailed information including the raw CDR data from Cloudonix.

Role-Based Access​

RoleAccess
OwnerAll calls
PBX AdminAll calls
PBX UserOnly calls involving their extension
ReporterAll calls (read-only)

Exporting CDR Data​

Export call records to CSV:

  1. Apply desired filters
  2. Click Export button
  3. Download the CSV file

The export includes:

  • Session timestamps
  • From/To numbers
  • Duration and billsec
  • Disposition
  • Raw CDR JSON data

Live Calls​

Overview​

Live Calls shows real-time active calls in your organization. This includes:

  • Currently ringing calls
  • Active (answered) calls
  • Call direction (incoming/outgoing)
  • Call duration

Viewing Live Calls​

  1. Navigate to Live Calls in the sidebar
  2. See all active calls in real-time

Refresh Options​

Configure how often the data refreshes:

  • No Refresh - Manual refresh only
  • 1 Second - Real-time updates
  • 5 Seconds - Recommended default
  • 15/30/60 Seconds - Less frequent updates
note

Live Calls uses WebSocket connections for real-time updates with HTTP polling fallback.

Call Information​

Each live call shows:

  • Caller ID - Who is calling
  • Destination - Where the call is going
  • Direction - Incoming or outgoing
  • Status - Ringing, answered, etc.
  • Duration - How long the call has been active

Disconnect Calls​

warning

This action is available to Owner and PBX Admin roles only.

To disconnect an active call:

  1. Find the call in the list
  2. Click Disconnect
  3. Confirm the action

Call Notifications​

Overview​

Call Notifications allow you to configure webhooks that receive call event notifications from OPBX. This enables integration with external systems.

Features​

  • Webhook URL - Your endpoint to receive notifications
  • Authentication - HMAC SHA256 or Basic Auth
  • Event Selection - Choose which call events to receive
  • Retry Logic - Automatic retry on failure
  • Rate Limiting - Configurable per-minute limits

Configuration​

  1. Navigate to Call Notifications in the sidebar
  2. Configure webhook settings:
    • Webhook URL - Your HTTPS endpoint
    • Auth Method - HMAC SHA256 or Basic Auth
    • Auth Secret - Secret for signature verification
    • Enabled Events - Select call events to receive
    • Retry Attempts - Number of retries (default: 3)
    • Rate Limit - Max notifications per minute (default: 500)

Available Events​

  • Call initiated
  • Call answered
  • Call ended
  • Session updates
  • CDR received

Notification Logs​

View delivery logs to debug webhook issues:

  • Delivery status (success/failed)
  • HTTP response codes
  • Request/response payloads
  • Retry attempts

Testing​

Send a test webhook to verify your endpoint:

  1. Configure settings
  2. Click Test Webhook
  3. Check your endpoint received the test event

Blocked Call Logs​

If you use the Inbound Blacklist feature:

  1. Go to Inbound Blacklist page
  2. View the Blocked Call Logs section
  3. See:
    • Blocked caller numbers
    • Date and time
    • Target DID number
    • Rejection strategy used

Statistics show:

  • Total blocked calls
  • Blocked today
  • Blocked this week
  • Most frequently blocked numbers

Troubleshooting​

Missing Call Data​

Problem: Calls not appearing in logs.

Solutions:

  1. Verify Cloudonix integration is configured
  2. Check CDR webhook is receiving data
  3. Wait for call to complete (CDRs are generated after call ends)
  4. Check date range filters

Live Calls Not Updating​

Problem: Live calls list is stale.

Solutions:

  1. Check refresh interval setting
  2. Verify WebSocket connection status
  3. Manually refresh the page
  4. Check browser console for errors

Webhook Not Receiving Notifications​

Problem: Call notifications not reaching your endpoint.

Solutions:

  1. Verify webhook URL is accessible
  2. Check authentication configuration
  3. Review notification logs for errors
  4. Ensure events are enabled
  5. Check rate limit status

Next Steps​

Related Documentation: