Session Agent and Session Agent Group Faults
This section explains how to view fault information about SIP and H.323 session agents and session agent groups.
SIP Agent Statistics
You can use the following commands to view SIP agent statistics:
- show sipd agents
- show sipd agents <agent ID>
Viewing SIP Session Agent Statistics
Display SIP session agent information by using the show sipd agents command. With this command, the Oracle Communications Session Border Controller ascertains whether a session agent is in service. When the session agent stops responding to SIP requests, it transitions to the out-of-service state. You can configure the Oracle Communications Session Border Controller to periodically ping the session agent if it has gone out-of-service, or if no requests have been sent to it.
The show sipd agents command shows information about the number of active sessions, the average rate of session invitations, and the number of times that the constraints established in the session-agent element have been exceeded for sessions inbound to and outbound from each session agent, as well as the average and maximum latency and the maximum burst rate related to each session agent.
For example:
ORACLE# show sipd agents
19:39:34-95
---- Inbound ---- --- Outbound --- -Latency- --- Max ---
Session Agent Active Rate ConEx Active Rate ConEx Avg Max Burst In Out
192.168.200.131 0 0.0 0 0 0.0 0 0.0 0.0 0 0 0Inbound statistics:
- Active: number of active sessions sent from each session agent listed
- Rate: average rate of session invitations (per second) sent to each session agent listed
- ConEx: number of times the constraints have been exceeded
Outbound statistics:
- Active: number of active sessions sent to each session agent
- Rate: average rate of session invitations (per second) sent from each session agent listed
- ConEx: number of times the constraints have been exceeded
Latency statistics:
- Avg: average latency for packets traveling to and from each session agent listed
- Max: maximum latency for packets traveling to and from each session agent listed
- Max Burst: total number of session invitations sent to or received from the session agent within the amount of time configured for the burst rate window of the session agent
The second column, which is not labeled, of the show sipd agents output shows the service state of each session agent identified in the first column. In the service state column, an I indicates that the particular session agent is in service and an O indicates that the particular session agent is out of service. An S indicates that the session agent is transitioning from the out-of-service state to the in-service state; it remains in this transitional state for a period of time that is equal to its configured in-service period, or 100 milliseconds (whichever is greater). A D indicates that the session agent is disabled.
Resetting Session Agent Statistics
Reset a specific session agent’s statistics by using the reset session-agent <hostname> command.
For example:
ORACLE# reset session-agent agent2
Accepted
Reset SA failover timerViewing SIP Session Agent Activity
Display a specific session agent’s activity by using the show sipd <agent ID> command.
For example:
acmepacket# show sipd agent 69.69.69.22
19:32:17-47
Session Agent 172.16.0.10(sip172) [In Service]
-- Period -- -------- Lifetime --------
Active High Total Total PerMax High
Inbound Sessions 0 0 0 234666 92 168
Rate Exceeded - - 0 0 0 -
Num Exceeded - - 0 0 0 -
Reg Rate Exceeded - - 0 0 0 -
Outbound Sessions 0 0 0 239762 126 200
Rate Exceeded - - 0 0 0 -
Num Exceeded - - 0 0 0 -
Reg Rate Exceeded - - 0 0 0 -
Out of Service - - 0 0 0 -
Trans Timeout 40928 40928 400 40928 800 40928
Requests Sent - - 400 519695 780 -
Requests Complete - - 0 478367 574 -
Seizure - - 0 239762 126 -
Answer - - 0 234661 93 -
ASR Exceeded - - 0 0 0 -
Messages Received - - 0 1431343 1415 -
Latency=0.000; max=0.000Inbound sessions:
- Rate Exceeded: number of times session or burst rate was exceeded for inbound sessions
- Num Exceeded: number of times time constraints were exceeded for inbound sessions
Outbound sessions:
- Rate Exceeded: number of times session or burst rate was exceeded for outbound sessions
- Num Exceeded: number of times time constraints were exceeded for inbound sessions
- Burst: number of times burst rate was exceeded for this session agent
- Out of Service: number of times this session agent went out of service
- Trans Timeout: number of transactions timed out for this session agent
- Requests Sent: number of requests sent via this session agent
- Requests Complete: number of requests that have been completed for this session agent
- Messages Received: number of messages received by this session agent
SIP Session Agent Group Statistics
You can use the following commands to display SIP agent group statistics:
- show sipd groups
- show sipd groups -v
- show sipd groups <group name>
Viewing Session Agent Group Statistics
Display session information for the session agent groups on the system by using the show sipd groups command. This information is compiled by totaling the session agent statistics for all of the session agents that make up a particular session agent group.
The Active column of the session agent group statistics output displays the first character of the session agent group state. The session agent group statistics can be in one of the following states.
- D—Disabled
- O—Out Of Service
- S—Standby
- I—In Service
- C—Constraints Exceeded
- N—This status code is Obsolete
- O—OOS Provisioned Response
- R—Reduction In Call Load. The group's sampled R-factor value (VoIP quality) is less than the configured qos-constraints, major-rfactor value. The group remains in this state until the SA's time-to-resume value expires.
While the show sipd groups command accesses the subcommands that are described in this section, the main show sipd groups command (when executed with no arguments) displays a list of all session agent groups for the system.
For example:
ORACLE# show sipd groups
11:00:21-16
----- Inbound ----- ----- Outbound ------ - Latency -
SAG Active Rate ConEx Active Rate ConEx Avg Max
recursion 0 0.0 0 1 0.1 0 0.005 0.005 2If you carry out this command, but you do not specify the name of an existing session agent group, the system will inform you that the group statistics are not available.
Viewing List of SIP Session Agents in a Group
List the session agents that make up the session agent group, along with statistics for each by using the show sipd groups -v command. The -v (verbose) option must be included with this command to provide this level of detail.
For example:
ORACLE# show sipd groups -v
SAG: recursion
11:00:07-32
----- Inbound ----- ----- Outbound ------ -- Latency --
Session Agent Active Rate ConEx Active Rate ConEx Avg Max
150.150.150.16 0 0.0 0 0 0.0 0 0.005 0.005 1
SAG: recursion
150.150.150.35 0 0.0 0 1 0.0 0 0.000 0.000 1
Totals:
recursion 0 0.0 0 1 0.8 0 0.005 0.005 2Viewing Statistics for a SIP Session Agent
Display statistics for a specific session agent group by using the show sipd groups <group name> command.
For example:
ORACLE# show sipd groups recursion
11:00:28-23
----- Inbound ----- ----- Outbound ------ -- Latency --
SAG Active Rate ConEx Active Rate ConEx Avg Max
recursion 0 0.0 0 0 0.0 0 0.005 0.005 2Session Agent and Session Router Constraint Statistics
Oracle Communications Session Border Controller’s support for session constraints is applicable not only to the system when configured for dialog-stateful or for session-stateful mode, but also when it operates in proxy (transaction or stateless) mode.
Notes on Statistics
When it runs in transaction mode, the Oracle Communications Session Border Controller counts INVITE transactions for calculating session agent statistics that are used to apply session agent constraints. The following describes how the Oracle Communications Session Border Controller performs its count:
- For calculating the max-burst-rate and the max-inbound-burst-rate, the Oracle Communications Session Border Controller counts the server transaction created when it receives an INVITE request.
- For calculating the max-outbound-burst-rate, the Oracle Communications Session Border Controller counts the client transaction when it sends an INVITE request to a session agent.
- The Oracle Communications Session Border Controller counts each INVITE transaction, except for in-dialog re-INVITE transactions. It detects in-dialog re-INVITE requests by checking the To tag.
- The Oracle Communications Session Border Controller does not count retransmitted INVITE requests, which it can detect.
Example 1 Statistics from Transaction Mode
This section shows sample output from the ACLI show sipd agents command. The sections that do not apply to transaction mode appear in italics.
ORACLE# show sipd agents acme5
11:08:18-46
Session Agent acme5(private) [In Service]
-- Period -- -------- Lifetime --------
Active High Total Total PerMax High
Inbound Sessions 22 22 22 22 22 22
Rate Exceeded - - 0 0 0 -
Num Exceeded - - 0 0 0 -
Burst Rate 0 19 0 0 0 19
Reg Rate Exceeded - - 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 -
Out of Service - - 0 0 0 -
Trans Timeout 0 0 0 0 0 0
Requests Sent - - 0 0 0 -
Requests Complete - - 0 0 0 -
Seizure - - 0 0 0 -
Answer - - 0 0 0 -
ASR Exceeded - - 0 0 0 -
Messages Received - - 65 65 65 -
Latency=0.000; max=0.000Example 1 Statistics from Stateless Mode
This section shows sample output from the ACLI show sipd agents command. The sections that do not apply to stateless mode appear in italics.
acmesystem# show sipd agents uni
12:11:17-51
Session Agent uni(public) [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 -
Outbound Sessions 0 1 11 11 11 1
Rate Exceeded - - 0 0 0 -
Num Exceeded - - 0 0 0 -
Burst Rate 0 11 0 0 0 11
Reg Rate Exceeded - - 0 0 0 -
Out of Service - - 0 0 0 -
Trans Timeout 0 0 0 0 0 0
Requests Sent - - 0 0 0 -
Requests Complete - - 0 0 0 -
Seizure - - 0 0 0 -
Answer - - 0 0 0 -
ASR Exceeded - - 0 0 0 -
Messages Received - - 30 30 30 -
Latency=0.000; max=0.000H.323 Session Agent Statistics
Display H.323 session agent information by using the following commands:
- show h323d agentlist
- show h323d agentconfig
- show h323d agentstats
Viewing H.323 Session Agent List
Display a list of session agents by using the show h323d agentlist command. For example:
ORACLE# show h323d agentlist
H323-Session Agent List
hostname 192.168.200.20
hostname 192.168.200.30
hostname 10.10.10.3Viewing Session Agent Configuration Statistics
Display information about the session agent configuration by using the show h323d agentconfig command. For example:
ORACLE(session-agent)# show h323 agentconfig
session-agent
hostname testhostname.com
ip-address 192.168.200.13
port 5060
state enabled
app-protocol SIP
app-type H323-GW
transport-method UDP
realm-id h323192
description
carriers
allow-next-hop-lp enabled
constraints disabled
max-sessions 0
max-inbound-sessions 4
max-outbound-sessions 5
max-burst-rate 0
max-inbound-burst-rate 10
max-outbound-burst-rate 1
max-sustain-rate 0
max-inbound-sustain-rate 0
max-outbound-sustain-rate 0
min-seizures 5
min-asr 0
time-to-resume 0
ttr-no-response 0
in-service-period 0
burst-rate-window 0
sustain-rate-window 0
req-uri-carrier-mode None
proxy-mode Redirect
redirect-action
loose-routing enabled
send-media-session enabled
response-map
ping-method
ping-interval 0
ping-in-service-response-codes
out-service-response-codes
media-profiles
in-translationid
out-translationid
trust-me disabled
request-uri-headers
stop-recurse
local-response-map
ping-to-user-part
ping-from-user-part
li-trust-me disabled
in-manipulationid
out-manipulationid
p-asserted-id
trunk-group
tgname1:tgcontext1
tgname2:tgcontext2
max-register-sustain-rate 0
early-media-allow
invalidate-registrations disabled
rfc2833-mode none
rfc2833-payload 0
codec-policy
last-modified-date 2007-03-29 17:15:50
task doneViewing H.323 Session Agent Statistics
Display statistics about the session agent by using the show h323d agentstats command. For example:
ORACLE# show h323d agentstats
19:38:59-30
---- Inbound ---- --- Outbound ---- -Latency- --- Max ---
Session Agent Active Rate ConEx Active Rate ConEx Avg Max Burst In Out
192.168.1.15 0 0.0 0 0 0.0 0 0.0 0.0 0 0 0
192.168.1.6 0 0.0 0 0 0.0 0 0.0 0.0 0 0 0H.323 Session Agent Group Statistics
You can use the following commands to view H.323 session agent group statistics:
- show h323d grouplist
- show h323d groupconfig
- show h323d groupstats
Viewing List of H.323 Session Agent Groups
Display a list of session agent groups by using the show h323d grouplist command. For example:
ORACLE# show h323d grouplist
H323-Session Agent Group List
group-name h323
session-agent
hostname testhostname.com
ip-address
port 5060
state enabled
app-protocol SIP
app-type
transport-method UDP
realm-id
description
carriers
allow-next-hop-lp enabled
constraints disabled
max-sessions 0
max-inbound-sessions 4
max-outbound-sessions 5
max-burst-rate 0
max-inbound-burst-rate 10
max-outbound-burst-rate 1
max-sustain-rate 0
max-inbound-sustain-rate 0
max-outbound-sustain-rate 0
min-seizures 5
min-asr 0
time-to-resume 0
ttr-no-response 0
in-service-period 0
burst-rate-window 0
sustain-rate-window 0
req-uri-carrier-mode None
proxy-mode
redirect-action
loose-routing enabled
send-media-session enabled
response-map
ping-method
ping-interval 0
ping-in-service-response-codes
out-service-response-codes
media-profiles
in-translationid
out-translationid
trust-me disabled
request-uri-headers
stop-recurse
local-response-map
ping-to-user-part
ping-from-user-part
li-trust-me disabled
in-manipulationid
out-manipulationid
p-asserted-id
trunk-group
tgname1:tgcontext1
tgname2:tgcontext2
max-register-sustain-rate 0
early-media-allow
invalidate-registrations disabled
rfc2833-mode none
rfc2833-payload 0
codec-policy
last-modified-date 2007-03-29 17:15:50Viewing H.323 Session Agent Group Configuration Statistics
Display information about the session agent group configuration by using the show h323d groupconfig command. For example:
ORACLE# show h323d groupconfig
session-group
group-name h323
description
state enabled
app-protocol H323
strategy Hunt
dest
172.16.0.13
1.1.1.1
trunk-group
last-modified-date 2006-07-11 19:12:22Viewing H.323 Session Agent Group Statistics
Display statistics about the session agent group by using the show h323d grouptstats command. For example:
ORACLE# show h323d groupstats
19:38:59-30
---- Inbound ---- --- Outbound ---- -Latency- --- Max ---
SAG Active Rate ConEx Active Rate ConEx Avg Max Burst In Out
H323Group 0 0.0 0 0 0.0 0 0.0 0.0 0 0 0