Capture rules: Difference between revisions

From VoIPmonitor.org
Jump to navigation Jump to search
No edit summary
No edit summary
 
Line 1: Line 1:
Capture rules allows the user to capture only certain calls to disk. It is typical not to save complete RTP packets to disk (or only RTP headers) and allow them to capture full RTP packets or Graphs or SIP signalization based on IP or number rules. You can also enable Script option which will run shell script - see [[Sniffer_configuration#filtercommand]]
== Capture Rules ==


The sniffer is loading rules on start and allows reloading rules without restarting the sniffer. Rules are not automatically reloaded once you made any change to it (click on green button in control panel "reload sniffer" to make changes active). If any of the sniffer reload fails it will throw error message.  
Capture rules allow selective recording of calls to disk based on IP addresses or phone numbers. Typically, RTP packets are not fully saved (or only headers are), but rules can enable full RTP, graphs, or SIP signaling capture. Rules can also trigger shell scripts (see [[Sniffer_configuration#filtercommand]]).


Some options have 3 state combo -  
The sniffer loads rules on startup and supports reloading without restart. Changes are not auto-reloaded; click the green "reload sniffer" button in the control panel to apply them. Failed reloads display an error.


*GLOBAL - the option is taking settings from global option in sniffer configuration. This is for case when you want to record SIP register for some IP addresses but you do not want to override global setting for RTP recording.
=== Rule Options ===
*ON - the option is enabled (enable RTP recording etc.)
*OFF - the option is disabled (disabling RTP recording etc.)


Skip option is for case you do not want to track some calls at all by the sniffer. Such calls are completely ignored by the sniffer (no files written to disk, no rtp analyze and no CDR)
Some options use a 3-state combo:


Auto remove at option deletes the rule at given date. This is useful for case you enable saving register messages and you want to delete the rule automatically after 3 days for example.  
* '''GLOBAL''': Inherits from global sniffer configuration (e.g., enable SIP REGISTER for specific IPs without overriding RTP settings).
* '''ON''': Enables the option (e.g., RTP recording).
* '''OFF''': Disables the option (e.g., no RTP recording).
 
* '''Skip''': Ignores calls entirely (no files, RTP analysis, or CDR).
* '''Auto remove at''': Deletes the rule on a specified date (e.g., auto-delete after 3 days for temporary REGISTER saving).


[[File:capturerules-ip.png]]
[[File:capturerules-ip.png]]


[[File:capturerules-tel.png]]
[[File:capturerules-tel.png]]
=== GUI Usage ===
Access via GUI control panel to create, edit, or reload rules. Use IP or TEL number filters for targeted capture.
=== AI Summary for RAG ===
'''Summary:''' This article explains VoIPmonitor's capture rules for selective call recording based on IP or numbers. It covers rule loading/reloading, 3-state options (GLOBAL/ON/OFF), skip/auto-remove features, and script integration.
'''Keywords:''' capture rules, selective recording, RTP packets, SIP signaling, sniffer reload, GLOBAL option, skip calls, auto-remove, filtercommand
'''Key Questions:'''
* How do capture rules work in VoIPmonitor?
* What are the 3-state options for rules?
* How do I reload rules without restarting the sniffer?
* What does the 'Skip' option do?
* How can I auto-delete a rule after a certain date?
* Can rules trigger external scripts?

Latest revision as of 13:47, 10 November 2025

Capture Rules

Capture rules allow selective recording of calls to disk based on IP addresses or phone numbers. Typically, RTP packets are not fully saved (or only headers are), but rules can enable full RTP, graphs, or SIP signaling capture. Rules can also trigger shell scripts (see Sniffer_configuration#filtercommand).

The sniffer loads rules on startup and supports reloading without restart. Changes are not auto-reloaded; click the green "reload sniffer" button in the control panel to apply them. Failed reloads display an error.

Rule Options

Some options use a 3-state combo:

  • GLOBAL: Inherits from global sniffer configuration (e.g., enable SIP REGISTER for specific IPs without overriding RTP settings).
  • ON: Enables the option (e.g., RTP recording).
  • OFF: Disables the option (e.g., no RTP recording).
  • Skip: Ignores calls entirely (no files, RTP analysis, or CDR).
  • Auto remove at: Deletes the rule on a specified date (e.g., auto-delete after 3 days for temporary REGISTER saving).

GUI Usage

Access via GUI control panel to create, edit, or reload rules. Use IP or TEL number filters for targeted capture.

AI Summary for RAG

Summary: This article explains VoIPmonitor's capture rules for selective call recording based on IP or numbers. It covers rule loading/reloading, 3-state options (GLOBAL/ON/OFF), skip/auto-remove features, and script integration.

Keywords: capture rules, selective recording, RTP packets, SIP signaling, sniffer reload, GLOBAL option, skip calls, auto-remove, filtercommand

Key Questions:

  • How do capture rules work in VoIPmonitor?
  • What are the 3-state options for rules?
  • How do I reload rules without restarting the sniffer?
  • What does the 'Skip' option do?
  • How can I auto-delete a rule after a certain date?
  • Can rules trigger external scripts?
Retrieved from "https://www.voipmonitor.org//doc/index.php?title=Capture_rules&oldid=5710"