Stelios Fragkakis 8935cf0469 Adjust API version (#18906) 2 weeks ago
..
aclk-schemas @ e07e855389 3dfe351bed Improve alerts (#18080) 4 months ago
mqtt_websockets 7d800def88 Random numbers improvements (#18939) 2 weeks ago
schema-wrappers 3dfe351bed Improve alerts (#18080) 4 months ago
README.md 7332919cf5 Docs fixes (#18676) 1 month ago
aclk.c b4dfc78ec2 Coverity fixes (#18896) 3 weeks ago
aclk.h 934fa2e109 Handle mqtt ping timeouts (#18653) 1 month ago
aclk_alarm_api.c 308ca33db9 Use existing ACLK event loop for cloud queries (#18218) 2 months ago
aclk_alarm_api.h 39a3bff6d1 Misc code cleanup (#18540) 2 months ago
aclk_capas.c 8935cf0469 Adjust API version (#18906) 2 weeks ago
aclk_capas.h 4c0122063f WIP - Netdata v2 (#18125) 3 months ago
aclk_contexts_api.c a25ff1b401 Move aclk/ under src/ (#16899) 9 months ago
aclk_contexts_api.h a25ff1b401 Move aclk/ under src/ (#16899) 9 months ago
aclk_otp.c dcdd994bfa Prevent memory corruption during ACLK OTP decode (#18863) 4 weeks ago
aclk_otp.h 1bb3047ee6 Reduce connection timeout and fallback to IPV4 for ACLK connections (#18568) 2 months ago
aclk_proxy.c 4c0122063f WIP - Netdata v2 (#18125) 3 months ago
aclk_proxy.h a25ff1b401 Move aclk/ under src/ (#16899) 9 months ago
aclk_query.c 39a3bff6d1 Misc code cleanup (#18540) 2 months ago
aclk_query.h 308ca33db9 Use existing ACLK event loop for cloud queries (#18218) 2 months ago
aclk_query_queue.c 308ca33db9 Use existing ACLK event loop for cloud queries (#18218) 2 months ago
aclk_query_queue.h 308ca33db9 Use existing ACLK event loop for cloud queries (#18218) 2 months ago
aclk_rx_msgs.c 934fa2e109 Handle mqtt ping timeouts (#18653) 1 month ago
aclk_rx_msgs.h 39a3bff6d1 Misc code cleanup (#18540) 2 months ago
aclk_tx_msgs.c fbeee6b122 Misc mqtt related code cleanup (#18622) 1 month ago
aclk_tx_msgs.h 39a3bff6d1 Misc code cleanup (#18540) 2 months ago
aclk_util.c 4aba1a3c07 better randomness for heartbeat (#18930) 2 weeks ago
aclk_util.h fbeee6b122 Misc mqtt related code cleanup (#18622) 1 month ago
https_client.c fbeee6b122 Misc mqtt related code cleanup (#18622) 1 month ago
https_client.h 1bb3047ee6 Reduce connection timeout and fallback to IPV4 for ACLK connections (#18568) 2 months ago

README.md

Agent-Cloud link (ACLK)

The Agent-Cloud link (ACLK) is the mechanism responsible for securely connecting a Netdata Agent to your web browser through Netdata Cloud. The ACLK establishes an outgoing secure WebSocket (WSS) connection to Netdata Cloud on port 443. The ACLK is encrypted, safe, and is only established if you connect your node.

The Cloud App lives at app.netdata.cloud which currently resolves to the following list of IPs:

  • 54.198.178.11
  • 44.207.131.212
  • 44.196.50.41

Caution

This list of IPs can change without notice, we strongly advise you to whitelist following domains app.netdata.cloud, mqtt.netdata.cloud, if this is not an option in your case always verify the current domain resolution (e.g via the host command).

For a guide to connecting a node using the ACLK, plus additional troubleshooting and reference information, read our connect to Cloud documentation.

Data privacy

Data privacy is very important to us. We firmly believe that your data belongs to you. This is why we don't store any metric data in Netdata Cloud.

All the data that you see in the web browser when using Netdata Cloud, is actually streamed directly from the Netdata Agent to the Netdata Cloud dashboard. The data passes through our systems, but it isn't stored.

However, to be able to offer the stunning visualizations and advanced functionality of Netdata Cloud, it does store a limited number of metadata. Read more about our security and privacy design.

Enable and configure the ACLK

The ACLK is enabled by default, with its settings automatically configured and stored in the Agent's memory.

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

You can configure following keys in the netdata.conf section [cloud]:

[cloud]
    statistics = yes
    query thread count = 2
  • statistics enables/disables ACLK related statistics and their charts. You can disable this to save some space in the database and slightly reduce memory usage of Netdata Agent.
  • query thread count specifies the number of threads to process cloud queries. Increasing this setting is useful for nodes with many children (streaming), which can expect to handle more queries (and/or more complicated queries).