Skip to content
Release: Australia · Updated: 2026-03-11 · Official documentation · View source

Create a check definition for a custom remedial action

Create a check definition and link it to the Agent Client Collector (ACC) plugin to enable the ACC agent to run a custom remedial action.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > Agent Client Collector > Configurations > Check Definitions.

  2. Select New.

  3. On the form, enter a name for the check definition in the Name field.

    For example, custom-script-check.

  4. Select the check type to define how the output is processed after running the check definition.

    1. In the Check type field, select the Lookup using list icon
Image omitted: icon-magnifying-glass-blue.png
to navigate to the Check Types page.
2.  Select the check type from the list.
  1. In the Command field, enter the name of the .rb script included in the ACC plugin package.

    For example, custom-script.rb.

    Note: For information about creating a check definition with input parameters, see Create a check definition.

  2. From the When to send the check results drop-down list, select when to send check results.

  3. In the Plugins field, integrate the plugins in the ACC plugin package with the check definition.

    1. Select the Unlock plugins icon
Image omitted: icon-visible-fields.png
.
2.  In the Select target record field, select the Lookup using list icon
Image omitted: icon-magnifying-glass-blue.png
and select the plugin or type the plugin names.
    For example, acc-f-commons and acc-dex-custom.

3.  Select the Lock Plugins icon
Image omitted: icon-lock-visible-fields.png
.
  1. On the form, fill in the remaining fields.

    For a description of the field values, see Agent Client Collector check definition page.

  2. Select Submit.

Parent Topic:Creating and executing a PowerShell script-based remedial action