Documentation forServer & Application Monitor

Create a Linux/Unix script monitor in SAM

This topic explains how to use the Linux/Unix Script Monitor included in SAM to run custom scripts in SAM to monitor Linux/Unix-based systems. Before coding and testing your script, review Configure Linux/Unix systems for the Orion agent for Linux and Best practices for SAM templates.

  1. Click Settings > All Settings > SAM Settings and click Manage Templates.

    The Manage Application Monitor Templates page opens. All available out-of-the-box and custom templates display.

  2. Search to locate, select, and edit an existing template or click Create New Template.

  3. Click Add Component Monitor(s) and choose Manually Add Component Monitors.
  4. Search for Linux/Unix. When displayed, select the Linux/Unix Script Monitor and click add.

  5. Select the Authentication Type and Credentials for Monitoring.

  6. Enter a Working Directory to process the script, such as /tmp.
  7. Enter a Command Line to run the script including all parameters using the format <scripting language path> ${SCRIPT} such as perl, python, or bash.

    Depending on the type of script, the command line may require additional information and parameters. For example, the file path or hostname.

  8. Click Edit Script to enter and test the script.

  9. Test the script by selecting settings for the output, specified node, and specified credentials. Click Get Script Output.

    Output results display using the script code with success or failure and any additional notes.

  10. Click Get Script Output to generate the output and click Save.

    The metrics save to outputs to configure as part of the component monitor. These outputs display at polling intervals for the template.

  11. When complete, click Submit to save the template.

When tested, output generates into customizable sections. Each output section is named by the Unique ID with a Display Name you can edit. For each output, you can optionally:

  • Convert the value using selected formulas.
  • Configure the statistic thresholds to refine alerting for the component monitor. Set the warning and critical thresholds with specific values or baseline data.
  • Select a roll-up status sort option to display the best or worst status up through the template and component monitor.
  • Add notes to describe the script output.

Related topics include: