summaryrefslogtreecommitdiffstats
path: root/docs/agent-cloud.md
blob: b5b9966175ef3089cff5e7b8f0b7ab5578875dbf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
<!--
title: "Use the Agent with Netdata Cloud"
date: 2020-05-04
custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/agent-cloud.md
-->

# Use the Agent with Netdata Cloud

While the Netdata Agent is an enormously powerful _distributed_ health monitoring and performance troubleshooting tool,
many of its users need to monitor dozens or hundreds of systems at the same time. That's why we built Netdata Cloud, a
hosted web interface that gives you real-time visibility into your entire infrastructure.

There are two main ways to use your Agent(s) with Netdata Cloud. You can use both these methods simultaneously, or just
one, based on your needs:

- Use Netdata Cloud's web interface for monitoring an entire infrastructure, with any number of Agents, in one
  centralized dashboard.
- Use **Visited nodes** to quickly navigate between the dashboards of nodes you've recently visited.

## Monitor an infrastructure with Netdata Cloud

We designed Netdata Cloud to help you see health and performance metrics, plus active alarms, in a single interface.
Here's what a small infrastructure might look like:

![Animated GIF of Netdata Cloud](https://user-images.githubusercontent.com/1153921/80828986-1ebb3b00-8b9b-11ea-957f-2c8d0d009e44.gif)

[Read more about Netdata Cloud](https://github.com/netdata/netdata/blob/master/docs/cloud/cloud.mdx) to better
understand how it gives you real-time
visibility into your entire infrastructure, and why you might consider using it.

Next, [get started in 5 minutes](https://github.com/netdata/netdata/blob/master/docs/cloud/get-started.mdx), or read our
[connection to Cloud reference](https://github.com/netdata/netdata/blob/master/claim/README.md) for a complete
investigation of Cloud's security and encryption features, plus instructions for Docker containers.

## Navigate between dashboards with Visited nodes

If you don't want to use Netdata Cloud's web interface, you can still connect multiple nodes through the **Visited
nodes** menu, which appears on the left-hand side of the dashboard.

You can use the Visited nodes menu to navigate between the dashboards of many different Agent-monitored systems quickly.

To add nodes to your Visited nodes menu, you first need to navigate to that node's dashboard, then click the **Sign in**
button at the top of the dashboard. On the screen that appears, which states your node is requesting access to your
Netdata Cloud account, sign in with your preferred method.

Cloud redirects you back to your node's dashboard, which is now connected to your Netdata Cloud account. You can now see
the Visited nodes menu, which is populated by a single node.

![An Agent's dashboard with the Visited nodes menu](https://user-images.githubusercontent.com/1153921/80830383-b6ba2400-8b9d-11ea-9eb2-379c7eccd22f.png)

If you previously went through the Cloud onboarding process to create a Space and War Room, you will also see these in
the Visited Nodes menu. You can click on your Space or any of your War Rooms to navigate to Netdata Cloud and continue
monitoring your infrastructure from there.

![A Agent's dashboard with the Visited nodes menu, plus Spaces and War Rooms](https://user-images.githubusercontent.com/1153921/80830382-b6218d80-8b9d-11ea-869c-1170b95eeb4a.png)

To add more Agents to your Visited nodes menu, visit them and sign in again. This process connects that node to your
Cloud account and further populates the menu.

Once you've added more than one node, you can use the menu to switch between various dashboards without remembering IP
addresses or hostnames or saving bookmarks for every node you want to monitor.

![Switching between dashboards with Visited nodes](https://user-images.githubusercontent.com/1153921/80831018-e158ac80-8b9e-11ea-882e-1d82cdc028cd.gif)

## What's next?

The Agent-Cloud integration is highly adaptable to the needs of any infrastructure or user. If you want to learn more
about how you might want to use or configure Cloud, we recommend the following:

- Get an overview of Cloud's features by
  reading [Cloud documentation](https://github.com/netdata/netdata/blob/master/docs/cloud/cloud.mdx).
- Follow the
  5-minute [get started with Cloud](https://github.com/netdata/netdata/blob/master/docs/cloud/cloud.mdx)
  guide to finish
  onboarding and connect your first nodes.
- Better understand how agents connect securely to the Cloud
  with [connect agent to Cloud](https://github.com/netdata/netdata/blob/master/claim/README.md) and 
  [Agent-Cloud link](https://github.com/netdata/netdata/blob/master/aclk/README.md) documentation.