Dashboardv2: Difference between revisions

From VoIPmonitor.org
No edit summary
(Add: Export panel data to CSV functionality)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Dashboard allows placing panels with various types of data which can be refreshed on regular basis. The main purpose of this feature is to have realtime overview on the whole system or part of it. You can create your own panel layout templates and load them whenever you need them. Each user can create his own layouts which will be visible only to him or admin can creates global layouts visible for all users.  
{{DISPLAYTITLE:Dashboard}}
[[Category:Configuration]]
 
= Dashboard =
 
Dashboard allows placing panels with various types of data which can be refreshed on regular basis. The main purpose of this feature is to have a real-time overview of the whole system or part of it. You can create your own panel layout templates and load them whenever you need them. Each user can create their own layouts which will be visible only to them, or an admin can create global layouts visible to all users.
 
== Direct URL Access ==
 
You can open a dashboard template with a direct URL:
 
<syntaxhighlight lang="text">
http://localhost/voipmon/admin.php?user=yourUser&password=yourPass&dashboard=Default&hidemenu=1
</syntaxhighlight>


[[File:dashboardv2.png|Dashboard default template]]
[[File:dashboardv2.png|Dashboard default template]]


= Add panel =  
== Adding Panels ==
 
You can add as many panels as you can fit to the main layout window. Panel features:
 
* '''Resize and move:''' Panels can be resized and moved freely
* '''Lock/Unlock:''' Prevents accidental moving or resizing
* '''Save as template:''' Click "save" button and provide a name. If you choose an existing name, you will be asked to replace the old one
* '''Remove all panels:''' Clears the current layout
* '''Hide menu:''' Maximizes the layout by hiding the left menu


You can add as many panels as you can fit to the main layout window. The panel can be resized and moved. The panel can be locked or unlocked so you cannot move or resize them. Current layout can be saved as template by clicking on "save" button providing name of the template. If you choose existing name of a previously created panel you will be asked if you want to replace the old one. Panels on current layout can be deleted at once by clicking on "remove all panels" button. When you click on "hide menu" the current layout will hide the left menu and current layout will have maximized size.
== Panel Types ==


= Panel types =
When adding a new panel, you can choose between various panel types:


When adding new panel you can choose between various panel types
=== CDR Charts ===


== CDR charts ==
This is analogical to the [[Charts]] section.


This is analogical to the [[Charts]] section.
[[File:dashboardv2-cdrcharts.png|CDR charts]]


== SIP responses (pie chart) ==
=== SIP Responses (Pie Chart) ===


[[File:dashboardv2-piechart.png|SIP responses pie chart]]
[[File:dashboardv2-piechart.png|SIP responses pie chart]]
=== Top IP Addresses ===
[[File:dashboardv2-topip.png|Top IP addresses]]
=== Custom CDR Grid - by SIP IP ===
Custom grids allow you to see total numbers of CDR grouped by source IP or destination IP and configure custom columns like MOS, Loss, Delay, etc. You can also choose which column will be sorted by default.
[[File:dashboardv2-customcdrform.png|Custom CDR grid - form]]
[[File:dashboardv2-customcdrgridbyip.png|Custom CDR grid - by SIP IP]]
=== Custom CDR Grid - by SIP Response ===
Custom CDR grid by SIP responses is identical to Custom CDR grid - by SIP IP except the CDR rows are grouped by SIP responses instead of IP addresses. This is useful when you need to see SIP response numbers.
[[File:dashboardv2-customcdrgridbyresponse.png|Custom CDR grid - by SIP response]]
=== Register Charts (Beta) ===
{{Note|This feature is in beta. Requires the SIP Register feature to be enabled. See [[Register]] for detailed configuration steps.}}
This panel type visualizes SIP registration statistics on the dashboard. You can display various registration metrics including successful registrations, failed registrations, and registration states.
'''To create a dashboard with register charts:'''
# Navigate to '''GUI > Dashboard''' view
# Click "new" or "create" to create a new dashboard
# Select a desired layout for the dashboard
# For each new panel, choose the panel type "Register charts beta" from the dropdown menu
# After creating the panel, edit its settings to select a template or specific register series to display
== Exporting Panel Data ==
Raw data from any dashboard panel can be exported to CSV for use in external tools like Grafana.
'''To export panel data to CSV:'''
# Navigate to '''GUI > Dashboard''' and open the desired dashboard
# Ensure the dashboard is saved (click the '''Save''' button if changes were made)
# Hover over the panel from which you need the data
# Click the export icon (link symbol)
# Select '''Link to CSV''' from the menu to download the raw data points
This exports all raw data points displayed in the panel to a CSV file, which can be imported into Grafana or other analysis tools.
== AI Summary for RAG ==
'''Summary:''' The Dashboard feature provides a customizable real-time monitoring interface with multiple panel types. Users can create personal layouts or admins can create global templates visible to all users. Available panel types include: CDR charts (similar to Charts section), SIP responses pie chart, Top IP addresses, Custom CDR grids grouped by SIP IP or SIP response (with configurable columns for MOS, Loss, Delay), and Register charts (beta) for SIP registration statistics. Panels can be resized, moved, locked/unlocked, and saved as templates. Direct URL access is supported with parameters for user authentication, dashboard name, and menu hiding.
'''Keywords:''' dashboard, panels, real-time monitoring, CDR charts, SIP responses, pie chart, top IP, custom grid, MOS, Loss, Delay, register charts, layout templates, global layouts, user layouts, hidemenu
'''Key Questions:'''
* How do I create a custom dashboard in VoIPmonitor?
* What panel types are available in the Dashboard?
* How do I save a dashboard layout as a template?
* How do I access the dashboard via direct URL?
* How do I add register charts to the dashboard?
* Can I create a dashboard visible to all users?
* How do I display MOS/Loss/Delay metrics on the dashboard?
* How do I group CDR data by SIP response on the dashboard?

Latest revision as of 10:46, 9 January 2026


Dashboard

Dashboard allows placing panels with various types of data which can be refreshed on regular basis. The main purpose of this feature is to have a real-time overview of the whole system or part of it. You can create your own panel layout templates and load them whenever you need them. Each user can create their own layouts which will be visible only to them, or an admin can create global layouts visible to all users.

Direct URL Access

You can open a dashboard template with a direct URL:

http://localhost/voipmon/admin.php?user=yourUser&password=yourPass&dashboard=Default&hidemenu=1

Dashboard default template

Adding Panels

You can add as many panels as you can fit to the main layout window. Panel features:

  • Resize and move: Panels can be resized and moved freely
  • Lock/Unlock: Prevents accidental moving or resizing
  • Save as template: Click "save" button and provide a name. If you choose an existing name, you will be asked to replace the old one
  • Remove all panels: Clears the current layout
  • Hide menu: Maximizes the layout by hiding the left menu

Panel Types

When adding a new panel, you can choose between various panel types:

CDR Charts

This is analogical to the Charts section.

CDR charts

SIP Responses (Pie Chart)

SIP responses pie chart

Top IP Addresses

Top IP addresses

Custom CDR Grid - by SIP IP

Custom grids allow you to see total numbers of CDR grouped by source IP or destination IP and configure custom columns like MOS, Loss, Delay, etc. You can also choose which column will be sorted by default.

Custom CDR grid - form

Custom CDR grid - by SIP IP

Custom CDR Grid - by SIP Response

Custom CDR grid by SIP responses is identical to Custom CDR grid - by SIP IP except the CDR rows are grouped by SIP responses instead of IP addresses. This is useful when you need to see SIP response numbers.

Custom CDR grid - by SIP response

Register Charts (Beta)

ℹ️ Note: This feature is in beta. Requires the SIP Register feature to be enabled. See Register for detailed configuration steps.

This panel type visualizes SIP registration statistics on the dashboard. You can display various registration metrics including successful registrations, failed registrations, and registration states.

To create a dashboard with register charts:

  1. Navigate to GUI > Dashboard view
  2. Click "new" or "create" to create a new dashboard
  3. Select a desired layout for the dashboard
  4. For each new panel, choose the panel type "Register charts beta" from the dropdown menu
  5. After creating the panel, edit its settings to select a template or specific register series to display

Exporting Panel Data

Raw data from any dashboard panel can be exported to CSV for use in external tools like Grafana.

To export panel data to CSV:

  1. Navigate to GUI > Dashboard and open the desired dashboard
  2. Ensure the dashboard is saved (click the Save button if changes were made)
  3. Hover over the panel from which you need the data
  4. Click the export icon (link symbol)
  5. Select Link to CSV from the menu to download the raw data points

This exports all raw data points displayed in the panel to a CSV file, which can be imported into Grafana or other analysis tools.


AI Summary for RAG

Summary: The Dashboard feature provides a customizable real-time monitoring interface with multiple panel types. Users can create personal layouts or admins can create global templates visible to all users. Available panel types include: CDR charts (similar to Charts section), SIP responses pie chart, Top IP addresses, Custom CDR grids grouped by SIP IP or SIP response (with configurable columns for MOS, Loss, Delay), and Register charts (beta) for SIP registration statistics. Panels can be resized, moved, locked/unlocked, and saved as templates. Direct URL access is supported with parameters for user authentication, dashboard name, and menu hiding.

Keywords: dashboard, panels, real-time monitoring, CDR charts, SIP responses, pie chart, top IP, custom grid, MOS, Loss, Delay, register charts, layout templates, global layouts, user layouts, hidemenu

Key Questions:

  • How do I create a custom dashboard in VoIPmonitor?
  • What panel types are available in the Dashboard?
  • How do I save a dashboard layout as a template?
  • How do I access the dashboard via direct URL?
  • How do I add register charts to the dashboard?
  • Can I create a dashboard visible to all users?
  • How do I display MOS/Loss/Delay metrics on the dashboard?
  • How do I group CDR data by SIP response on the dashboard?