Revision as of 18:00, 6 January 2026

Order of GeoIP Processing

This page documents the priority order in which VoIPmonitor processes GeoIP lookups to determine geographic location of IP addresses.

Processing Priority

VoIPmonitor uses a fallback mechanism for GeoIP lookups. The system attempts each method in order until a successful result is obtained:

Priority	Method	Description
1	MaxMind API	Commercial GeoIP service with high accuracy
2	IPInfoDB API	Alternative commercial GeoIP API
3	Local Database	Offline GeoIP database stored on the server
4	Free Portals	Fallback to free online GeoIP services

Configuration

GeoIP services are configured in:

GUI Path: Settings → System Configuration → GeoIP

💡 Tip: For best accuracy and reliability, configure the MaxMind API with a valid license key.

Related Pages

CountryGrouping - Country-based filtering and anti-fraud alerts
IP Groups - Creating IP address groups for filtering

AI Summary for RAG

Summary: Documents the priority order for GeoIP processing in VoIPmonitor. The system uses a fallback mechanism: (1) MaxMind API (highest priority), (2) IPInfoDB API, (3) Local Database, (4) Free Portals (lowest priority). Each method is tried in sequence until a successful country lookup is achieved. Configuration is done via GUI Settings → System Configuration → GeoIP.

Keywords: GeoIP, MaxMind, IPInfoDB, country lookup, IP geolocation, processing order, priority, fallback, local database

Key Questions:

What is the order of GeoIP processing in VoIPmonitor?
Which GeoIP service has highest priority?
Where do I configure GeoIP services in VoIPmonitor?
What happens if MaxMind API fails?
Does VoIPmonitor support local GeoIP database?

@@ Line 1: / Line 1: @@
+{{DISPLAYTITLE:Order of GeoIP Processing}}
 [[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 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.
+= Order of GeoIP Processing =
-You can open dashboard template with direct URL:
+This page documents the priority order in which VoIPmonitor processes GeoIP lookups to determine geographic location of IP addresses.
-<code>http://localhost/voipmon/admin.php?user=yourUser&password=yourPass&dashboard=Default&hidemenu=1</code>
+== Processing Priority ==
-[[File:dashboardv2.png|Dashboard default template]]
+VoIPmonitor uses a fallback mechanism for GeoIP lookups. The system attempts each method in order until a successful result is obtained:
-== Add panel ==
+<kroki lang="mermaid">
+%%{init: {'flowchart': {'nodeSpacing': 15, 'rankSpacing': 40}}}%%
+flowchart TB
+    A[IP Address] --> B{MaxMind API}
+    B -->|Success| Z[Return Country]
+    B -->|Fail| C{IPInfoDB API}
+    C -->|Success| Z
+    C -->|Fail| D{Local Database}
+    D -->|Success| Z
+    D -->|Fail| E{Free Portals}
+    E -->|Success| Z
+    E -->|Fail| F[Unknown]
+</kroki>
-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.
+{| class="wikitable"
+! Priority !! Method !! Description
+|-
+| 1 || '''MaxMind API''' || Commercial GeoIP service with high accuracy
+|-
+| 2 || '''IPInfoDB API''' || Alternative commercial GeoIP API
+|-
+| 3 || '''Local Database''' || Offline GeoIP database stored on the server
+|-
+| 4 || '''Free Portals''' || Fallback to free online GeoIP services
+|}
-== Panel types ==
+== Configuration ==
-When adding new panel you can choose between various panel types:
+GeoIP services are configured in:
+* '''GUI Path:''' Settings → System Configuration → GeoIP
-=== CDR charts ===
+{{Tip|1=For best accuracy and reliability, configure the MaxMind API with a valid license key.}}
-This is analogical to the [[Charts]] section.
+== Related Pages ==
-[[File:dashboardv2-cdrcharts.png|CDR charts]]
+* [[CountryGrouping]] - Country-based filtering and anti-fraud alerts
+* [[Groups#IP_Groups|IP Groups]] - Creating IP address groups for filtering
-=== 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 allows 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 are identical to Custom CDR grid - by SIP IP except the CDR rows are grouped by SIP responses instead of IP addresses. This is handful in case you need to see SIP responses numbers.
-[[File:dashboardv2-customcdrgridbyresponse.png|Custom CDR grid - by SIP response]]
-=== Register charts (beta) ===
-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
-Register charts require the SIP Register feature to be enabled. See [[Register]] for detailed configuration steps.
 == 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.
+'''Summary:''' Documents the priority order for GeoIP processing in VoIPmonitor. The system uses a fallback mechanism: (1) MaxMind API (highest priority), (2) IPInfoDB API, (3) Local Database, (4) Free Portals (lowest priority). Each method is tried in sequence until a successful country lookup is achieved. Configuration is done via GUI Settings → System Configuration → GeoIP.
-'''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
+'''Keywords:''' GeoIP, MaxMind, IPInfoDB, country lookup, IP geolocation, processing order, priority, fallback, local database
 '''Key Questions:'''
-* How do I create a custom dashboard in VoIPmonitor?
+* What is the order of GeoIP processing in VoIPmonitor?
-* What panel types are available in the Dashboard?
+* Which GeoIP service has highest priority?
-* How do I save a dashboard layout as a template?
+* Where do I configure GeoIP services in VoIPmonitor?
-* How do I access the dashboard via direct URL?
+* What happens if MaxMind API fails?
-* How do I add register charts to the dashboard?
+* Does VoIPmonitor support local GeoIP database?
-* 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?