Configure automated remediation scripts that execute on agent-monitored devices when an alarm fires. Cloudmon provides over 100 pre-built runbook templates and supports custom runbooks for organisation-specific tasks.
Runbooks in Cloudmon are ready-to-run scripts that can be executed automatically on agent-monitored devices when an alarm trigger fires, or run manually at any time. Automated remediation through runbooks reduces mean time to resolution, eliminates manual intervention for known recurring issues, and helps prevent downtime by acting on problems the moment they are detected.
Cloudmon includes over 100 built-in runbook templates covering tasks such as restarting services, clearing DNS caches, taking screenshots, fetching email status, and more. If the built-in templates do not cover a specific requirement, custom runbooks can be created. Runbooks are exclusively available for agent-monitored devices. Navigate to Settings → General Settings → Runbooks to view and manage all runbooks.
| Field | Description |
| Name | A descriptive name for the runbook. |
| Description | A brief description of the runbook's purpose, such as what it does and when it should be used. |
| Type | Select Script to write or paste a script into the editor, or Command to enter a single command to be executed on the agent. |
| Operating System | The target operating system for this runbook. Cloudmon uses this to ensure the script or command is only executed on compatible agents (Windows or Linux/macOS). |
| Timeout (seconds) | The maximum time the system waits for the script or command to complete before stopping the execution. |
| Arguments | Additional parameters passed to the script or command to customise its execution. Hover over the info icon to view the expected format. |
| Filter | Optional filter to restrict which agents this runbook can be executed on. Hover over the info icon next to the filter field to view the format. |
When Type is set to Script, the script content you provide is executed on the target agent. The supported scripting languages depend on the selected operating system:
When Type is set to Command, a single shell or PowerShell command is executed directly on the agent without a script file.
Runbooks can be executed in three ways:
When an alarm fires, Cloudmon automatically executes the runbook attached to the alarm trigger. Navigate to Settings → Configurations → Alarm Rules, open the rule, add a trigger, and in the THEN section enable Run Script. Select whether to run on the controller or the agent, then choose the runbook. When the alarm is raised, the runbook executes automatically and the output is shown in the alarm overlay.
When an alarm is triggered, click on the alarm, hover over Execute Runbook to view the list of available runbooks, and select the desired script. This allows for manual control over which runbook is executed for a specific active alarm.
Runbooks can also be executed directly from any agent's detail page without needing an active alarm. Navigate to Agents → All Agents, select an agent, and click the Actions icon. A list of all available runbooks including any custom runbooks is displayed. Click the run icon to execute a runbook, or the history icon to view past executions and their outputs. You can also click the command icon to manually execute a one-off command on the agent and view the output under All History.