Skip to content

BGP Plugin

Jump to bottom
Jacob van Walraven edited this page Jan 13, 2020 · 5 revisions

The BGP plugin monitors BGP sessions and generates results when; new sessions are detected, session timeouts are detected and when sessions are closed.

A session_start result is generated when a new BGP session is started and both parties have sent a BGP open message.

A session_timeout result is generated when no BGP keepalive or update messages have been seen for the hold times set within the BGP open message.

A session_close result is generated when a BGP notification message is seen.

Example session result

Each of the generated results contain the following fields:

  • type - (session_start, session_timeout, session_close)
  • session_id - Unique ID to identify this BGP session.
  • source_asn - The AS number of the organisation who established the session.
  • destination_asn - The AS number of the receiving organisation.
  • source_identifier - The BGP identifier of the device that established the BGP session.
  • destination_identifier - The BGP identifer of the receiving device.
  • source_hold_time - The hold time of the device that established the BGP session.
  • destination_hold_time - The hold time of receiving device.
  • source_ip - The IP address of the device that established the BGP session.
  • destination_ip - The IP address of the receiving device.

BGP statistics

It is also possible to output BGP statistics at periodic intervals which include:

  • session_starts - The number of BGP sessions started since the last report.
  • session_timeouts - The number of BGP sessions timed out since the last report.
  • session_closes - The number of BGP sessions closed since the last report.
  • active_sessions - The number of active BGP sessions. This is enabled via the statistics option within the configuration file.

Configuration example:

  # BGP module
  bgp:
    enabled: 1
    # how often to check for timed out BGP sessions (absence of update/keep alive messages
    # for the hold time (seconds).
    timeout_check: 5
    # generate and export statistics every X seconds (timeout_check determines interval)
    statistics: 1

Configuration options

enabled

Used to enabled or disable the BGP plugin (0 disabled, 1 enabled).

timeout_check

How often to check (seconds) for timed out BGP sessions. A session is determined to have timed out when a keepalive or update message has not been seen for the BGP sessions hold time.

statistics

Generate and export statistics every X seconds (timeout_check determines interval).

Clone this wiki locally