Host Data Collection fails with ACC error 2503 due to customized acc-f-commons plugin - Support and Troubleshooting

Host Data Collection fails with ACC error 2503 due to customized acc-f-commons plugin .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } .kb-wrapper { font-family: 'Lato', sans-serif; font-size: 12pt; line-height: 1.7; color: #000000; max-width: 100%; } .kb-wrapper h2 { font-family: 'Lato', sans-serif; font-size: 14pt; font-weight: 900; color: #032D42; border-bottom: 2px solid #e8fce4; padding-bottom: 4px; margin-top: 24px; margin-bottom: 10px; } .kb-wrapper p, .kb-wrapper li { font-family: 'Lato', sans-serif; font-size: 12pt; line-height: 1.7; margin: 6px 0; } .kb-wrapper ul, .kb-wrapper ol { padding-left: 24px; margin: 8px 0; } .kb-wrapper ol.kb-steps { list-style: none; counter-reset: kb-step-counter; padding-left: 0; margin: 12px 0; } .kb-wrapper ol.kb-steps li { counter-increment: kb-step-counter; display: flex; align-items: flex-start; gap: 12px; margin-bottom: 10px; } .kb-wrapper ol.kb-steps li::before { content: counter(kb-step-counter); display: flex; align-items: center; justify-content: center; min-width: 26px; height: 26px; background-color: #032D42; color: #63DF4E; font-family: 'Lato', sans-serif; font-size: 11pt; font-weight: 900; border-radius: 50%; flex-shrink: 0; margin-top: 2px; } .kb-wrapper code, .kb-wrapper pre { font-family: 'Courier New', Courier, monospace; background: #e6f0f5; color: #032D42; border: 1px solid #b8cfd8; border-radius: 3px; padding: 1px 5px; font-size: 11pt; } .kb-wrapper pre { display: block; padding: 10px 14px; white-space: pre-wrap; word-break: break-all; margin: 10px 0; } .kb-wrapper .kb-callout-info { border-left: 4px solid #52B8FF; background: #e6f4ff; padding: 10px 14px; margin: 12px 0; border-radius: 0 4px 4px 0; } .kb-wrapper a { color: #032D42; } .kb-wrapper .kb-link-disclaimer { font-size: 10pt; font-style: italic; margin: 2px 0 10px 0; }

Issue Host data collection fails on the Agent Client Collector (ACC) with ACC error 2503.

Symptoms Host data is not collected on the agent record. ACC error 2503 is reported during data collection. The following error appears in the data collection output payload: cmd_err: C:/ProgramData/ServiceNow/agent-client-collector/cache/acc-f-modules/bin/data_collection.rb:28:in ` ': undefined method `generateLoggerIfAbsent' for an instance of CommonUtils (NoMethodError) $logger = $commonUtils.generateLoggerIfAbsent(options.log_file, options.log_level) Facts Product: Agent Client Collector Framework The error originates in data_collection.rb when it attempts to call generateLoggerIfAbsent on the CommonUtils class provided by the acc-f-commons plugin. The generateLoggerIfAbsent method is defined in the out-of-box (OOB) version of acc-f-commons . If the plugin has been customized, this method may be missing or altered, causing the NoMethodError . Release Zurich, Australia

Cause The acc-f-commons plugin has been customized, and the customization has removed or altered the generateLoggerIfAbsent method from the CommonUtils class. When data_collection.rb attempts to call this method at runtime, a NoMethodError is thrown, causing the data collection payload to fail with ACC error 2503.

Resolution Navigate to the acc-f-commons plugin on the instance and check whether any customizations have been applied. If the plugin has been customized, revert it to the out-of-box (OOB) version. After reverting, trigger a new discovery run to confirm host data collection completes successfully. Note: Customizations to ACC Framework plugins such as acc-f-commons can break method contracts expected by dependent modules. Always test plugin customizations in a non-production environment before applying them to production agents.

Related Links Agent Client Collector Framework overview