| 1 | # Getting Started with Netdata |
| 2 | |
| 3 | ## Transform Your Infrastructure Monitoring in Minutes, Not Weeks |
| 4 | |
| 5 | Netdata Cloud gives you complete visibility into every system and application performance metric across your entire infrastructure, whether it's on-premises or in the cloud. Bring teams together to find answers faster and squash the threat of anomalies or outages with composite charts, metric correlations, pre-built and custom dashboards, intelligent alarms, and collaboration tools to help you drive down your time to resolution. |
| 6 | |
| 7 | :::tip |
| 8 | |
| 9 | This guide will show you how simple it is to get started with Netdata and experience the instant value of real-time observability. |
| 10 | |
| 11 | ::: |
| 12 | |
| 13 | <!--unhideme |
| 14 | |
| 15 | <div |
| 16 | style={{ |
| 17 | width: '100%', |
| 18 | margin: '0 auto', |
| 19 | position: 'relative', |
| 20 | paddingBottom: '56.25%', // 16:9 aspect ratio |
| 21 | height: 0, |
| 22 | overflow: 'hidden', |
| 23 | borderRadius: '12px', |
| 24 | boxShadow: '0 4px 12px rgba(0, 0, 0, 0.1)', |
| 25 | }} |
| 26 | > |
| 27 | <iframe |
| 28 | src="https://www.youtube.com/embed/he-ysUlrZIw?si=e2SjkaRUGXyWcZwN" |
| 29 | style={{ |
| 30 | position: 'absolute', |
| 31 | top: 0, |
| 32 | left: 0, |
| 33 | width: '100%', |
| 34 | height: '100%', |
| 35 | border: 0, |
| 36 | borderRadius: '12px', |
| 37 | }} |
| 38 | allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" |
| 39 | allowFullScreen |
| 40 | loading="lazy" |
| 41 | title="Demo Video" |
| 42 | /> |
| 43 | </div> |
| 44 | |
| 45 | |
| 46 | unhideme--> |
| 47 | |
| 48 | ## [1. Sign in & Access Your Space](/src/claim/README.md) |
| 49 | |
| 50 | Getting started is as simple as visiting [app.netdata.cloud](https://app.netdata.cloud/) and creating your account. |
| 51 | |
| 52 | **What happens next:** |
| 53 | |
| 54 | - Your personalized Space is automatically created |
| 55 | - You get your central hub for all monitoring needs |
| 56 | - The dashboard is ready to receive your first node |
| 57 | |
| 58 | :::info |
| 59 | |
| 60 | **Why Cloud Connection is Essential:** Starting with Netdata v2.0, all dashboards use Netdata Cloud for authentication, providing enhanced security and unified experience across all platforms. This unlocks enterprise-grade monitoring capabilities for deployments of any size. |
| 61 | |
| 62 | ::: |
| 63 | |
| 64 | ## [2. Connect a Node & See Instant Results](/src/claim/README.md) |
| 65 | |
| 66 | **Connect Your First Agent** |
| 67 | Once logged into Netdata Cloud, you'll see connection instructions. There are three easy ways to connect: |
| 68 | |
| 69 | <details> |
| 70 | <summary><strong>Method 1: Through the Cloud Interface</strong></summary><br/> |
| 71 | |
| 72 | 1. Navigate to **Space Settings** (⚙️) on the left sidebar below the spaces list |
| 73 | 2. Select **Nodes** tab |
| 74 | 3. Click the **"+"** button to add a new node |
| 75 | 4. Copy and run the generated connection command |
| 76 | |
| 77 | </details> |
| 78 | |
| 79 | <details> |
| 80 | <summary><strong>Method 2: From the Nodes Tab</strong></summary><br/> |
| 81 | |
| 82 | 1. Go to the **Nodes** tab in your Room |
| 83 | 2. Click **Add nodes** button |
| 84 | 3. Follow the step-by-step instructions |
| 85 | |
| 86 | </details> |
| 87 | |
| 88 | <details> |
| 89 | <summary><strong>Method 3: Via Integrations Page</strong></summary><br/> |
| 90 | |
| 91 | 1. Visit the **Integrations** page |
| 92 | 2. Select your OS or container environment |
| 93 | 3. Execute the provided connection command |
| 94 | |
| 95 | </details> |
| 96 | |
| 97 | :::tip |
| 98 | |
| 99 | **The One-Command Solution:** |
| 100 | All methods will show you a command like this: |
| 101 | |
| 102 | ```bash |
| 103 | bash <(curl -Ss https://get.netdata.cloud/kickstart.sh) --claim-token YOUR_TOKEN --claim-rooms YOUR_ROOMS --claim-url https://app.netdata.cloud |
| 104 | ``` |
| 105 | |
| 106 | ::: |
| 107 | |
| 108 | :::info |
| 109 | |
| 110 | <details> |
| 111 | <summary><strong>What this single command does:</strong></summary><br/> |
| 112 | |
| 113 | - Automatically detects your operating system |
| 114 | - Installs the latest Netdata Agent |
| 115 | - Connects to your Cloud Space |
| 116 | - Starts monitoring immediately |
| 117 | |
| 118 | </details> |
| 119 | |
| 120 | ::: |
| 121 | |
| 122 | **What You'll See When Connected:** |
| 123 | |
| 124 | Within seconds of connection, you'll experience the power of real-time observability: |
| 125 | |
| 126 | - **Your node appears live in your Space** |
| 127 | - **Charts immediately start streaming real-time data** |
| 128 | - **System Overview dashboard populates automatically** |
| 129 | - **All metrics update with 1-second granularity** |
| 130 | - **Zero additional configuration required** |
| 131 | |
| 132 | ## [3. Analyze Your Data & See What You Get Out-of-the-Box](/docs/dashboards-and-charts/README.md) |
| 133 | |
| 134 | **Automatic Dashboards:** |
| 135 | |
| 136 | - **System Overview** - Fully automated dashboard showing all your nodes |
| 137 | - **Nodes Tab** - Unified view of all infrastructure with key metrics |
| 138 | - **Composite Charts** - Data from multiple nodes combined intelligently |
| 139 | - **Real-Time Updates** - Every metric updates with 1-second granularity |
| 140 | |
| 141 | **Auto-Discovery in Action:** |
| 142 | Netdata automatically discovers and monitors: |
| 143 | |
| 144 | - **System Resources** - CPU, memory, disk, network |
| 145 | - **Containers** - Docker, Kubernetes, LXC |
| 146 | - **Databases** - MySQL, PostgreSQL, MongoDB, Redis |
| 147 | - **Web Servers** - Apache, Nginx, IIS |
| 148 | - **Applications** - Over 1000+ integrations available |
| 149 | |
| 150 | **[Metric Correlations](/docs/metric-correlations.md):** |
| 151 | Click the correlation button on any chart to instantly find related metrics that help diagnose issues - turning complex troubleshooting into point-and-click simplicity. |
| 152 | |
| 153 | ## [4. Customize & Set New Alerts](/src/health/REFERENCE.md) |
| 154 | |
| 155 | **Out-of-the-Box Alerts:** |
| 156 | Netdata comes with intelligent alerts pre-configured for common issues. But you can easily customize them. |
| 157 | |
| 158 | **Simple Alert Customization:** |
| 159 | Navigate to your node and click "Edit" on any alert to modify thresholds: |
| 160 | |
| 161 | ```bash |
| 162 | # Example: Adjust CPU warning from 85% to 75% |
| 163 | warn: $this > 75 |
| 164 | crit: $this > 90 |
| 165 | ``` |
| 166 | |
| 167 | **Create New Alerts:** |
| 168 | |
| 169 | ```bash |
| 170 | # Example: Custom RAM alert |
| 171 | alarm: custom_ram_usage |
| 172 | on: system.ram |
| 173 | calc: $used * 100 / ($used + $free) |
| 174 | warn: $this > 80 |
| 175 | crit: $this > 95 |
| 176 | ``` |
| 177 | |
| 178 | **Notification Methods:** |
| 179 | Configure alerts to reach you through: |
| 180 | |
| 181 | - **Email** - Direct email notifications |
| 182 | - **Slack** - Team channel integration |
| 183 | - **PagerDuty** - Incident management |
| 184 | - **Microsoft Teams** - Workplace collaboration |
| 185 | - **Plus dozens more** - Webhooks, SMS, and custom integrations |
| 186 | |
| 187 | :::tip |
| 188 | |
| 189 | **Silencing Alerts:** Need to temporarily quiet alerts during maintenance? |
| 190 | |
| 191 | **Quick Silence Options:** |
| 192 | |
| 193 | - **Individual alerts** - Change `to: silent` in alert configuration |
| 194 | - **Specific alerts** - Edit `netdata.conf` with `enabled alarms = !alert_name *` (single) or `enabled alarms = !alert1 !alert2 *` (multiple — all exclusions before the wildcard), then restart the Agent |
| 195 | - **All alerts** - Set `enabled = no` in `[health]` section |
| 196 | |
| 197 | **Temporary Control:** Use the Health Management API for dynamic control without config changes - perfect for maintenance windows. |
| 198 | |
| 199 | **Permanent Solutions:** |
| 200 | |
| 201 | - **Disable specific alerts permanently** - Comment out alert definitions in health configuration files and reload with `sudo netdatacli reload-health` |
| 202 | - **Remove noisy alerts completely** - Delete unwanted alert configurations from `health.d/*.conf` files |
| 203 | |
| 204 | ::: |
| 205 | |
| 206 | ## [5. Organize Your Infrastructure & Invite Your Team](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md) |
| 207 | |
| 208 | **Spaces and Rooms:** |
| 209 | |
| 210 | - **Space** - Your main collaboration environment for the entire team |
| 211 | - **Rooms** - Flexible groupings within Spaces (by service, location, or purpose) |
| 212 | - **Example**: Create rooms for "Production", "Development", "Database Servers" |
| 213 | |
| 214 | **Team Collaboration:** |
| 215 | Click "Invite Users" in your Space sidebar to add team members. Set appropriate access levels: |
| 216 | |
| 217 | - **Admins** - Full control over Spaces, Rooms, and billing |
| 218 | - **Managers** - Room and user management |
| 219 | - **Troubleshooters** - Monitoring and analysis access |
| 220 | - **Observers** - View-only access to specific rooms |
| 221 | |
| 222 | :::tip |
| 223 | |
| 224 | **Role-Based Access Control (RBAC):** Paid plan subscribers get fine-grained control over who can access what data, execute functions, and modify configurations - perfect for teams with different responsibilities. |
| 225 | |
| 226 | ::: |
| 227 | |
| 228 | **Organize by Your Needs:** |
| 229 | |
| 230 | | **Category** | **Examples** | |
| 231 | | ------------------ | ------------------------------------ | |
| 232 | | **By Service** | Web servers, databases, applications | |
| 233 | | **By Location** | Data centers, cloud regions | |
| 234 | | **By Team** | DevOps, SRE, development teams | |
| 235 | | **By Environment** | Production, staging, development | |
| 236 | |
| 237 | ## What's the Value for You |
| 238 | |
| 239 | ### Experience the Difference with a Paid Plan |
| 240 | |
| 241 | **[Start Your Free Trial](https://netdata.cloud/pricing):** Experience the full power of Netdata with our free trial: |
| 242 | |
| 243 | - **No credit card required** - Start immediately |
| 244 | - **Full access to all features** - Nothing held back |
| 245 | - **Cancel anytime** - No commitments |
| 246 | - **[Expert support](https://www.netdata.cloud/support/)** - Get help when you need it |
| 247 | |
| 248 | ### Traditional Monitoring vs Netdata |
| 249 | |
| 250 | | **Traditional Monitoring** | | **Netdata** | |
| 251 | | ------------------------------------------------ | :----: | -------------------------------------------------- | |
| 252 | | **Navigate complex interfaces** during incidents | | **Get instant analysis** with natural language | |
| 253 | | **Build dashboards** during incidents | **VS** | **Automatic dashboards** with zero configuration | |
| 254 | | **Manually correlate data** across systems | | **AI-powered correlation** and root cause analysis | |
| 255 | | **Wait 15 seconds to 1 minute** for updates | | **Real-time 1-second granularity** | |
| 256 | | **Pay per metric with surprise bills** | | **70% less expensive than most competitors** | |
| 257 | |
| 258 | ### [AI Capabilities That Transform Operations](/docs/category-overview-pages/machine-learning-and-assisted-troubleshooting.md) |
| 259 | |
| 260 | Experience the future of infrastructure monitoring with AI that actually works. Chat with your infrastructure in natural language, get professional reports in minutes, and let machine learning find problems before they impact your users. From automated troubleshooting to predictive insights, Netdata's AI capabilities turn complex monitoring into simple conversations. |
| 261 | |
| 262 | **AI Features Overview:** |
| 263 | |
| 264 | | **Capability** | **What It Does** | **Access** | |
| 265 | | ------------------------ | ----------------------------------- | ------------------------------------ | |
| 266 | | **AI Chat with Netdata** | Ask questions in natural language | Available now for all deployments | |
| 267 | | **AI DevOps Copilot** | CLI-based AI automation | Available now with MCP tools | |
| 268 | | **AI Insights** | Professional reports in 2-3 minutes | Paid plans get unlimited reports | |
| 269 | | **Anomaly Advisor** | Find root causes in minutes | Available to all users | |
| 270 | | **ML Anomaly Detection** | Continuous anomaly detection | Free for everyone | |
| 271 | |
| 272 | #### Ask Questions & Get Answers |
| 273 | |
| 274 | <details> |
| 275 | <summary><strong>AI Chat with Netdata</strong></summary><br/> |
| 276 | |
| 277 | Transform troubleshooting from complex queries to natural conversation. Ask questions like "Which servers have high CPU usage?" or "Show database errors from last hour" or "What is wrong with my infrastructure now?" |
| 278 | |
| 279 | **Why this matters:** No more complex queries or dashboard hunting - get instant answers about performance, find specific logs, identify top resource consumers, or investigate issues through simple conversation. |
| 280 | |
| 281 | **How it works:** Multi-node visibility through Netdata Parents, flexible AI options including Claude, GPT-4, and Gemini, with real-time access to metrics, logs, processes, network connections, and system state. |
| 282 | |
| 283 | </details> |
| 284 | |
| 285 | <details> |
| 286 | <summary><strong>Model Context Protocol (MCP) Integration</strong></summary><br/> |
| 287 | |
| 288 | MCP is available via Netdata Cloud for infrastructure-wide access (Paid plan) and on every Agent/Parent for direct local access (free, open-source), enabling seamless integration with AI assistants for natural language queries and automated analysis. |
| 289 | |
| 290 | **Why this matters:** Use your existing AI tools or our standalone web chat with choice of AI providers. Query live metrics, logs, processes, network connections, and system state securely. |
| 291 | |
| 292 | **Technical details:** MCP integration via WebSocket/HTTP, choice of Claude, GPT-4, Gemini and others, multiple deployment options (Cloud MCP, Agent MCP, Parent MCP), real-time data access, secure connection where LLM has access to your data via the LLM client. |
| 293 | |
| 294 | </details> |
| 295 | |
| 296 | #### Automate & Optimize |
| 297 | |
| 298 | <details> |
| 299 | <summary><strong>AI DevOps Copilot</strong></summary><br/> |
| 300 | |
| 301 | Transform observability into action with CLI AI assistants. Combine the power of AI with system automation for intelligent infrastructure optimization. |
| 302 | |
| 303 | **Why this matters:** CLI-based AI assistants like Claude Code and Gemini CLI can access your Netdata metrics and execute commands, enabling observability-driven automation, automated troubleshooting, and configuration management driven by real observability data. |
| 304 | |
| 305 | **Key capabilities:** Observability-driven automation where AI analyzes metrics and executes fixes, infrastructure optimization with automatic tuning based on performance data, intelligent troubleshooting from problem detection to resolution, and AI-generated configs based on actual usage. |
| 306 | |
| 307 | </details> |
| 308 | |
| 309 | #### Analyze & Report |
| 310 | |
| 311 | <details> |
| 312 | <summary><strong>AI Insights - Professional Reports</strong></summary><br/> |
| 313 | |
| 314 | Generate comprehensive reports in 2-3 minutes that explain what happened, why it happened, and what to do about it. Transform past data into actionable insights with AI-generated reports. |
| 315 | |
| 316 | **Why this matters:** Perfect for capacity planning, performance reviews, and executive briefings. Get comprehensive analysis of your infrastructure trends, optimization opportunities, and future requirements in professionally formatted PDFs. |
| 317 | |
| 318 | **Four report types:** |
| 319 | |
| 320 | - **Infrastructure Summary** - Complete system health and incident analysis |
| 321 | - **Capacity Planning** - Growth projections and resource recommendations |
| 322 | - **Performance Optimization** - Bottleneck identification and tuning suggestions |
| 323 | - **Anomaly Analysis** - Deep dive into unusual patterns and their impacts |
| 324 | |
| 325 | **Access:** Paid plans get unlimited reports, free trial users get full access during trial, Community users get 10 free reports. |
| 326 | |
| 327 | </details> |
| 328 | |
| 329 | #### Detect Issues Automatically |
| 330 | |
| 331 | <details> |
| 332 | <summary><strong>Anomaly Advisor</strong></summary><br/> |
| 333 | |
| 334 | Revolutionary troubleshooting that finds root causes in minutes. Stop guessing what went wrong - the Anomaly Advisor instantly shows you how problems cascade across your infrastructure. |
| 335 | |
| 336 | **Why this matters:** Root causes typically appear in the top 20-30 results, turning hours of investigation into minutes of discovery. See cascading effects as anomalies propagate across systems with automatic ranking of every metric by anomaly severity. |
| 337 | |
| 338 | **Revolutionary approach:** Data-driven analysis with no hypotheses needed, influence tracking showing what influenced and what was influenced, works identically from 10 to 10,000 nodes, visual propagation of anomaly clusters and cascades. |
| 339 | |
| 340 | </details> |
| 341 | |
| 342 | <details> |
| 343 | <summary><strong>Machine Learning Anomaly Detection</strong></summary><br/> |
| 344 | |
| 345 | The foundation of Netdata's AI capabilities. Machine learning models run locally on every Agent, continuously learning normal patterns and detecting anomalies in real-time with zero configuration required. |
| 346 | |
| 347 | **Why this matters:** Automatic protection across every metric with ML analyzing all metrics continuously. Visual anomaly indicators show purple ribbons on every chart displaying anomaly rates, with ML scores saved with metrics for past analysis. |
| 348 | |
| 349 | **How it works:** Local ML engine runs on every Netdata Agent with no cloud dependency, multiple models use consensus approach reducing noise and false positives by 99%, integrated storage saves anomaly scores in database with metrics, designed for production environments with minimal overhead. |
| 350 | |
| 351 | </details> |
| 352 | |
| 353 | ### Join the Premium Experience |
| 354 | |
| 355 | :::tip |
| 356 | |
| 357 | **What Happens Next:** |
| 358 | |
| 359 | 1. **Sign up for your free trial** - No credit card required |
| 360 | 2. **Connect your Agents** - Use the simple one-command installation |
| 361 | 3. **Experience real-time observability** - 1-second granularity across all metrics |
| 362 | 4. **Try AI-powered features** - Chat with your infrastructure and generate insights |
| 363 | 5. **Build unlimited dashboards** - Create the monitoring views you need |
| 364 | 6. **Set up team access** - Invite colleagues and configure permissions |
| 365 | |
| 366 | **Transform your infrastructure monitoring today. Your future self and your team will thank you.** |
| 367 | |
| 368 | **[Start Free Trial](https://netdata.cloud/pricing)** |
| 369 | |
| 370 | ::: |