FAQ about agents

Here you can find answers to frequently asked questions about agents.

If the CloudRadar agent does not connect to the cloudradar server you should perform the following checks:

Check your internet connection.

All measurement data will be transferred using an https upload to the central server. Outgoing connection via HTTPS TCP Port 443 to hub.cloudradar.io ( must be allowed.

Try to access the URL from the command line using curl -v https://hub.cloudradar.io/ctrapper/

Getting a 401 Unauthorized is expected. If you don't get connection details like shown below your system is blocking the connection. Check the internal and external firewalls or try using a proxy (see below).

curl -v https://hub.cloudradar.io/ctrapper/
* Trying
* Connected to hub.cloudradar.io ( port 443 (#0)
* ALPN, offering h2
* ALPN, offering http/1.1
* successfully set certificate verify locations:
* CAfile: /etc/ssl/cert.pem
CApath: none
* TLSv1.2 (OUT), TLS handshake, Client hello (1):
* SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384
* ALPN, server accepted to use h2
* Server certificate:
* subject: OU=Domain Control Validated; CN=*.cloudradar.io
* start date: Mar 5 09:58:58 2018 GMT
* expire date: Apr 6 13:29:05 2020 GMT
* subjectAltName: host "hub.cloudradar.io" matched cert's "*.cloudradar.io"
* issuer: C=BE; O=GlobalSign nv-sa; CN=AlphaSSL CA - SHA256 - G2
* SSL certificate verify ok.
* Using HTTP2, server supports multi-use
* Connection state changed (HTTP/2 confirmed)
* Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0
* Using Stream ID: 1 (easy handle 0x7fb59b005400)
> GET /ctrapper/ HTTP/2
> Host: hub.cloudradar.io
> User-Agent: curl/7.64.1
> Accept: */*
* Connection state changed (MAX_CONCURRENT_STREAMS == 250)!
< HTTP/2 401
< cache-control: no-cache, private
< content-type: application/json
< date: Thu, 30 Jan 2020 14:11:12 GMT
< server: Caddy
< status: 401 Unauthorized
< content-length: 26
* Connection #0 to host hub.cloudradar.io left intact
{"error":"Unauthorized. "}* Closing connection 0

Check your cagent.conf file

Verify the configuration file has been written correctly during the installation. It's located in /etc/cagent/cagent.conf (Linux) or C:\Program Files\cagent\cagent.conf (Windows). Open the file with a text editor. Verify that the values for hub_url, hub_user, and hub_password match exactly your settings. If not, enter the correct value manually and restart the agent.

Verify the configuration file

Use a proxy

If for security reasons your server has no general internet access consider using an HTTP proxy to allow the cloudradar agent limited internet access. Enter the following lines to the config file and restart the cloudradar agent "cagent".

hub_proxy = "proxy.example.local" # HTTP proxy to use with HUB
hub_proxy_user = "username" # Optional (requires hub_proxy to be set)
hub_proxy_password = "password" # Optional (requires hub_proxy_user to be set)