Script

Script notifications allow for more advanced alerts through the use of custom scripts. They can be used to run virtually any scriptable action(s) when the notification profile is triggered by the associated policy.

Hint

Additional configuration steps are required to set up script notifications, but they allow for the most flexibility and sophistication among the different notification action types.

To add a script action to a notification profile, follow these steps:

  1. Click the notification profile to open the configuration tray.

  2. Under Actions, click the + button.

  3. In the secondary tray, select Script from the action type dropdown.

  4. Enter the name of the script file to run in the Script field.

  5. [Optional] Enter any variables or strings to use as arguments in the Command Line Arguments field.

    Hint

    The default %m variable in the arguments field passes the raw event message generated by the alarm policy triggering the notification. This can be replaced any other strings or variables supported by the policy.

  6. Click the Add button to save the action configuration to the profile.

Once added, the script action will be triggered following the alarm policy’s settings for the notification profile.

Additional notes

  • Only script files saved to /home/plixer/scrutinizer/files can be run as notification actions.

  • When adding variables and strings to the arguments field, use quotation marks ("") to enclose terms that should be passed as a single argument.

  • Script files must be assigned the appropriate permissions to be run.

    Note

    When setting a script notification action, using the Test button runs the script as the apache user. When the notification profile is triggered by an alarm policy, Plixer Scrutinizer will run the script as the plixer user.