show services pgcp gate
Syntax
Release Information
Command introduced in Junos OS Release 9.5.
statistics option introduced in Junos OS Release 9.1.
session-mirroring option introduced in Junos OS Release 9.2.
gateway option introduced in Junos OS Release 9.5.
master option introduced in Junos OS Release 9.6
backup option introduced in Junos OS Release 9.6
Description
Display in-depth information about a Packet Gateway Control Protocol (PGCP) gate.
Options
- gateway gateway-name
(Optional) Display information about gates associated with this virtual border gateway function (BGF).
- gate-id gate-id
(Optional) Display information about a particular gate.
- brief
(Optional) Display brief output.
- extensive
(Optional) Display extensive output.
- session-mirroring
(Optional) Display the session mirroring information for gates that are being mirrored. You must have a login with sufficient permission to view session mirroring information. The set system login class class-name permissions pgcp-session-mirroring command grants this permission.
- statistics
(Optional) Display statistics for gates.
- master
(Optional) Display information for the backup services PIC. This option applies if you are running the virtual BGF on a services PIC or MS-DPC, and you have a primary and backup PIC configured on a virtual redundant MultiServices PIC (rms) interface.
- backup
(Optional) Display information for the Routing Engine or primary services PIC. If the virtual BGF is running on the Routing Engine, gate information for the routing engine is displayed. If the virtual BGF is running on a services PIC, gate information the primary services PIC is displayed. If you do not specify the master or backup options, the master option is the default.
Required Privilege Level
view
pgcp-session-mirroring—To view session mirroring fields.
Related Topics
List of Sample Output
show services pgcp gateshow services pgcp gate extensive
show services pgcp gate statistics
show services pgcp gate session-mirroring
Output Fields
Table 1 lists the output fields for the show services pgcp gate command. Output fields are listed in the approximate order in which they appear.
Table 1: show services pgcp gate Output Fields
Field Name | Field Description | Output Level |
|---|---|---|
Gate information | Information about the gate. | brief, extensive |
Direction | Direction of the gate. | brief, extensive |
State | State of the gate:
| brief, extensive |
remote source address | IP address of the remote source of the gate. | brief, extensive |
remote source port | Port of the remote source of the gate. | brief, extensive |
remote dest address | IP address of the remote destination of the gate. | brief, extensive |
remote dest port | Port of the remote destination of the gate. | brief, extensive |
local source address | IP address of the local source of the gate. | brief, extensive |
local source port | Port of the local source of the gate. | brief, extensive |
local dest address | IP address of the local destination of the gate. | brief, extensive |
local dest port | Port of the local destination of the gate. | brief, extensive |
transport | Transport protocol. | brief, extensive |
gate version | Numeric identifier for the version of the gate. | brief, extensive |
latch | Latch status:
| brief, extensive |
yellow action | Action to take in this state. | brief, extensive |
red action | Action to take in this state. | brief, extensive |
notifications | Number of notifications. | brief, extensive |
User Data | Numeric identifier for the user data. | brief, extensive |
Transport | H.248 media descriptor field:
| extensive |
RTCP | Additional (shadow) gate allocated for the Real-Time Control Protocol (RTCP): auto or off. | extensive |
Latch | State of the latch action on the gate:
| extensive |
DSCP | DiffServ code point (DSCP) marking value for the gate. | extensive |
Policing | Status of policing on the gate:
| extensive |
Fast update filter | Status of the fast update filter:
| extensive |
Gate Statistics | Statistics for the specific gate. | statistics |
Output Packets | Number of output packets from the PIC. | statistics |
Input Packets | The number of PIC input packets plus the number of packets that the Packet Forwarding Engine dropped because they did not conform to rate limits. | statistics |
Dropped Packets | Number of packets that the Packet Forwarding Engine and the PIC dropped because they did not conform to rate limits. | statistics |
Lost RTP Packets | Number of RTP packets that have been lost on this gate. | statistics |
Fractional lost RTP Packets | The fraction of RTP data packets that the remote side lost. The fraction is expressed as a percentage value. | statistics |
RTCP Statistics | RTCP statistics for packets sent and received. | statistics |
RTCP Sender Statistics | RTCP statistics for the sending endpoint. | statistics |
SSRC | Synchronization source ID for the sending endpoint. | statistics |
Sender Octets | Number of octets sent. | statistics |
Sender Packets | Number of packets sent. | statistics |
Invalid Packets | Number of invalid packets. | statistics |
RTCP Receiver Statistics | Statistics for the endpoint receiving the RTCP packets. | statistics |
SSRC | Synchronization source ID for the receiving endpoint. | statistics |
Lost packets | The number of RTP data packets that the remote side lost
in the current transmission. | statistics |
Lost fraction | The fraction (percentage) of RTP data packets that the remote side lost in the current transmission. | statistics |
Jitter | An estimate of the statistical variance of the RTP data packet interarrival time. The jitter is measured in the units of the RTP timestamp and represents the mean deviation of the difference in packet spacing at the receiver compared to the sender for a pair of packets. | statistics |
Received RTCP-XR Statistics: | Statistics on RTCP packets sent and received. | statistics |
Packet loss concealment | Method of packet loss concealment:
| statistics |
Loss Rate | The fraction of RTP data packets from the source lost since the beginning of reception. | statistics |
Discard Rate | The fraction of RTP data packets from the source that have been discarded since the beginning of reception. | statistics |
Round Trip Delay | The most recent round-trip time between interfaces, in milliseconds. | statistics |
End System Delay | The most recently estimated end system delay, expressed in milliseconds. | statistics |
Signal Level | The voice signal relative level shown as the ratio of the signal level to dBm0. | statistics |
Noise Level | The ratio of the silent period background noise level to dBm0. | statistics |
RERL | The residual echo return loss value expressed as an integer in the range from 0 to 100 dB. A value of 94 corresponds to "toll quality", and values of 50 or less are regarded as unusable. This metric includes the effects of delay. | statistics |
R Factor | A voice quality metric describing the segment of the call that is carried over this RTP session expressed as an integer in the range from 0 to 100 dB. A value of 94 corresponds to "toll quality", and values of 50 or less are regarded as unusable. This metric includes the effects of delay. A value of 127 indicates that this parameter is unavailable. | statistics |
Ext. R Factor | The external R factor is a voice quality metric describing the segment of the call that is carried over a network segment external to the RTP segment, such as a cellular network. Its values are interpreted in the same manner as for the RTPR factor. This metric includes the effects of delay and relates to the outward voice path from the VoIP termination for which this metrics block applies. | statistics |
MOS-LQ | The estimated mean opinion score for listening quality (MOS-LQ) is a voice quality metric on a scale from 1 to 5, in which 5 represents excellent and 1 represents unacceptable. It includes the effects of delay and other effects that would affect listening quality. | statistics |
MOS-CQ | The estimated mean opinion score for conversational quality (MOS-CQ) is a voice quality metric on a scale from 1 to 5, in which 5 represents excellent and 1 represents unacceptable. It includes the effects of delay and other effects that would affect conversational quality. | statistics |
Received RTCP Burst Metrics Statistics | This section provides statistics for burst metrics received from the far end of the RTCP session. | statistics |
Minimum Gap Threshold | This field contains the value used for this report block to determine if a gap exists. The recommended value of 16 corresponds to a burst period having a minimum density of 6.25 percent of lost or discarded packets, which may cause noticeable degradation in call quality. During gap periods defined with a threshold of 16, each lost or discarded packet is preceded by and followed by a sequence of at least 16 received non-discarded packets. | statistics |
Burst Density | The fraction of RTP data packets within burst periods since the beginning of reception that were either lost or discarded. | statistics |
Burst Duration | The mean duration of the burst periods that have occurred since the beginning of reception, in milliseconds. | statistics |
Gap Loss Density | The fraction of RTP data packets within inter-burst gaps since the beginning of reception that were either lost or discarded. | statistics |
Gap Duration | The mean duration of the gap periods that have occurred since the beginning of reception, in milliseconds. | statistics |
Gate Measured Rate | Current gate throughput measured in bytes per second. | statistics |
Rate-Limiting Statistics | Counter showing data traffic statistics based on the TRTC (two-rate-three-colors) policer. | statistics |
FUF statistics | The number of dropped packets when the Fast Update Filter was enabled on the gate. | statistics |
Drop count | The number of packets dropped by the data PIC. | statistics |
Session mirroring status | Status of session mirroring:
| session mirroring |
Session mirroring correlation number | Indicates whether the data mirrors are encrypted. | session mirroring |
Session mirroring target ID list | One or more targets of the mirrored packets. | session mirroring |
Session mirroring direction | Direction of session mirroring:
| session mirroring |
Sample Output
show services pgcp gate
user@host> show services pgcp gate gateway pg1
gate-id 4295033088Gate information: Direction: A->B State: active remote source address: 3.0.0.101 remote source port: * remote dest address: 4.0.0.102 remote dest port: 5060 local source address: - local source port: - local dest address: 3.99.99.100 local dest port: 5060 transport: udp gate version: 00 latch: none yellow action: forward red action: drop notifications: 64 User Data: 0001102000000000
show services pgcp gate extensive
user@host> show services pgcp gate gateway pg1
gate-id 2817498611968 extensiveGate information: ================ Gate id: 2817498611968 Gate state: active Direction: A->B Action: drop Remote source address: * Remote source port: * Remote destination address: 3.0.0.102 Remote destination port: 20000 Local source address: [20.50.150.1] Local source port: [2334] Local destination address: 10.50.150.1 Local destination port: 2334 Transport: rtp/avp RTCP: On Latch: none DSCP: 0x40 (Effective 16) Policing: Off Fast update filter: Off
show services pgcp gate statistics
user@host> show services pgcp gate gateway pg1
gate-id 98784313601 statistics
Gate Statistics:
================
Output packets: 0
Input packets: 0
Dropped packets: 0
Lost RTP packets: 0
Fractional lost RTP packets: 0
RTCP statistics:
================
RTCP Sender statistics:
SSRC : 122598409 Sender octets: 268632 Sender packets: 1599
Invalid packets: 0
RTCP Receiver statistics:
SSRC: 14479 Lost packets: 0 Lost fraction: 0.00
Jitter: 0
Received RTCP-XR Statistics:
Packet Loss Concealment: 0 Loss Rate: 0 Discard Rate: 0
Round Trip Delay: 0 End System Delay: 0 Signal Level: 0
Noise Level: 0 RERL: 0 R Factor: 0
Ext. R Factor: 0 MOS-LQ: 0 MOS-CQ: 0
Received RTCP Burst Metrics Statistics:
Minimum Gap Threshold: 0 Burst Density: 0 Burst Duration: 0
Gap loss Density: 0 Gap Duration: 0
Gate measured rate: 0
Rate limiting statistics:
Mark Color Number of Packets Number of Bytes
Green 205 41000
Yellow 0 0
Red 0 0
FUF statistics:
Drop count: 0
show services pgcp gate session-mirroring
user@host> show services pgcp gate gateway pg1
gate-id 4295033088 session-mirroringGate information: Gate id: 4295033088 Session mirroring status: On Session mirroring correlation number: 0x8040c020a060e010 Session mirroring target ID list: [008040c0, ffffff80] Session mirroring direction: Egress
