Displaying the sample-history

The user can configure an LSP or template to enable or disable the sample recording indicating that the history of samples be recorded for that LSP or template. By default, the sample recording is disabled for an LSP. An option is provided in the show mpls lsp commands to display the auto-bandwidth history for the auto-bandwidth LSPs.

The samples are recorded for every adjustment-interval irrespective of whether an adjustment was done or not. For example, if the adjustment did not happen because of threshold is not being crossed or the mode is configured as monitor-only or auto-bandwidth is disabled globally or at the LSP level or when the LSP is itself disabled or the auto-bandwidth statistics are cleared, the sample history for that adjustment interval is displayed with the proper messages.

When the user wants to record the sample history for an LSP, complete the following steps.

  1. Enable the device for configuration.
    device>configure
  2. Enable the MPLS router.
    device(config)# router mpls
  3. Enable LSP configuration and select the target LSP. In this example, the selected LSP is LSP1.
    device(config-router-mpls)# lsp lsp1
  4. Enable auto-bandwidth.
    device(config-router-mpls-lsp-lsp1)# autobw
  5. Enable sample-recording.
    device(config-router-mpls-lsp-lsp1-autobw)# sample-recording enable

Example

The following example combines the steps above to enable sample-recording on LSP1.

device>configure
device(config)# router mpls
device(config-router-mpls)# lsp lsp1
device(config-router-mpls-lsp-lsp1)# autobw
device(config-router-mpls-lsp-lsp1-autobw)# sample-recording enable

Stop recording sample history

To stop recording sample history for an LSP, complete the following steps.

  1. Enable the device for configuration.
    device>configure
  2. Enable the MPLS router.
    device(config)# router mpls
  3. Enable LSP configuration and select the target LSP. In this example, the selected LSP is LSP1.
    device(config-router-mpls)# lsp lsp1
  4. Enable auto-bandwidth.
    device(config-router-mpls-lsp-lsp1)# autobw
  5. Disable sample-recording.
    device(config-router-mpls-lsp-lsp1-autobw)# sample-recording disable

Example

The following example combines the steps above to disable recorded sample history on LSP1.

device>configure
device(config)# router mpls
device(config-router-mpls)# lsp lsp1
device(config-router-mpls-lsp-lsp1)# autobw
device(config-router-mpls-lsp-lsp1-autobw)# sample-recording disable

To display the sample record, use the following command.

device# show mpls lsp autobw-samples

To clear all the recorded sample history, use the following command.

device# clear mpls auto-bandwidth-sample-history

The user may also wish to record the sample-history for certain period of time. The user is able to turn off and on the sample recording to capture the rate for those periods. In order completely delete the sample-history and turn off recording, the user is required to first turn off the sample-recording followed by clearing the sample history.