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

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Enable checks from the community for Agent Client Collector

# Enable checks from the community for Agent Client Collector {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

You can take checks from the github community and customize them for use in the Agent Client Collector (ACC), or you can compose your own scripts. Create a
plugin with the customized Sensu check and install it on a ServiceNow
instance.

## Before you begin

Role required: agent_client_collector_admin

## Procedure

1. Copy a check from the github community to your local machine.
2. Create a tar.gz file to be appended to your plugin:
   1. Create a folder on your local machine.
   2. Create a sub-folder called bin.
   3. Place the checks you want to run (scripts and executables) in the bin folder.
   4. In a Linux environment, give executable permissions to the checks by running chmod +x filename on each of the checks.
   5. Navigate to the parent folder (above the bin folder).
   6. In a Linux environment, run the tar -C \<parent_folder_name\> --zcvf \<my_plugin_name\>.tar.gz \* command.  
      In a Windows environment, use an archiving utility that supports the tar.gz format.
   7. In a Windows environment, ensure that you include the following scripts in the bin folder:  
      * A batch script configured to run on the check command and initiate the run. For example, powershell \<%\~dp0\>\\test.ps1

        The
        \<%\~dp0\> variable directs to the
        drive (d) and path
        (p) of the batch file.
      * The relevant script (for example, test.ps1) to be executed in the batch script.
      {#acc-custom-checks__ul_b31_btl_r4b}
   {#acc-custom-checks__substeps_qfj_grl_r4b}
3. Create a new ACC plugin, as described in [Create and edit Agent Client Collector plugins](https://www.servicenow.com/docs/CkEqW_BBQYDK2HE3kAb52g "You can edit the default plugins, or you can add new plugins, as needed. Creating and editing plugins customizes the Agent Client Collector monitoring capabilities.").
4. Test the new plugin.
   1. Create a new check definition for the customized Sensu check.  
      For details, see [Create and edit checks](https://www.servicenow.com/docs/A7TXcz2fJuof_Qofu2Hzvw "You can select a check based on the type of entity (such as a server or an application) you want to monitor. You can view and edit the default checks or create new checks, as needed.").
   2. On the Check Definition page, navigate to the Related Links section and select Generate allow list content.
   3. Copy the entries you want to include in the allow list and add them to the agent's check-allow-list.json file, either manually or using an automation tool.  
      The location of this file is indicated in the allow-list parameter of the agent's acc.yml file.
   4. Create a new policy and add the newly created check definition.  
      For details on creating a policy, see [Create an Agent Client Collector policy](https://www.servicenow.com/docs/0KxRUBj1j0vmDDgouYKZ0g "Policies consist of the CIs monitored by the Agent Client Collector and the checks that run on those CIs. When creating a policy, you configure a filter which determines the CIs on which the checks are to run. For example, a policy to run checks on all Apache web servers. You can create new policies or edit the default policies.").
   5. Select the check definition and in the Related Links section, select Test check.
   {#acc-custom-checks__substeps_t1m_ndm_r4b}
5. Enable credentials when testing a check:
   1. Navigate to Connections \& CredentialsCredentials.
   2. Click New.
   3. Select the type of credentials you want to create.  
      For details on creating credentials, see [Create a Connection and Credential alias](https://www.servicenow.com/docs/access?context=connection-alias&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).
   4. Enter values in the fields on the page to assign credentials to your selected credential type.
   5. Click Submit.
   {#acc-custom-checks__substeps_kzv_hfp_s4b}
6. Create secure parameters for your check, as described in [Create secure parameters for a check](https://www.servicenow.com/docs/lIF9l96vgoccq6hb_MA30g "When creating a check definition or check instance, you can configure the parameters you want to be secured when the agent executes the check. During check execution, the secured parameters are obfuscated, securing their information. Only credential information is obfuscated.").

*[\>]: and then