R12 Publication-2025July16

Create a Runbook

Action Nodes

A runbook consists of one or multiple action nodes. Each action node can be executed individually and repetitively to automate data analysis.



The following table lists the types of action nodes assembled in a runbook.

ActionDescription
Run QappRun a single Qapp to perform an automation task.
Overall Health MonitorRun a built-in Qapp to monitor your network health.
Run GappRun a group of contextualized Qapps for multistage troubleshooting.
Execute CLI CommandsRetrieve live data by executing CLI commands.
Retrieve Live DataRetrieve device data by executing CLI commands or selecting built-in data types, and save the data.
PingTest the connectivity from one endpoint to another,
TracerouteDiscover and map a routing path between two endpoints.
PathRefer to Mapping an A/B Path.
CompareCompare data changes between two different time points or between two versions of device data.
Ansible Task
Run an Ansible task to allow developers and IT operation teams to query information on multiple hosts or push bulk network configurations more easily and quickly.
Free TextAnnotate a text based on needs, such as describing the usage of each branch.
Data View TemplateRun a data view template to visualize concerned parser variables.
Verify ApplicationVerify A-B paths for key applications.
Network IntentDescribes a network design for a specific network device, what these design baselines are like, and how to verify the design works properly

Create a Runbook

Example: Create a runbook to troubleshoot issues on a traffic path, and escalate to admin.

  1. Click the  icon on the taskbar and select New Runbook.

  2. In the New Runbook dialog, enter a runbook name, and make a description. You can also select the Template check box to choose a template.
    Graphical user interface, text, application, email

Description automatically generated
  1. In the Start node, specify the required information.

    Information TIp: When you save the Runbook as a template, both device types and tags can be used to filter runbook templates.
  2. Add the Path action node.
    1. Click Actions or the icon, and then double-click Path.
    2. In the Path node, specify two endpoints, and click Path.
      Information Tip: To modify the node name, point to the node and click the  icon to select Rename.
    3. After the path is diagrammed on the map, click Note (0) to add a note. To mention a device, enter # and further select a device asset. A link will be generated for other users to quickly access the required information.
      Graphical user interface  Description automatically generated with medium confidence
  3. Add the Ping node and execute the action. Make a note to record the result.
    Graphical user interface, text, application  Description automatically generated
    Information Tip: To save an action node and its settings for reuse, point to the action node and click the  icon to select Set as Favorite.
  1. Add the Traceroute node and execute the action. Make a note to record the result.

  1. Add the Retrieve Live Data node, click the icon to load CLI commands via template, and then click Run.
    Graphical user interface, application  Description automatically generated

    Information Note: Click select data to obtain configurations and different types of tables for target devices.
    Graphical user interface, application, Word  Description automatically generated
  1. Add the Overall Health Monitor node, and then click Run. See Run a Qapp for more details. After running the Qapp, make a note to describe the issue and enter @ to mention admin for escalation.

    Information Note: You can click Document to view the runbook description, target device qualification, node information, etc.
  1. (Optional) Click the icon to share the runbook, or save it as a runbook template for reuse.