---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/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


---

# Configuring Agent Client Collector Framework

# Configuring Agent Client Collector Framework {#ariaid-title1}

* Release version: Yokohama
* 
* Updated August 15, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Plan and configure your Agent Client Collector Framework implementation.

Agent Client Collector Framework configuration typically follows these steps:

1. [Configure an agent registration key](https://servicenow-prod.fluidtopics.net/w8odj2oexd8jSfgwkPpMxA "Configure an agent registration key so that you can deploy MID-less Agent Client Collector. Deploying MID-less Agent Client Collector enables you to use the MID Server for more persistent resources.").
2. [Configure the websocket server on the MID Server](https://servicenow-prod.fluidtopics.net/Nhz4taSWhPBGMQb4g~EIQg "Configure the websocket server on MID Servers to enable connections from agents to the MID Server. You can configure only one websocket server per MID Server.").
3. [Configure a websocket endpoint](https://servicenow-prod.fluidtopics.net/V_LePs7YK6XkJBdP6gWGlQ "Configure a websocket endpoint to provide web access from the MID Server to the Agent Client Collector (ACC).").
4. [Configure the frequency of updating the agent MID Server list](https://servicenow-prod.fluidtopics.net/9HpnCsIxsYowUwjWrM9Qrw "By default, the list of MID servers connected to agents is updated once daily. If you have a dynamic environment that adds MID servers frequently, you may want to schedule updates more often, or execute the job on demand.").
5. [Create and edit Agent Client Collector plugins](https://servicenow-prod.fluidtopics.net/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.").
6. [Deploy the Agent Client Collector using a custom base image](https://servicenow-prod.fluidtopics.net/wLz~7Dg8Fq8WVLKP7m7ggg "Deploy the Agent Client Collector on a virtual machine during mass deployment using the machine's base image. Mass deployment uses silent installation, which hides installation status.").
7. [Install the Agent Client Collector](https://servicenow-prod.fluidtopics.net/012KhsJorq5d~zoirdDc0w "You can install the Agent Client Collector on any supported host machine. The Agent Client Collector connects to a MID Server using the HTTP/S protocol, and the connection remains active after being established. One MID Server may handle several agents simultaneously, while a single agent works with one MID Server at a time and switches to a different MID Server when necessary to provide failover protection.").

   The installation procedure to follow depends on the OS you are performing installation on (Linux, Windows, or macOS).  
   Note:  
   Agent Client Collector does not support multiple Agents installed on a single host device. Each host should have only one ACC Agent configured to communicate with a single ServiceNow. instance.
8. [Enable Agent Client Collector monitoring on the MID Server](https://servicenow-prod.fluidtopics.net/AT1P4nAEwMMFFW~n8utcDQ "Enable Agent Client Collector monitoring on the MID Server by configuring the Agent Client Collector framework (ACC-F) and Metric Intelligence extensions in a single action. Enabling Agent Client Collector monitoring also enables monitoring on agents connected to the MID Server.").
9. [Optimize distribution of agents to MID Servers](https://servicenow-prod.fluidtopics.net/3NyYCIk0_ljIxyrl7tZgCQ "Optimize the distribution of agents by allowing redistribution from one MID Server to another. Agents will always be connected to the MID Server with the fastest response time.").
10. [View the Agent Client Collector configuration file for an agent](https://servicenow-prod.fluidtopics.net/6UFdGLbuRUjsyAHTsCiWbg "View the acc.yml Agent Client Collector configuration file without having to access the host server by retrieving the file from an agent.").
11. [Create an Agent Client Collector configuration data file](https://servicenow-prod.fluidtopics.net/N_fWDp0yJMfZz1EjqBYe7w "Create an Agent Client Collector configuration data file and associate it with check definitions so that you can view the information about your instance. You can also add or delete an attachment to the configuration data files, which are used by check definitions during check executions.").
12. [Manually refresh Agent Client Collector certificates](https://servicenow-prod.fluidtopics.net/omPztdSSF~_MR2sxWkwg9g "Pull self-signed certificates from the ServiceNow install server, instead of waiting for the scheduled MID Server synchronization.").
13. [Enable OpenSSL secure signing for plugins](https://servicenow-prod.fluidtopics.net/EREVZSJ~ugZc1Tg6QMGytQ "Create a self-signed certificate for an Agent Client Collector plugin. The following procedure gives an example of how to create an x509 certificate using OpenSSL. For other certificate types, consult OpenSSL documentation.").
14. [Perform Zscaler remediation](https://servicenow-prod.fluidtopics.net/rqqOCqMy7FFF24TvuiFZUQ "If the Zscaler application installed on your Windows or macOS agent is not running efficiently, you can stop and start the app. This process is called remediation. Running remediation automatically creates an incident on the agent. You can also view Zscaler statuses on the Zscaler dashboard as a graph.").
{#configuring-agent-client-collector-framework__ol_blt_1kt_lzb}