R12.1-2025Jul03

Runbook-based Interactive Automation

NetBrain Runbook represents an automated workflow. It provides a visual way to codify a network troubleshooting process into an executable, reusable, and documentable workflow, to elevate collaboration efficiency. By leveraging Runbook, you can minimize the operations to create a troubleshooting flow. Besides, senior engineers can digitize their knowledge into a runbook template to streamline the best practices for the entire team.

Main UI Components

The main Runbook UI components are illustrated in the following diagram.


  • Runbook Process Pane: Displays the workflow diagram in a Runbook.
  • Runbook Result Pane: Displays the outputs of running the action nodes.
  • Runbook Custom Notes Pane: Centrally displays information, such as notes, descriptions, annotations, runbook document, runbook template document, and device qualification in a single pane.

Main User Flow

A major Runbook use flow is documenting the troubleshooting activity and process. The use flow includes the following steps:

  1. Execute troubleshooting actions on a map.
  2. Insert another Runbook template.
  3. Continue troubleshooting and annotating the analyst results.
  4. Save the current Runbook as a Runbook Template.

Another main use flow is to create a Runbook from a Runbook Template, run the Runbook and share the results within your team.  

Main Use Cases

The three primary scenarios of using a runbook are illustrated as follows:

Record Activities and Process

For example, end users run Qapps, execute CLI commands, or use Ping/Traceroute to troubleshoot a problematic area. These actions are instantly recorded in a personal runbook, and each action can be annotated with thoughts or analysis to document the diagnosis process.

Example: Execute a Runbook to Troubleshoot A/B Path Issue

Share Knowledge and Know-How

For example, to proactively take measures to resolve network problems that might re-occur, power users create a Runbook Template and continue to improve it, to share best practices and know-how with junior engineers.

Re-executable to Maximize Data Value

For example, Tier-1 engineers execute CLI commands to troubleshoot problematic devices on a map, document the diagnosis and escalate the issue by mentioning next-level users in the Runbook. Tier-2 engineers re-execute the Runbook, continue to add a Compare node to evaluate data changes between the two CLI outputs, and then escalate the issue to Tier-3. Each Tier can continue to build on top of what has been done previously by checking the analysis results and notes.

This chapter covers the following topics:

 


See also: