@cryptotaxi247 / netdata
Code Commits Issues Pulls Sessions CI/CD
master
master
md 166 lines 5.62 KB
Rendered Raw
1 # Single Agent Deployment
2
3 The simplest way to use Netdata - install it, and you're monitoring. Each Agent works independently with zero configuration.
4
5 ## Single Agents With Netdata Cloud (Recommended)
6
7 Get the best experience - one dashboard for all your systems, mobile alerts, and team collaboration. Your data stays on your servers.
8
9 ### What You Get
10
11 | Feature | How it Works |
12 |---------------------------------|------------------------------------------|
13 | **Unified metrics dashboard** | ✓ See all Agents in one place |
14 | **Unified logs view** | ✓ Access all logs from Cloud |
15 | **Central alert configuration** | Each Agent still manages its own alerts |
16 | **Central notifications** | ✓ Cloud handles all notifications |
17 | **Data stays on-premise** | ✓ Cloud queries your Agents in real-time |
18
19 <details>
20 <summary><strong>Click to see visual representation of the architecture</strong></summary><br/>
21
22 ```mermaid
23 flowchart TB
24 NC("**Netdata Cloud**<br/>Unified dashboards<br/>Central notifications<br/>Access from anywhere")
25 Users("**One Dashboard**<br/>for all your systems")
26 Notifications("**Alert Notifications**<br/>Email, Slack, Mobile App")
27 Users <--> NC
28 NC --> Notifications
29
30 subgraph infrastructure["Your Infrastructure"]
31 direction TB
32 Agents("**Netdata Agents**<br/>Agent 1, Agent 2,<br/>Agent 3")
33 Data("**Your Metrics**<br/>Stay on your servers")
34 Agents <--> Data
35 end
36
37 NC <--> Agents
38
39 %% Style definitions
40 classDef alert fill:#ffeb3b, stroke:#000000, stroke-width:3px, color:#000000, font-size:18px
41 classDef neutral fill:#f9f9f9, stroke:#000000, stroke-width:3px, color:#000000, font-size:18px
42 classDef complete fill:#4caf50, stroke:#000000, stroke-width:3px, color:#000000, font-size:18px
43 classDef database fill:#2196F3, stroke:#000000, stroke-width:3px, color:#000000, font-size:18px
44
45 %% Apply styles
46 class Users alert
47 class Agents alert
48 class NC neutral
49 class Notifications neutral
50 class Data complete
51 class infrastructure database
52 ```
53
54 </details>
55
56 ### Setup
57
58 Getting started is simple:
59
60 1. **Sign up for Netdata Cloud** (it's free)
61 2. **Get your connection command** - Once logged in, you have three ways to get it:
62 - Navigate to **Space Settings** → **Nodes** → Click **"+"**
63 - Go to **Nodes** tab → Click **Add nodes**
64 - Visit **Integrations** page → Select your OS
65
66 3. **Run the installation command** that includes your unique claim token and room information
67
68 **What happens next:**
69
70 - The command automatically detects your OS
71 - Installs the latest Netdata Agent
72 - Connects to your Cloud Space
73 - Your node appears live in seconds
74 - Charts start streaming real-time data immediately
75
76 :::tip
77
78 Get detailed instructions on how to connect Agents to Cloud in our [Connect Agent to Cloud Guide](https://github.com/netdata/netdata/blob/master/src/claim/README.md).
79
80 :::
81
82 ### Optional Optimizations
83
84 - Disable local Agent notifications (Cloud handles them better)
85 - Restrict local dashboard access for security (use Cloud instead)
86
87 ## Single Agents Without Cloud
88
89 You can also run Agents independently, though you'll miss out on unified dashboards and mobile alerts.
90
91 <details>
92 <summary><strong>Click to see visual representation of standalone architecture</strong></summary><br/>
93
94 ```mermaid
95 flowchart TB
96 subgraph infrastructure["Your Infrastructure"]
97 direction TB
98 A1("**Agent 1**<br/>Independent monitoring")
99 A2("**Agent 2**<br/>Independent monitoring")
100 A3("**Agent 3**<br/>Independent monitoring")
101 D1("**Dashboard 1**<br/>:19999")
102 D2("**Dashboard 2**<br/>:19999")
103 D3("**Dashboard 3**<br/>:19999")
104 N1("**Alerts**<br/>Local notifications")
105 N2("**Alerts**<br/>Local notifications")
106 N3("**Alerts**<br/>Local notifications")
107 A1 --> D1
108 A2 --> D2
109 A3 --> D3
110 A1 --> N1
111 A2 --> N2
112 A3 --> N3
113 end
114
115 %% Style definitions matching the reference
116 classDef alert fill: #ffeb3b, stroke: #000000, stroke-width: 3px, color: #000000, font-size: 18px
117 classDef neutral fill: #f9f9f9, stroke: #000000, stroke-width: 3px, color: #000000, font-size: 18px
118 classDef complete fill: #4caf50, stroke: #000000, stroke-width: 3px, color: #000000, font-size: 18px
119 classDef database fill: #2196F3, stroke: #000000, stroke-width: 3px, color: #000000, font-size: 18px
120 %% Apply styles
121 class A1 alert
122 class A2 alert
123 class A3 alert
124 class D1 neutral
125 class D2 neutral
126 class D3 neutral
127 class N1 complete
128 class N2 complete
129 class N3 complete
130 class infrastructure database
131 ```
132
133 </details>
134
135 ### Setup
136
137 :::tip
138
139 Check the [Version & Platform](https://learn.netdata.cloud/docs/netdata-agent/versions-&-platforms) that's suitable for your needs and install the Agent.
140
141 :::
142
143 1. Install Netdata on each system
144 2. Access each dashboard at `http://agent-ip:19999`
145 3. Configure alerts individually on each Agent
146
147 ## When to Use Each Approach
148
149 **Use Cloud-connected Agents when:**
150
151 - You want one dashboard for everything
152 - You need mobile alerts
153 - Multiple people need access
154 - You're managing more than one system
155
156 **Use standalone Agents only when:**
157
158 - You have strict air-gapped requirements
159 - You're testing on a single system
160 - Cloud connectivity is not possible
161
162 :::note
163
164 Without Netdata Cloud, each Agent operates independently - you'll need to check multiple dashboards, configure alerts on each system separately, and won't receive mobile notifications. Cloud connection is free and keeps your data on-premise while providing a unified view.
165
166 :::