Andrew Moss 4fe1cb90bf Additional cases for the thread exit fix (#8750) 4 years ago
..
tests 9ee4478f9a Fake collector to provoke ACLK messages (#8427) 5 years ago
Makefile.am 9ee4478f9a Fake collector to provoke ACLK messages (#8427) 5 years ago
README.md 3bac7654b7 Docs: Combined claiming+ACLK documentation (#8724) 4 years ago
aclk_common.c 844a2d4e03 Fix Coverity defects (#8579) 5 years ago
aclk_common.h a8e9fcb363 HTTP proxy support + some cleanup (#8418) 5 years ago
aclk_lws_https_client.c 844a2d4e03 Fix Coverity defects (#8579) 5 years ago
aclk_lws_https_client.h 10090b556b Support SOCKS5 in ACLK Challenge/Response and rewrite with LWS (#8404) 5 years ago
aclk_lws_wss_client.c 87b39f90cd Allow insecure SSL in the testing environment (#8489) 5 years ago
aclk_lws_wss_client.h a43bd7cc5b Report ACLK Connection Failure (#8456) 5 years ago
agent_cloud_link.c 4fe1cb90bf Additional cases for the thread exit fix (#8750) 4 years ago
agent_cloud_link.h 983a26d1a2 Revert "Revert changes since v1.21 in pereparation for hotfix release." 4 years ago
mqtt.c 983a26d1a2 Revert "Revert changes since v1.21 in pereparation for hotfix release." 4 years ago
mqtt.h 2c716dc31e ACLK: Implemented Last Will and Testament (#8410) 5 years ago

README.md

Agent-cloud link (ACLK)

The Agent-Cloud link (ACLK) is the mechanism responsible for connecting a Netdata Agent to Netdata Cloud. The ACLK uses MQTT over secure websockets to first create, persist, encrypt the connection, and then enable the features found in Netdata Cloud. No data is exchanged with Netdata Cloud until you claim a node.

Read our claiming documentation for a guide for claiming a node using the ACLK and additional troubleshooting and reference information.

Enable and configure the ACLK

The ACLK is enabled by default and automatically configured if the prerequisites installed correctly. You can see this in the [cloud] section of netdata.conf.

[cloud]
    cloud base url = https://app.netdata.cloud

If your Agent needs to use a proxy to access the internet, you must set up a proxy for claiming.

Disable the ACLK

You have two options if you prefer to disable the ACLK and not use Netdata Cloud:

  1. Pass --disable-cloud to netdata-installer.sh during installation. When you pass this parameter, the installer does not download or compile any extra libraries, and the Agent behaves as though the ACLK, and thus Netdata Cloud, does not exist. ACLK functionality is available in the Agent but remains fully inactive.

  2. Change a runtime setting in your netdata.conf file. This setting only stops the Agent from attempting any connection via the ACLK, but does not prevent the installer from downloading and compiling the ACLK's dependencies.

    [global]
    netdata cloud = disable
    

[analytics](<>)