How to create devices and tasks
VoIP/SIP monitoring tasks create monitoring agents that connect to a specified VoIP server using the supplied credentials to ensure that the service is available. To accomplish this, SIP Monitoring is provisioned as either an extension or a client on the VoIP system and configured to call a specific number using a specified SIP server with certain parameters. The expected result of the call is set up as “Answer”, “No Answer”, “Busy”, or an error condition (if there is an unexpected result).
If an error is detected, SIP Monitoring records all properties of the error, which helps to pinpoint where the error condition is occurring. SIP Monitoring reports these error properties as Blobs of text accessible in online reports:
- SIP Final Response:408
- SIP Final Response Description: Request Timeout
- Media: False
- TimedOut: True
Creating a task
Once you have created a device and are adding or editing a SIP task, you will be prompted to adjust the following settings.
Enter the domain address or an IP address of a PBX or VoIP Service provider.
Enter the port number of the service you wish to check.
This field contains a SIP username (usually like “firstname.lastname@example.org”) in a source domain.
Completion Timeout (in seconds)
Enter the number of seconds the task should wait for a response from the web page before aborting the task and returning an error. If this is left blank the default timeout for a task is 120 seconds.
Specify whether the incoming server requires a secure connection using SSL or TLS.
Contains name used for an authentication session, it may match the username.
Contains a password for SIP authentication if it is required.
The name that will be displayed on the interface (according to RFC 3261).
When enabled a call will be performed.
Contains the destination phone number. If the number is located in another domain (belongs to another PBX) you may have to specify a number (name) and domain name in the following format: number(name)@destination_domain.com. Domains can be specified directly by their IP addresses.
Otherwise, you can enter the number directly as 15554441234.
This field contains the designation for the expected behavior of the called party.
SRTP is a security profile for RTP that adds confidentiality, message authentication, and replay protection to that protocol. It is specified in RFC 3711.
Note that you must at least perform a register or perform a call and you can perform both in the same task (as some systems may require you to register in order to perform a call).
The DNS Options feature allows users to choose how domain name server (DNS) requests are conducted during a monitoring task.
To specify the mode of resolving hostnames, in the DNS Resolve Mode section, select one of the available modes. For more details on the feature configuration, see DNS Mode Options.
The Custom DNS Hosts section contains the mappings of IP addresses to hostnames.
To specify the mapping, enter the IP address and the host name in the corresponding fields.