---
sourceDocument: Brazil IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Create check definition for remedial action

# Create a check definition for a custom remedial action {#ariaid-title1}

Release version: Brazil  
Updated October 23, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
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

* [Create an ACC plugin package](https://www.servicenow.com/docs/uG2skjBma9jf3h_QVKXFig "Package a PowerShell script, a Ruby script, and an execution allowlist into an Agent Client Collector (ACC) plugin to run remedial actions on endpoints from the platform.")
* [Sign and verify the ACC plugin](https://www.servicenow.com/docs/X~BwiEfmvCJEf6QOkBXDHg "Sign an Agent Client Collector (ACC) plugin with a self-signed certificate and verify the signature so that endpoint devices can validate the plugin.")
* The signed ACC plugin tar.gz file must be uploaded to the ServiceNow instance. For more information, see [Create and edit Agent Client Collector plugins](https://www.servicenow.com/docs/rhuP9UTwtXHmFgSQzfEbIQ "Custom plugins extend Agent Client Collector monitoring capabilities beyond the default plugins. You can create plugins for specific monitoring requirements or modify existing plugins.").
{#create-check-def-remedial-actions__ul_ygz_qfh_43c}

Role required: admin

## Procedure

1. Navigate to AllAgent Client CollectorConfigurationsCheck Definitions.
2. Select New.
3. On the form, enter a name for the check definition in the Name field.  
   For example, <kbd class="ph userinput">custom-script-check</kbd>.
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 ![]() to navigate to the Check Types page.
   2. Always select the `DexContentAction` check type from the list.
   3. Add a timeout script for the remedial action check definition.  

          var util = new sn_dex.DEXRemedialActionsUtils();
          util.handleRemedialActionTimeout(request);

   {#create-check-def-remedial-actions__substeps_es3_qqb_43c}
5. 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](https://www.servicenow.com/docs/cufP9V6D2gP7_XL2E_4W6A "Create a check definition to execute the osquery command on the Agent.").
6. From the When to send the check results drop-down list, select when to send check results.
7. In the Plugins field, integrate the plugins in the ACC plugin package with the check definition.
   1. Select the Unlock plugins icon ![]().
   2. In the Select target record field, select the Lookup using list icon ![]() and select the plugin or enter the plugin names.  
      For example, <kbd class="ph userinput">acc-f-commons</kbd> and <kbd class="ph userinput">acc-dex-custom</kbd>.
   3. Select the Lock plugins icon ![]().
   {#create-check-def-remedial-actions__substeps_ywn_1dc_43c}
8. On the form, fill in the remaining fields.  
   For a description of the field values, see [Agent Client Collector check definition page](https://www.servicenow.com/docs/1x7VfXSHadzyls0xKhQqPw "The fields to be configured on the Check Definition page, when creating a check definition.").
9. Select Submit.

*[\>]: and then