Troubleshoot - Agent is offline

Error experienced

Potential Error Messages

  1. Unable to create job - Error Agent CI Sync Agent X is offline and has not polled CI Sync in over 10 minutes.

  2. The CI Sync Agent UI reports a long error message contain the key words “The provided client secret for app xxxxxx are expired“ (where xxxxx is the app registration for the CI Sync Agent).

This KB applies to:

Applies to Versions

All

Applies to Source Connectors

All

Applies to Destination Connectors

ServiceNow

Error verification

In the Settings page Connection tab, the agent will have a red dot next to its name.

When hovering over the red dot it will display the last time the agent successfully polled.

image-20250707-061329.png

When viewing a job that has errored the error “Error - Unable to create job = Error {YOUR AGENT} is offline and has not polled CI Sync in over 10 minutes” will be displayed at the top of the page

image-20250709-062220.png

Cause

The CI Synchronizer agent is offline or unable to successfully poll your CI Synchronizer instance.

Fix

Check the following steps:

Is the installed CI Synchronizer agent service running?

Verify on the machine where the CI Synchronizer agent is installed that the service is running.

Using the CI Synchronizer Agent Config UI click the "Connect" button

Click the Connect button underneath "Test Connection” and validate no errors are displayed.

image-20250707-062747.png

If using Client Secret authentication, has the Client Secret expired?

See also → https://support.syncfish.com.au/cs/ckb054-how-to-update-an-expired-client-secret-for-

image-20250709-230919.png

If using Client Secret authentication, is the Client Secret invalid?

Ensure you have entered the Client Secret Value and not the Client Secret ID

image-20250710-092538.png


See also → https://support.syncfish.com.au/cs/ckb054-how-to-update-an-expired-client-secret-for-

image-20250707-234441.png

If using Certificate based authentication, does the certificate exist?

See also → https://support.syncfish.com.au/cs/ckb020-troubleshoot-error-validating-agent-authent

image-20250707-234839.png

Is there a HMAC mismatch error?

See also → https://support.syncfish.com.au/cs/ckb033-troubleshoot-job-errors-with-hmac-mismatch-#Troubleshoot-JoberrorswithHMACmismatcherror-Fix

image-20250708-050551.png

Check CI Synchronizer agent logs

You can view logs at c:\program files\syncfish\CISynchronizerAgent\service\logs

Note: This folder “CISynchronizerAgent” is the default and may differ for your installation.

image-20250708-051244.png

If none of the above checks show anything at fault, please create a support ticket on our support portal @ https://syncfish.atlassian.net/servicedesk/customer/portal/2, attaching the last couple of days of logs from the Agent.

There are currently no related articles.

Control Information

Created

Reviewed

Data Classification

PUBLIC
Classified in accordance with the Syncfish Data Classification Framework