FQDN-resolved Session Agent Statistics
A SIP session agent can be configured with an FQDN in the hostname parameter. When the response to the DNS query for that hostname yields one or more IP addresses, the Oracle Communications Session Border Controller maintains these IP targets as all able to perform the role of the session agent object. The Oracle Communications Session Border Controller can report aggregate statistics of all IP targets that correspond to the session agent object and individual statistics per IP address (including per-method statistics) of each member of the last that the FQDN query returns. These statistics are available at the command line, via SNMP GETs, and via HDR. In addition, the Oracle Communications Session Border Controller can send traps if an individual IP target goes in or out of service.
Use the following syntax to retrieve statistics for each IP target that is returned in an FQDN query for a session agent:
show sipd agents <session-agent-name>#<destination-ip-address>
You may find the list of IP address returned for an FQDN at the bottom of the show sipd agents <agent name> query. In the screen capture below, a session agent is configured with sa1.dg.com FQDN in the hostname parameter. A DNS query returns IP addresses 192.168.26.2 and 192.168.26.3. By executing the show sipd agent sa1.dg.com to verify the IP routes that are used for this session agent. Their service states will also be listed. The statistics presented are the aggregate of all traffic/activity for the Oracle Communications Session Border Controller's transactions with 192.168.26.3 and 192.168.26.2.
ORACLE# show sipd agent sa1.dg.com
12:19:02-33
Session Agent sa1.dg.com(net192) [In Service]
-- Period -- -------- Lifetime --------
Active High Total Total PerMax High
Inbound Sessions 0 0 0 0 0 0
Rate Exceeded - - 0 0 0 -
Num Exceeded - - 0 0 0 -
Burst Rate 0 0 0 0 0 0
Reg Rate Exceeded - - 0 0 0 -
Reg Burst Rate 0 0 0 0 0 0
Outbound Sessions 0 0 0 0 0 0
Rate Exceeded - - 0 0 0 -
Num Exceeded - - 0 0 0 -
Burst Rate 0 0 0 0 0 0
Reg Rate Exceeded - - 0 0 0 -
Local Contacts 0 0 0 0 0 0
HNT Entries 0 0 0 0 0 0
Non-HNT Entries 0 0 0 0 0 0
Subscriptions 0 0 0 0 0 0
Out of Service - - 0 0 0 -
Trans Timeout 0 0 0 0 0 0
Requests Sent - - 2 20 2 -
Requests Complete - - 2 20 2 -
Seizure - - 0 0 0 -
Answer - - 0 0 0 -
ASR Exceeded - - 0 0 0 -
Messages Received - - 2 20 2 -
Latency=0.004; max=0.005
Destination: 192.168.26.3 In Service
Destination: 192.168.26.2 In Service
To retrieve an individual destinations statistics, use the show sipd agents command again and query on the session agent name, delimited with the pound character followed by the IP destination of note. The "Rate Exceeded", "Num Exceeded", "Reg Rate Exceeded" and "ASR Exceeded" counters are not be tracked and displayed for individual routes.
ORACLE# show sipd agent sa1.dg.com#192.168.26.2
12:19:18-49
Session Agent sa1.dg.com#192.168.26.2(net192) [In Service]
-- Period -- -------- Lifetime --------
Active High Total Total PerMax High
Inbound Sessions 0 0 0 0 0 0
Burst Rate 0 0 0 0 0 0
Reg Burst Rate 0 0 0 0 0 0
Outbound Sessions 0 0 0 0 0 0
Burst Rate 0 0 0 0 0 0
Local Contacts 0 0 0 0 0 0
HNT Entries 0 0 0 0 0 0
Non-HNT Entries 0 0 0 0 0 0
Subscriptions 0 0 0 0 0 0
Out of Service - - 0 0 0 -
Trans Timeout 0 0 0 0 0 0
Requests Sent - - 1 10 1 -
Requests Complete - - 1 10 1 -
Seizure - - 0 0 0 -
Answer - - 0 0 0 -
Messages Received - - 1 10 1 -
Latency=0.004; max=0.004
To retrieve an individual destination's statistics per SIP method, use the previously explained command followed by a space and the method you wish to query.
ORACLE# show sipd agent sa1.dg.com#192.168.26.2 OPTIONS
OPTIONS (12:19:28-59)
--------- Server -------- --------- Client --------
Message/Event Recent Total PerMax Recent Total PerMax
------ --------- ------ ------ --------- ------
OPTIONS Requests 0 0 0 1 10 1
Retransmissions 0 0 0 0 0 0
200 OK 0 0 0 1 10 1
Transaction Timeouts - - - 0 0 0
Locally Throttled - - - 0 0 0
Avg Latency=0.004 for 1
Max Latency=0.004
FQDN-resolved Session Agent Statistics Configuration
To configure FQDN-resolved Session Agent Statistics, you must add configuration to both the sip-config and session-agent configuration elements.
In the sip-config configuration element, set the sa-routes-stats parameter to enabled
ORACLE(configure)# exit
ORACLE# configure terminal
ORACLE(configure)# session-router
ORACLE(session-router)# sip-config
ORACLE(sip-config)# select
ORACLE(sip-config)# sa-routes-stats enabled
ORACLE(sip-config)# done
In the session-agent configuration element, set the ping-interval parameter to a value greater than 0, the ping-method to OPTIONS, and set the ping-all-addresses parameter to enabled.
ORACLE# configure terminal
ORACLE(configure)# session-router
ORACLE(session-router)# session-agent
ORACLE(session-agent)# sel
<hostname>:
1: hostname=sa1.dg.com
selection: 1
ORACLE(session-agent)# ping-interval 120
ORACLE(session-agent)# ping-all-addresses enabled
ORACLE(session-agent)# ping-method=OPTIONS
ORACLE(session-agent)# done
FQDN-resolved Session Agent Statistics SNMP Retrieval
When FQDN-resolved Session Agent Statistics are enabled, you can retrieve each IP target's session agent statistics via SNMP.
The apSipAgentTable returns a list of configured sessions agent with an index corresponding and configuration name. The mapping of index to configuration name is persistent across system reboot.
The index of the additional entries that correspond to the individual IP targets are identified by starting at 10000000. Because the IP targets that are retrieved from the DNS server may change on any DNS query, they are not persistent across a reboot. An snmpwalk query on asSIPAgentTable appears as:
SNMPv2-SMI::enterprises.9148.3.15.1.2.3.1.2.36 = STRING: "sa1.dg.com"
SNMPv2-SMI::enterprises.9148.3.15.1.2.3.1.210000000 = STRING: "sa1.dg.com#192.168.26.2"
SNMPv2-SMI::enterprises.9148.3.15.1.2.3.1.210000001 = STRING: "sa1.dg.com#192.168.26.3"
The following snmpwalk query on asSipSessionAgentStatsTable appears as:
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.1.36 = INTEGER: 36
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.1.10000000 = INTEGER: 1000000
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.1.10000001 = INTEGER: 1000001
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.2.36 = STRING: "sa1.dg.com"
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.2.10000000 = STRING: "sa1.dg.com#192.168.26.2"
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.2.10000001 = STRING: "sa1.dg.com#192.168.26.3"
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.3.36 = INTEGER: 1
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.3.10000000 = INTEGER: 1
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.3.1000001 = INTEGER: 1
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.4.36 = Gauge32: 0
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.4.10000000 = Gauge32: 0
SNMPv2-SMI::enterprises.9148.3.2.1.2.2.1.4.10000001 = Gauge32: 0
FQDN-resolved Session Agent Statistics SNMP Traps
The apSysMgmtSAStatusChangeTrap trap is generated when a session agent's individual IP target changes state. This requires that you enable the sa-routes-traps parameter in the sip-config.
FQDN-resolved Session Agent Statistics HDR Retrieval
When FQDN-resolved Session Agent Statistics are enabled, each IP target's session agent statistics are written to HDR output.
For the sa1.dg.com example that retrieved 2 IP targets, the following 3 lines of HDR output are typical:
1380106951,sa1.dg.com,sip,inService,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,2,4
1380106951,sa1.dg.com#192.168.26.3,sip,inService,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,2,4
1380106951,sa1.dg.com#192.168.26.2,sip,outOfService,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0
Note that the first entry is the aggregate of all individual targets.