Knowledge Base

Showing results for 
Search instead for 
Did you mean: 

How to resolve Analytics Agent failing to connect to the Controller registration endpoint



 Within the Analytics Agent logs, the following error message is shown:


[2017-07-24T15:22:17,856+01:00]  [ERROR]  [analytics-agent-sync-thread-0]  [c.a.a.agent.sync.ErrorMessageHelper]  Analytics agent failed to connect to the controller registration endpoint. Could not execute request to https:/rest/analytics/agent/register
	at ~[analytics-shared-rest.jar:na]
	at ~[analytics-shared-rest.jar:na]
	at ~[analytics-agent.jar:na]
	at ~[analytics-agent.jar:na]
	at$ [analytics-agent.jar:na]
	at java.util.concurrent.Executors$ [na:1.8.0_111]
	at [na:1.8.0_111]
	at java.util.concurrent.ThreadPoolExecutor.runWorker( [na:1.8.0_111]
	at java.util.concurrent.ThreadPoolExecutor$ [na:1.8.0_111]
	at [na:1.8.0_111]
Caused by: org.apache.http.client.ClientProtocolException: URI does not specify a valid host name: https:/rest/analytics/agent/register
	at org.apache.http.impl.client.CloseableHttpClient.determineTarget( ~[httpclient-4.5.1.jar:4.5.1]
	at org.apache.http.impl.client.CloseableHttpClient.execute( ~[httpclient-4.5.1.jar:4.5.1]
	at org.apache.http.impl.client.CloseableHttpClient.execute( ~[httpclient-4.5.1.jar:4.5.1]
	at ~[analytics-shared-rest.jar:na]
	... 9 common frames omitted


The error indicates an issue with the Controller endpoint.


After investigating the URL of the endpoint, the endpoint is not taken from the Analytics Agent property ad.controller.url.


Could not execute request to https:/rest/analytics/agent/register


This property is located in analytics-agent/conf/ file, or for Machine Agents, MachineAgent/monitors/analytics-agent/conf/



Two potential causes for this issue:


1. The user did not set the property ad.controller.url within the file.

2. The Controller endpoint contains underscores or other special characters.

For example




If the property ad.controller.url was not set within the property file, the user must set the property ad.controller.url in the file and then restart the Analytics Agent.


If the Controller endpoint contains special characters, the user must set the property ad.controller.url in in the property file, as in the example below, then restart the Analytics Agent. 


*Make sure to wrap the URL in single quotes.


Version history
Revision #:
5 of 5
Last update:
‎09-22-2017 03:17 PM
Updated by:
Labels (2)
0 Kudos