Troubleshooting "commonchecks" errors in ACC-M events and metrics checks - Support and Troubleshooting

Troubleshooting "commonchecks" errors in ACC-M events and metrics checks Issue Many out-of-box Event and Metric type Checks in Agent Client Collector Monitoring use a helper application called commonchecks (or commonchecks.exe on Windows). Agent Client Collector for Monitoring default checks and policies

This executable is synched to the Agent cache folder from the OS-specific ACC Plugin named "monitoring-plugin-modules", when the first check needing it is executed, and is part of the Agent Client Collector for Monitoring app. It is regularly changed to add additional commands, or maintain the existing ones.

Windows: C:\ProgramData\ServiceNow\agent-client-collector\cache\monitoring-plugin-modules\bin\commonchecks.exe Linux: /var/log/servicnow/agent-client-collector/cache/monitoring-plugin-modules/bin/commonchecks Mac: /Library/Caches/servicenow/agent-client-collector/monitoring-plugin-modules/bin/commonchecks

Resolution Table of Contents unknown command "xxx" for "commonchecks" Cause: ACC Plugin is an old version, Skipped in the last ACC-M app upgrade Solution: Repair the app, then revert all ACC Plugins to the base system version unknown command "xxx" for "commonchecks" Error in MID Server agent log:

2023-08-25T12:44:30.703+0200 INFO (PrioritizedTaskScheduler.283) [MIDSystem:35] *** Script: MetricsParser received an error/unexpected output: Common Checks CRITICAL: unknown command "metrics-http" for "commonchecks" Testing the check from the instance, will give the same error in the popup:

Cause: ACC Plugin is an old version, Skipped in the last ACC-M app upgrade ACC-M 3.8.0 includes the following 4 July 2023 build:

Running it directly from the command line, with the --help option, shows the Commands it can do:

C:\ServiceNow_MID\empdpiperaccdemo>commonchecks.exe --help Usage: commonchecks [command]

Available Commands: check-kafka-broker-status Kafka Broker Status check-kafka-leader Kafka Topic Partition Leader Check check-kafka-partitions Kafka Topic Partitions Check check-kafka-replicas Kafka Topic Replicas Check check-kafka-rf Kafka Topic Replication Factor Check check-kafka-zk-status Kafka Zookeeper Status check-mongodb-alive Check mongodb Alive check-mongodb-metrics Check MongoDB Metrics check-postgres-alive Check postgresql Alive check-postgres-connections Check postgresql connections completion Generate the autocompletion script for the specified shell help Help about any command metric-gcp Retrieve GCP metrics metric-kafka-broker Kafka Broker Metrics metric-kafka-zookeeper Kafka Zookeeper Metrics metric-postgres-connections Retrieve postgresql connections metric metric-postgres-dbsize Retrieve postgresql dbsize metric metric-postgres-locks Retrieve postgresql locks metric metric-postgres-relation-size Retrieve postgresql table size metric metric-postgres-statsbgwriter Retrieve Postgresql statsbgwriter metric metric-postgres-statsdb Retrieve Postgresql statsdb metric metric-postgres-statsio Retrieve Postgresql statsio metric metric-postgres-statstable Retrieve Postgresql statstable metric metric-vsphere Retrieve Vsphere metrics metrics-http Retrieve http metrics metrics-mongodb Retrieve metrics regarding Mongodb performance

Flags: -h, --help help for commonchecks

Use "commonchecks [command] --help" for more information about a command. Note: These 2 were not in the 6 Jan 2022 build, and you may find others have been added in newer builds since this article was published:

metric-gcp Retrieve GCP metrics metrics-http Retrieve http metrics Solution: Repair the app, then revert all ACC Plugins to the base system version You will need to get a fresh list of what is currently not the out-of-box version from the app, and then revert at least the ACC Plugins back to the latest out-of-box version. The easiest way to do this is:

As an admin role user Navigate to System Application -> All system applications -> All , to load the application manager Search for Agent Client Collector Monitoring , in the Installed section Open that tile, and click the Repair option. It may take a little while. Note: This won't repair it. It will just give a fresh list of what was skipped again. Now go to System Diagnostics - Upgrade History, and search for To: is sn_itmon Open the most recent record. You should see the ACC plugin listed in the "Customizations Unchanged" list. Tick the checkbox for that row, and any others you may need to revert, and then select the "Revert to base system" list action.