This module writes SIP traffic and some associated details into local files. It intercepts automatically all the SIP traffic received or sent by Kamailio and provides a function to trigger storage from configuration file. Received traffic has the tag 'rcv' and the one to be sent has the tag 'snd'. The tag value is provided as parameter for the config function. Besides the SIP packets, the module aims to save details related to Kamailio runtime environment that are useful for troubleshooting, like process id, child rank, a.s.o. The module should be useful for troubleshooting during development or testing of new deployments, especially when dealing with traffic over TLS with forward privacy, when other tools such as wireshark cannot decrypt. For production environments with a lot of SIP traffic, look at siptrace and sipcapture modules for a scalable alternative to capture all the SIP traffic and then search using Homer Sipcapture web toolkit.
| Parámetro | Tipo | Descripción |
|---|---|---|
| enable | int | 3.2. mode (int) 3.3. wait (int) 3.4. wait_mode (int) 3.5. rotate (int) 3.6. folder (str) 3.7. fprefix (str) 3.8. fage (int) 3.9. fagex (str) 3.10. event_callback (str) |
| mode | int | 3.3. wait (int) 3.4. wait_mode (int) 3.5. rotate (int) 3.6. folder (str) 3.7. fprefix (str) 3.8. fage (int) 3.9. fagex (str) 3.10. event_callback (str) |
| wait | int | 3.4. wait_mode (int) 3.5. rotate (int) 3.6. folder (str) 3.7. fprefix (str) 3.8. fage (int) 3.9. fagex (str) 3.10. event_callback (str) |
| wait_mode | int | 3.5. rotate (int) 3.6. folder (str) 3.7. fprefix (str) 3.8. fage (int) 3.9. fagex (str) 3.10. event_callback (str) |
| rotate | int | 3.6. folder (str) 3.7. fprefix (str) 3.8. fage (int) 3.9. fagex (str) 3.10. event_callback (str) |
| folder | str | 3.7. fprefix (str) 3.8. fage (int) 3.9. fagex (str) 3.10. event_callback (str) |
| fprefix | str | 3.8. fage (int) 3.9. fagex (str) 3.10. event_callback (str) |
| fage | int | 3.9. fagex (str) 3.10. event_callback (str) |
| fagex | str | 3.10. event_callback (str) |
| event_callback | str | 3.1. enable (int) |
| enable | int | Enable sipdump activity. |
| mode | int | Set the type of activity done by the module, the value can be set based on flags index: 0 (value 1) - write to text files; 1 (value 2) - execute event route; 2 (value 4) - write to pcap files; 3 (valu |
| wait | int | Wait time (microseconds) when no SIP traffic is received (for wait_time = 0). |
| wait_mode | int | If set to 1, the module uses a pthread mutex and contion to signal when SIP messages are available to the writer process. It should use less CPU when idle (on no SIP traffic) than the default polling |
| rotate | int | Time interval in seconds to rotate files. |
| folder | str | Path to the folder where to save the files. |
| fprefix | str | File name prefix. The date is appended to this prefix in the format yyyy-mm-dd--hh-mm-ss. The extension of the text file is ".data", of the meta file is ".meta" and of the pcap file is ".pcap". |
| fage | int | Age of created files (in seconds) to be removed if they become older. Cleanup is done on a timer routine running every 600 seconds. |
| fagex | str | Age as a time expression for the created files to be removed if they become older. It overwrites the 'fage' parameter. The value can be numbers followed by time units: d - days; h - hours; m - minutes |
| event_callback | str | Name of the KEMI function to be executed instead of the event route. |
4.1. sipdump_send(tag)
Send the details of the current SIP message to the writer process and get it stored in the file.
Copyright © 2017 asipto.com
