Groups

Groups define reusable sets of IP addresses, telephone numbers, and emails for filtering CDRs, configuring alerts, and reports.

ℹ️ Note: After creating a new group, log out and log back in for it to appear in dropdown lists (CDR filters, alerts, charts).

Group Types

Type	Path	Use Cases
IP	Groups → IPs	SIP trunks, call direction classification, CDR filtering by IP
Tel. Numbers	Groups → Tel. numbers	Filter CDRs by caller/called, alert on number ranges
Emails	Groups → Emails	Recipients for alerts and reports

IP Groups

Define sets of IP addresses or CIDR ranges for filtering and classification.

Creating IP Groups

1. Navigate to Groups → IPs
2. Click "New group", enter name
3. Add IPs or CIDR ranges (one per line):

192.168.1.100
10.0.0.0/24
2001:db8::1/128

1. Configure checkboxes (see below)
2. Save

Checkbox Options

Checkbox	Purpose	When to Use
Trunk	Marks IPs as external carrier/provider	SIP trunk IPs from your VoIP provider
Server	Marks IPs as internal infrastructure	Your PBX, SBC, or media servers
SIP history group	Merges private/public IPs in SIP ladder view	NAT devices where signaling uses public IP but RTP uses private IP

Call Direction Classification

Using Trunk and Server checkboxes enables precise filtering:

Direction	Filter Logic
Outbound	callerIP in Server group AND calledIP in Trunk group
Inbound	callerIP in Trunk group AND calledIP in Server group
Internal	Both IPs in same group (or neither in any group)

SIP History Group for NAT

When a device behind NAT shows different IPs in signaling vs media:

• Public IP: 1.2.3.4 (in SIP headers)
• Private IP: 10.0.0.3 (actual device)

Create a group with both IPs and enable SIP history group checkbox. The GUI will consolidate duplicate flows into a single column in SIP ladder view.

Telephone Number Groups

Define sets of phone numbers or patterns for CDR filtering and alerts.

Creating Groups

Manual entry:

1. Navigate to Groups → Tel. numbers
2. Click "New group"
3. Add numbers one per line
4. Save

Import/Export (for large lists):

1. Click "import/export" button
2. Upload text file with one number per line

Regex Patterns

⚠️ Warning: Entries are literal strings by default. Wrap patterns with R(...) to enable regex.

Pattern	Description
R(^500[0-9]{4}$)	Match 7-digit numbers starting with 500
00))	International numbers (+ or 00 prefix)
R([a-zA-Z])	Numbers containing letters (malformed IDs)

Using in CDR Filters

1. Go to CDR view → Filter Form
2. In Group Filters section, select your group from Caller Groups or Called Groups
3. Click Search

💡 Tip: Changes to the group automatically apply to all filters using it.

Email Groups

Define recipient lists for alerts and reports.

1. Navigate to Groups → Emails
2. Click "New group"
3. Add email addresses (one per line)
4. Save

IP Anonymize Rewrite Rules

Replace original IPs with anonymized values in the database (GDPR compliance).

⚠️ Warning: Rules apply only to new data after saving. Existing records are not modified.

Configuration

Field	Description
IP to anonymize	Original IP or network to hide
Mask [0-32]	Source CIDR mask (32 = single IP, 24 = subnet)
Anonymous IP	Replacement IP stored in database
Mask [0-32]	Target mask (same as source = preserves host part)

Example: Map 192.168.1.x → 10.0.0.x (preserve host address):

Setting	Value
IP to anonymize	192.168.1.0
Mask	24
Anonymous IP	10.0.0.0
Mask	24

See Also

• Alerts - Using email groups for notifications
• Reports - Using groups in scheduled reports
• Call_Detail_Record_-_CDR - CDR filtering with groups

AI Summary for RAG

Summary: VoIPmonitor Groups feature for defining reusable sets of IP addresses, telephone numbers, and emails. IP groups support Trunk, Server, and SIP history group checkboxes for call direction classification (Outbound = callerIP in Server + calledIP in Trunk; Inbound = reverse) and NAT device consolidation in SIP ladder view. Telephone number groups support manual entry, import/export for large lists, and regex patterns with R(...) wrapper syntax. Email groups define recipients for alerts and reports. IP Anonymize Rewrite Rules enable GDPR-compliant IP masking for new data only. Important: log out and back in after creating groups for them to appear in dropdown lists.

Keywords: groups, IP groups, telephone numbers, email groups, SIP trunks, Trunk checkbox, Server checkbox, SIP history group, call direction, inbound, outbound, CDR filter, Caller Groups, Called Groups, regex patterns, R() wrapper, import export, IP anonymize, GDPR, NAT, SIP ladder, GUI refresh, login refresh

Key Questions:

• What types of groups are available in VoIPmonitor?
• How do I create an IP group for a SIP trunk?
• What is the Trunk checkbox and Server checkbox used for?
• How do I differentiate inbound and outbound calls?
• What is the SIP history group checkbox for NAT devices?
• How do I use regex patterns in telephone number groups?
• How do I import a large list of phone numbers?
• Why is my new group not visible in dropdown lists?
• How do I configure IP anonymization for GDPR?