Skip to main content

Create a Custom Runbook

Overview

Custom Runbooks in Motadata AIOps offer a flexible solution for executing specialized actions on monitors, utilizing user-defined settings and scripts. This type of Runbook is particularly useful in scenarios where predefined Runbook templates (such as SSH, HTTP, etc.) are not applicable or sufficient. Custom Runbooks allow IT professionals to define their own scripts and parameters, ensuring that specific, non-standardized actions can be automated and executed efficiently within the IT environment.

Go to Menu, Select Settings . After that, Go to Plugin Library . Select Runbook. The Runbook screen is now displayed.

Select to start creating a Runbook. Select Custom to create a Custom Runbook.

Custom Runbook Configuration

The Custom Runbook creation screen presents various parameters to define the Runbook's functionality and assign it to monitors or groups. Here’s a detailed breakdown of each parameter:

FieldDescription
Runbook NameAssign a logical and unique name that identifies the task performed by the runbook.
DescriptionProvide a description of the Runbook.
Monitor/Group/IP-HostSelect Monitor, Group, or IP/Host based on the device(s) to which you want to assign the runbook.
Select MonitorSelect desired monitor from the 'Monitors' dropdown if you want to assign the Runbook to an individual monitor. This option is available when you select Monitor in the previous field.
Select GroupSelect desired group from the 'Groups' dropdown if you want to assign the Runbook to a group of monitors. This option is available when you select Group in the previous field.
Select IP/HostSpecify the IP/Host if you want to assign the Runbook to a device that is not discovered in Motadata AIOps as a Monitor. This option is available when you select IP/Host in the previous field.
Credential ProfileSelect the credential profile from the dropdown to enable the Runbook to access and perform tasks on the monitor securely.
Create Credential ProfileSelect this option if you need to create a new credential profile.
PortSpecify the port number in this field. In case you select a credential profile, the port number specified in the credential profile will be used. You can override the port number from the credential profile by specifying a port number in this field.
TimeoutSpecify the timeout in this field. In case you select a credential profile, the timeout specified in the credential profile will be used. You can override the timeout from the credential profile by specifying a timeout in this field.
Log CollectionEnable this check-box to use the runbook for log collection. When you enable this field, the runbook will be available for selection while creating a log collection profile
Script LanguageSpecify the language(Go or Python) you want use to write the parsing script.
Parsing ScriptWrite the script to parse the output.
Add VariableAdd a variable if required in the script.

Click on Test option to validate the credential profile against the selected monitor.

Click on the Create Runbook Plugin to create the Runbook ensuring all parameters are defined as per your requirements. Note that this option becomes available only after successful testing.

Click on the Reset option to clear all input fields.