Deploying Agent Client Collector on servers

concept brazil Updated Sep 10, 2026 5 min read acc-server-deployment.md
Raw file servicenow.com

When deploying the Agent Client Collector, perform deployment and management tasks on your environment's servers.

Server deployment uses MID Servers to connect your agents to a ServiceNow instance. Agents deployed on data center servers open WebSocket connections to your MID Servers, which relay data to your instance. You manage the sizing, certificates, and load balancing of the MID Server.

Use server deployment when your agents are in controlled environments such as data centers, where you are already running MID Servers and want to keep traffic on your network. Agent Client Collector Monitoring (ACC-M) and Agent Client Collector Log Analytics (ACC-L) require server deployment, and you can deploy Agent Client Collector for Visibility Content (ACC-VC) with servers as well.

  • Configuring Agent Client Collector with a MID Server
    Configure the Agent Client Collector with a MID Server to enable communication between network servers and the ServiceNow instance.
  • Agent Client Collector installation on a Linux OS system
    Install Agent Client Collector on a system that uses a Linux OS. Use a single-line command script, or follow the installation procedure to embed the agent in your own package distribution mechanism. The installation procedure provides consistency when using package distribution solutions.
  • Agent Client Collector installation on a Windows machine
    Install the Agent Client Collector on a Windows machine by downloading an installation file and using a wizard, or by using silent installation to automate agent installation and configuration. Manual installation enables you to test the agent on a single system, while silent installation enables you to deploy the agent at scale.
  • Run Agent Client Collector self-diagnostic tests
    Run built-in self-diagnostic tests to validate agents' configuration, connectivity, and system requirements.
  • Require a maintenance token for Windows uninstalls
    Require using a maintenance token when uninstalling an agent from a Windows device. A maintenance token provides a layer of administrative control so that unauthorized personnel can't perform the uninstall.
  • Create a maintenance token
    Create a maintenance token to use when uninstalling an agent from a Windows device. Administrators require maintenance tokens to ensure that unauthorized employees can't perform an uninstall.
  • Uninstall an agent using a maintenance token
    Uninstall an agent from a Windows device using a maintenance token. Administrators require maintenance tokens to ensure that unauthorized employees can't perform an uninstall.
  • Prepare agent deployment on a non-persistent virtual desktop infrastructure machine
    Configure the preliminary settings on an instance to enable using the agent with a non-persistent virtual desktop infrastructure machine (NPVDI) machine. NPVDI agents gather data more quickly than traditional agents not enabled for an NPVDI.
  • Enable a non-persistent virtual desktop infrastructure agent
    Configure an agent to enable it to work in a non-persistent virtual desktop infrastructure (NPVDI) environment. NPVDI agents are self-sufficient and start running checks immediately.
  • Agent Client Collector upgrade overview
    The Agent Client Collector Framework manages agent upgrades directly from the instance, with no manual action required on individual agent hosts.
  • Create and edit Agent Client Collector plugins
    Custom plugins extend Agent Client Collector monitoring capabilities beyond the default plugins. You can create plugins for specific monitoring requirements or modify existing plugins.
  • Optimize distribution of agents to MID Servers
    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.
  • View the Agent Client Collector configuration file for an agent
    View the acc.yml Agent Client Collector configuration file without having to access the host server by retrieving the file from an agent.
  • Create an Agent Client Collector configuration data file
    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.
  • Validate plugins on the MID Server
    Validate plugins on your MID Server to ensure that they match the plugins on your ServiceNow instance. Validating plugins ensures that the instance provides accurate data on all of your MID Server plugins.
  • Validate plugins on agents
    Validate plugins on your agents to ensure that they match the plugins on your ServiceNow instance. Validating plugins ensures that the instance provides accurate data on all of your agents' plugins.
  • Using proxy agents in Agent Client Collector
    You can use a proxy agent to monitor the health and performance of your configuration items (CIs). This works even if the agent is in the cloud or external to your host server.
  • Enable log monitoring in a Linux environment
    To enable monitoring logs in a Linux environment, select the relevant policy and assign specific check parameters to the policy. When log monitoring is enabled and a specified string is discovered in the log being monitored, the system creates an event.
  • Enable log monitoring in a Windows environment
    To enable monitoring logs in a Windows environment, select the relevant policy and assign specific check parameters to the policy. When log monitoring is enabled and a specified string is discovered in the log being monitored, the system creates an event.
  • Select the Azure policies to activate for metric collection
    Activate the Azure policies that come with the Agent Client Collector base system so that Azure virtual machines can collect metrics. These metrics help you monitor the configuration items (CIs) in the CMDB.
  • Use the Agent Client Collector Health Dashboard
    The Agent Client Collector Health Dashboard enables you to monitor the status of the agents in your system.
  • Agent Client Collector Discovery
    Discover CIs in your environment by using Agent Client Collector for Visibility Content (ACC-VC) Discovery. ACC-VC works with both horizontal IP-based Discovery, and you can also use push-based Discovery.
  • Agent Client Collector Log Analytics setup
    Configure Agent Client Collector Log Analytics on your ServiceNow instance either with or without using guided setup.
  • Collect web usage data using Agent Client Collector for Visibility Content
    Track website visits across your organization and gain visibility into web applications your users access using Agent Client Collector for Visibility Content (ACC-VC).

Parent Topic:Agent Client Collector

Search documentation
Search document titles and file paths on the brazil branch