summaryrefslogtreecommitdiffstats
path: root/docs/deployment-guides/standalone-deployment.md
blob: 5baef805a95e6a3170e96d58f2bbb7bbc5503f5f (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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
# Standalone Deployment

To help our users have a complete experience of Netdata when they install it for the first time, a Netdata Agent with default configuration is a complete monitoring solution out of the box, having all its features enabled and available.

So, each Netdata agent acts as a standalone monitoring system by default.

## Standalone agents, without Netdata Cloud

|                    Feature                    |                     How it works                     |
|:---------------------------------------------:|:----------------------------------------------------:|
| Unified infrastructure dashboards for metrics |  No, each Netdata agent provides its own dashboard   |
|  Unified infrastructure dashboards for logs   |     No, each Netdata agent exposes its own logs      |
|          Centrally configured alerts          |  No, each Netdata has its own alerts configuration   |
|   Centrally dispatched alert notifications    | No, each Netdata agent sends notifications by itself |
|         Data are exclusively on-prem          |                         Yes                          |

When using Standalone Netdata agents, each of them offers an API and a dashboard, at its own unique URL, that looks like `http://agent-ip:19999`.

So, each of the Netdata agents has to be accessed individually and independently of the others:

```mermaid
flowchart LR
    WEB[["Multiple
        Independent
        Dashboards"]]
    S1["Standalone
        Netdata
         1"]
    S2["Standalone
        Netdata
         2"]
    SN["Standalone
        Netdata
         N"]
    WEB -->|URL 1| S1
    WEB -->|URL 2| S2
    WEB -->|URL N| SN
```

The same is true for alert notifications. Each of the Netdata agents runs its own alerts and sends notifications by itself, according to its configuration:

```mermaid
flowchart LR
    S1["Standalone
        Netdata
         1"]
    S2["Standalone
        Netdata
         2"]
    SN["Standalone
        Netdata
         N"]
    EMAIL{{"<b>e-mail</b>
        notifications"}}
    SLACK{{"<b>Slack</b>
        notifications"}}
    OTHER{{"Other
        notifications"}}
    S1 & S2 & SN .-> SLACK
    S1 & S2 & SN ---> EMAIL
    S1 & S2 & SN ==> OTHER
```

### Configuration steps for standalone Netdata agents without Netdata Cloud

No special configuration needed.

- Install Netdata agents on all your systems, then access each of them via its own unique URL, that looks like `http://agent-ip:19999/`.

## Standalone agents, with Netdata Cloud

|                    Feature                    |                                                                              How it works                                                                               |
|:---------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
| Unified infrastructure dashboards for metrics |                                                 Yes, via Netdata Cloud, all charts aggregate metrics from all servers.                                                  |
|  Unified infrastructure dashboards for logs   | All logs are accessible via the same dashboard at Netdata Cloud, although they are not unified (ie. logs from different servers are not multiplexed into a single view) |
|             Centrally configured alerts       |                                                            No, each Netdata has its own alerts configuration                                                            |
|   Centrally dispatched alert notifications    |                                                                         Yes, via Netdata Cloud                                                                          |
|         Data are exclusively on-prem          |                                                 Yes, Netdata Cloud queries Netdata Agents to satisfy dashboard queries.                                                 |

By [connecting all Netdata agents to Netdata Cloud](https://github.com/netdata/netdata/blob/master/src/claim/README.md), you can have a unified infrastructure view of all your nodes, with aggregated charts, without configuring [observability centralization points](https://github.com/netdata/netdata/blob/master/docs/observability-centralization-points/README.md).

```mermaid
flowchart LR
    WEB[["One unified
        dashboard
        for all nodes"]]
    NC(["<b>Netdata Cloud</b>
        decides which agents
        need to be queried"])
    S1["Standalone
        Netdata
         1"]
    S2["Standalone
        Netdata
         2"]
    SN["Standalone
        Netdata
         N"]
    WEB -->|queries| NC
    NC -->|queries| S1 & S2 & SN
```

Similarly for alerts, Netdata Cloud receives all alert transitions from all agents, decides which notifications should be sent and how, applies silencing rules, maintenance windows and based on each Netdata Cloud space and user settings, dispatches notifications:

```mermaid
flowchart LR
    EMAIL{{"<b>e-mail</b>
        notifications"}}
    MOBILEAPP{{"<b>Netdata Mobile App</b>
        notifications"}}
    SLACK{{"<b>Slack</b>
        notifications"}}
    OTHER{{"Other
        notifications"}}
    NC(["<b>Netdata Cloud</b>
        applies silencing
        & user settings"])
    S1["Standalone
        Netdata
         1"]
    S2["Standalone
        Netdata
         2"]
    SN["Standalone
        Netdata
         N"]
    NC -->|notification| EMAIL & MOBILEAPP & SLACK & OTHER
    S1 & S2 & SN -->|alert transition| NC
```

> Note that alerts are still triggered by Netdata agents. Netdata Cloud takes care of the notifications only.

### Configuration steps for standalone Netdata agents with Netdata Cloud

- Install Netdata agents using the commands given by Netdata Cloud, so that they will be automatically added to your Netdata Cloud space. Otherwise, install Netdata agents and then claim them via the command line or their dashboard.

- Optionally: disable their direct dashboard access to secure them.

- Optionally: disable their alert notifications to avoid receiving email notifications directly from them (email notifications are automatically enabled when a working MTA is found on the systems Netdata agents are installed).