Runbooks
On this page
Introduction
The use of runbooks is available to Premier package customers.
Runbooks document processes in an automated workflow. In SolarWinds Service Desk (SWSD) these runbooks help to structure the naturally unstructured process of incident resolution by documenting best practices established by experts or experienced agents. Runbooks are centrally stored.
The ability to create runbooks is role-based. Users with administrator access to Setup > Service Desk can create runbooks.
Agents can attach runbooks to incident tickets to show the troubleshooting and resolution process, and that information can be used by other agents for future similar issues.
Navigation
ITSM customers | ESM customers |
---|---|
Setup > Service Desk > Runbooks |
Service Provider > Service Desk > Runbooks |
Runbooks index table
The Runbooks index page contains a list of all your organization's runbooks. You can see that each runbook is assigned a number. Numbers are assigned consecutively as new runbooks are created. To filter the click, click Edit View. For more information, see List viewand Filtering options.
Columns
Columns available on the Runbook table are:
- Number. The number assigned to the runbook when it was created.
- Title. The name created for the runbook when it was created.
- Scope. The object the runbook is scoped to.
- Updated at. The date the last edit was made to the runbook.
- Last used. The last time the runbook was attached and run.
- Updated by. The name of the individual who last edited the runbook.
- Description. A description of the runbook added by the creator.
- Active toggle. The toggle that makes the runbook available (or unavailable) for use in an incident.
- Ellipsis options. Hovering over the far right end of the record displays an ellipsis that offers editing options. When the ellipsis is clicked the user can delete or clone the runbook.
Filtering options
The Runbooks table can be filtered on the following fields:
- Name (text-based field)
- Scope (dropdown list of all objects that use runbooks)
- Creator (user list)
- Last run (custom date, last day, 7, 14, 21, or 30 days)
- Active (Yes or No field)
Runbook features and limitations
- Each incident can have only one runbook.
- Runbooks cannot start on their own. They can only be started and stopped with user interaction.
- When a runbook process is stopped, the process returns to its beginning.
- A runbook midstream in its process cannot be replaced unless it is stopped first.
- Runbooks can be assigned or attached via APIs.
- All runbook-related actions are documented in the audit log.
Runbook creation
-
From the Runbook index table, click
in the upper right corner.
-
Provide a title and description (required).
-
On the Inputs bar, click
and then proceed through the screen prompts to add a field.
-
Under the Process bar, click
to add a process. For more information on adding a process, see Configure service catalog: process.
Edit an existing runbook
-
From the Runbook index table, click the link to the runbook you want to edit.
-
In the Edit Runbook dialog, make changes as needed.
You can edit process steps by clicking to the right of the process name and then clicking the pencil icon to edit or clicking the Replace Step icon to change the step to a different action type. You can also copy to clipboard or delete. -
When finished, click Update.
Delete a runbook
-
From the Runbooks index page scroll to the far right of the runbook and hovering over the pop-up ellipsis. Click the ellipsis, and then select Delete.
Attach a runbook to an incident
To attach an existing runbook to an incident ticket:
-
Open the incident ticket.
-
Click the Process tab.
-
Click
.
-
Use the search feature to locate the appropriate runbook and then select it.
If appropriate, you can select the checkbox on the right to start the runbook after it is added.
-
Click Add Runbook in the lower right corner.
Run a runbook on an incident
From an open incident ticket, select the Process tab, and then click Start Process to the right of the runbook.
At any time you can click Stop the Process to return to the beginning of the process.
You can delete a runbook, but you must first stop any inflight process.