Skip to content

junos show-bgp-neighbor

Show overview of BGP information

Description

Show overview of BGP information

Synopsis

junos show-bgp-neighbor
    [--site <site>]
    [--cluster <cluster>]
    [<neighbor>]

Arguments

site - (string)

     Site where this command will be executed
     Example: --site "site-1"
     Default: input.site      Attributes: optional

cluster - (string)

     Name of junos device
     Example: --cluster "mx-1"
     Default: junos-default      Attributes: optional

neighbor - (string)

     Show the neighbor database for a particular neighbor
     Example: "10.100.1.2"
     Default: _None_      Attributes: optional

Examples

Input:

!junos show-bgp-neighbor "10.100.14.2"
Output:
Peer: 10.100.14.2+62371 AS 64544 Local: 10.100.14.1+179 AS 64500
  Description: to vMX4
  Group: EBGP-to-64544         Routing-Instance: master
  Forwarding routing-instance: master
  Type: External    State: Established    Flags: &lt;Sync&gt;
  Last State: OpenConfirm   Last Event: RecvKeepAlive
  Last Error: None
  Options: &lt;PeerAS Refresh&gt;
  Options: &lt;GracefulShutdownRcv&gt;
  Holdtime: 90 Preference: 170
  Graceful Shutdown Receiver local-preference: 0
  Number of flaps: 0
  Peer ID: 10.100.100.4    Local ID: 10.100.100.1      Active Holdtime: 90
  Keepalive Interval: 30         Group index: 0    Peer index: 0    SNMP index: 0
  I/O Session Thread: bgpio-0 State: Enabled
  BFD: disabled, down
  Local Interface: ge-0/0/2.0
  NLRI for restart configured on peer: inet-unicast
  NLRI advertised by peer: inet-unicast
  NLRI for this session: inet-unicast
  Peer supports Refresh capability (2)
  Stale routes from peer are kept for: 300
  Peer does not support Restarter functionality
  Restart flag received from the peer: Notification
  NLRI that restart is negotiated for: inet-unicast
  NLRI of received end-of-rib markers: inet-unicast
  NLRI of all end-of-rib markers sent: inet-unicast
  Peer does not support LLGR Restarter functionality
  Peer supports 4 byte AS extension (peer-as 64544)
  Peer does not support Addpath
  Table inet.0 Bit: 20000
    RIB State: BGP restart is complete
    Send state: in sync
    Active prefixes:              0
    Received prefixes:            0
    Accepted prefixes:            0
    Suppressed due to damping:    0
    Advertised prefixes:          0
  Last traffic (seconds): Received 16   Sent 2    Checked 15545
  Input messages:  Total 577    Updates 1   Refreshes 0 Octets 11011
  Output messages: Total 574    Updates 0   Refreshes 0 Octets 10910
  Output Queue[1]: 0            (inet.0, inet-unicast)
Input:
x = !junos show-bgp-neighbor "10.100.14.2"
Output:
{
    "bgp-information": [
        {
            "bgp-peer": [
                {
                    "attributes": {
                        "junos:style": "detail"
                    },
                    "peer-address": [
                        {
                            "data": "10.100.14.2+62371"
                        }
                    ],
                    "peer-as": [
                        {
                            "data": "64544"
                        }
                    ],
                    "local-address": [
                        {
                            "data": "10.100.14.1+179"
                        }
                    ],
                    "local-as": [
                        {
                            "data": "64500"
                        }
                    ],
                    "description": [
                        {
                            "data": "to vMX4"
                        }
                    ],
                    "peer-group": [
                        {
                            "data": "EBGP-to-64544"
                        }
                    ],
                    "peer-cfg-rti": [
                        {
                            "data": "master"
                        }
                    ],
                    "peer-fwd-rti": [
                        {
                            "data": "master"
                        }
                    ],
                    "peer-type": [
                        {
                            "data": "External"
                        }
                    ],
                    "peer-state": [
                        {
                            "data": "Established"
                        }
                    ],
                    "peer-flags": [
                        {
                            "data": "Sync"
                        }
                    ],
                    "rsync-flags": [
                        {}
                    ],
                    "last-state": [
                        {
                            "data": "OpenConfirm"
                        }
                    ],
                    "last-event": [
                        {
                            "data": "RecvKeepAlive"
                        }
                    ],
                    "last-error": [
                        {
                            "data": "None"
                        }
                    ],
                    "bgp-option-information": [
                        {
                            "attributes": {
                                "xmlns": "http://xml.juniper.net/junos/21.1R0/junos-routing"
                            },
                            "bgp-options": [
                                {
                                    "data": "PeerAS Refresh"
                                }
                            ],
                            "bgp-options2": [
                                {}
                            ],
                            "bgp-options-extended": [
                                {
                                    "data": "GracefulShutdownRcv"
                                }
                            ],
                            "holdtime": [
                                {
                                    "data": "90"
                                }
                            ],
                            "preference": [
                                {
                                    "data": "170"
                                }
                            ],
                            "gshut-recv-local-preference": [
                                {
                                    "data": "0"
                                }
                            ]
                        }
                    ],
                    "flap-count": [
                        {
                            "data": "0"
                        }
                    ],
                    "peer-id": [
                        {
                            "data": "10.100.100.4"
                        }
                    ],
                    "local-id": [
                        {
                            "data": "10.100.100.1"
                        }
                    ],
                    "active-holdtime": [
                        {
                            "data": "90"
                        }
                    ],
                    "keepalive-interval": [
                        {
                            "data": "30"
                        }
                    ],
                    "group-index": [
                        {
                            "data": "0"
                        }
                    ],
                    "peer-index": [
                        {
                            "data": "0"
                        }
                    ],
                    "snmp-index": [
                        {
                            "data": "0"
                        }
                    ],
                    "bgp-peer-iosession": [
                        {
                            "iosession-thread-name": [
                                {
                                    "data": "bgpio-0"
                                }
                            ],
                            "iosession-state": [
                                {
                                    "data": "Enabled"
                                }
                            ]
                        }
                    ],
                    "bgp-bfd": [
                        {
                            "bfd-configuration-state": [
                                {
                                    "data": "disabled"
                                }
                            ],
                            "bfd-operational-state": [
                                {
                                    "data": "down"
                                }
                            ]
                        }
                    ],
                    "local-interface-name": [
                        {
                            "data": "ge-0/0/2.0"
                        }
                    ],
                    "local-interface-index": [
                        {
                            "data": "545"
                        }
                    ],
                    "peer-restart-nlri-configured": [
                        {
                            "data": "inet-unicast"
                        }
                    ],
                    "nlri-type-peer": [
                        {
                            "data": "inet-unicast"
                        }
                    ],
                    "nlri-type-session": [
                        {
                            "data": "inet-unicast"
                        }
                    ],
                    "peer-refresh-capability": [
                        {
                            "data": "2"
                        }
                    ],
                    "peer-stale-route-time-configured": [
                        {
                            "data": "300"
                        }
                    ],
                    "peer-no-restart": [
                        {
                            "data": [null]
                        }
                    ],
                    "peer-restart-flags-received": [
                        {
                            "data": "Notification"
                        }
                    ],
                    "peer-restart-nlri-negotiated": [
                        {
                            "data": "inet-unicast"
                        }
                    ],
                    "peer-end-of-rib-received": [
                        {
                            "data": "inet-unicast"
                        }
                    ],
                    "peer-end-of-rib-sent": [
                        {
                            "data": "inet-unicast"
                        }
                    ],
                    "peer-end-of-rib-scheduled": [
                        {}
                    ],
                    "peer-no-llgr-restarter": [
                        {
                            "data": [null]
                        }
                    ],
                    "peer-4byte-as-capability-advertised": [
                        {
                            "data": "64544"
                        }
                    ],
                    "peer-addpath-not-supported": [
                        {
                            "data": [null]
                        }
                    ],
                    "bgp-rib": [
                        {
                            "attributes": {
                                "junos:style": "detail"
                            },
                            "name": [
                                {
                                    "data": "inet.0"
                                }
                            ],
                            "rib-bit": [
                                {
                                    "data": "20000"
                                }
                            ],
                            "bgp-rib-state": [
                                {
                                    "data": "BGP restart is complete"
                                }
                            ],
                            "send-state": [
                                {
                                    "data": "in sync"
                                }
                            ],
                            "active-prefix-count": [
                                {
                                    "data": "0"
                                }
                            ],
                            "received-prefix-count": [
                                {
                                    "data": "0"
                                }
                            ],
                            "accepted-prefix-count": [
                                {
                                    "data": "0"
                                }
                            ],
                            "suppressed-prefix-count": [
                                {
                                    "data": "0"
                                }
                            ],
                            "advertised-prefix-count": [
                                {
                                    "data": "0"
                                }
                            ]
                        }
                    ],
                    "last-received": [
                        {
                            "data": "3"
                        }
                    ],
                    "last-sent": [
                        {
                            "data": "15"
                        }
                    ],
                    "last-checked": [
                        {
                            "data": "15613"
                        }
                    ],
                    "input-messages": [
                        {
                            "data": "580"
                        }
                    ],
                    "input-updates": [
                        {
                            "data": "1"
                        }
                    ],
                    "input-refreshes": [
                        {
                            "data": "0"
                        }
                    ],
                    "input-octets": [
                        {
                            "data": "11068"
                        }
                    ],
                    "output-messages": [
                        {
                            "data": "577"
                        }
                    ],
                    "output-updates": [
                        {
                            "data": "0"
                        }
                    ],
                    "output-refreshes": [
                        {
                            "data": "0"
                        }
                    ],
                    "output-octets": [
                        {
                            "data": "10967"
                        }
                    ],
                    "bgp-output-queue": [
                        {
                            "number": [
                                {
                                    "data": "1"
                                }
                            ],
                            "count": [
                                {
                                    "data": "0"
                                }
                            ],
                            "table-name": [
                                {
                                    "data": "inet.0"
                                }
                            ],
                            "rib-adv-nlri": [
                                {
                                    "data": "inet-unicast"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

Access Control

To use this command, you need access to the following:

Field Value
Action "read"
Service Type "junos"
Service Instance
Namespace
Object Type "bgp"
Object ID

Please see Access Control for details.