Skip to content

Extract Data from Signaling Packets

The processed SIP signaling packets are stored in the database for troubleshooting and post-processing. The signaling packets are shown on the "Full call details" page.

Extract Data from Signaling Packets

The "Extract Data from Signaling Packets" job can be used to extract the values from the SIP signaling packets into custom fields. For example, with Oracle SBC, it is possible to add custom headers into the XML metadata of SIPREC INVITE. MiaRec can extract those headers.

Create the job

Navigate to Administration > Automatic Actions > Send Recordings via Email and click Add to create a new job.

Extract Data from Signaling Packets New Job

Fill out the required configuration parameters:

Job Settings

  • Name - give the job a distinctive name.
  • Access Scope - specify for which tenants this job applies. This setting is visible only for a multi-tenant environment.
  • Mode. Full or incremental export mode.
    • Full - will tag the recordings every time the job is started.
    • Incremental - remembers which records have been already processed and do not process them on the next start.

Action

Under the Action section, check the following settings:

  • REGEX pattern - The REGEX pattern for defining the values from SIP signaling packets.
  • Translation rule - The translation rule identification for defining the values from SIP signaling packets.
  • Extract into custom field - define the percentage of the randomly-selected recordings the action will be applied to. This option may be useful when you need randomly evaluate the recordings of a specific user.

Condition

The job supports filtering criteria to limit what call recordings are processed. For example, you may configure the job for a specific group of users only.

Condition

Action After Successful Processing

Optionally, you can clear/assign a tag once the recording is processed. With this capability, you can create a chain of post-processing, and mark it with relevant flags. For example, you can transcribe the recordings and mark them with a relevant tag. Then, you can email the recordings with this tag. And once the recordings are sent via email, you tell the system to clear the tag from the recordings.

Action After Successful Processing

Job advanced settings

Please also check the following advanced settings for the job:

  • Log file - select this check box to write a detailed log for diagnostic purposes.
  • Keep job history - specify the number of days to keep the successful job history. Default value: 60.
  • Timezone - allows you to change the timezone of a scheduled job. Timezone affects the scheduler, date/time attribute in Filtering Criteria, and Filename Format. Leave this attribute empty to use a system default timezone.
  • Execution time limit - a job will be aborted if it executes longer than the specified time limit (in minutes). Leave this attribute empty to use a default value. Default value: <not defined>.
  • Keep alive timeout - specify a timeout (in minutes) to terminate the job. Leave this attribute empty to use a default value. Default value: 15.
  • Email notification on completion - activates the notification by email about successful job execution. You can trigger the email notification either every time the job completes successfully or for the first of any consecutive completion message.
  • Email notification on failure - activates the notification by email about failed job execution. You can trigger the email notification either every time the job fails or for the first of any consecutive failure message.
  • Email notification address - specify the email address for notifications. Use a comma to separate multiple email addresses.

Info

Note, it is necessary to configure "Web portal URL" under Administration -> System -> Advanced Settings, otherwise, the URL links to job details in the email will be invalid. Also, make sure the email integration is enabled under Administration > System > Email Integration.

Job Advanced Settings

Schedule

The job may be started manually or automatically by schedule. The schedule may be configured to run the job every hour/day/week/month. Also, you can set up a custom interval by selecting the Custom (crontab) option.

Please check some examples on how to configure a custom interval:

  • Run the job every 5 minutes.

Run the job every 5 minutes

  • Run the job on 5-th minute of every hour (i.e. 00:05; 01:05; 02:05 and so on).

Run the job on 5-th minute of every hour

  • Run the job on 15-th and 45-th minute of every hour (i.e. 00:15; 00:45; 01:15, 01:45 and so on).

Run the job on 15-th minute of every hour

  • Run the job every hour, on the hour, from 8 AM through 5 PM.

Run the job every hour