diff --git a/docs/Developer and Contributor Corner/REST API/Queries/Queries.mdx b/docs/Developer and Contributor Corner/REST API/Queries/Queries.mdx index bd4ea28edf..a8dba02e10 100644 --- a/docs/Developer and Contributor Corner/REST API/Queries/Queries.mdx +++ b/docs/Developer and Contributor Corner/REST API/Queries/Queries.mdx @@ -30,7 +30,7 @@ Every data query accepts the following parameters: |`points`|no|The number of points to be returned. Netdata can reduce number of points by applying query grouping methods. If not given, the result will have the same granularity as the database (although this relates to `gtime`).| |`before`|no|The absolute timestamp or the relative (to now) time the query should finish evaluating data. If not given, it defaults to the timestamp of the latest point in the database.| |`after`|no|The absolute timestamp or the relative (to `before`) time the query should start evaluating data. if not given, it defaults to the timestamp of the oldest point in the database.| -|`group`|no|The grouping method to use when reducing the points the database has. If not given, it defaults to `average`.| +|`group`|no|The grouping method to use when reducing the points the database has. If not given, it defaults to `average`. See [Grouping methods](#grouping-methods) for the full list, including `trimmed-mean`, `trimmed-median`, `percentile`, `countif`, and `extremes` variants.| |`gtime`|no|A resampling period to change the units of the metrics (i.e. setting this to `60` will convert `per second` metrics to `per minute`. If not given it defaults to granularity of the database.| |`options`|no|A bitmap of options that can affect the operation of the query. Only 2 options are used by the query engine: `unaligned` and `percentage`. All the other options are used by the output formatters. The default is to return aligned data.| |`dimensions`|no|A simple pattern to filter the dimensions to be queried. The default is to return all the dimensions of the chart.| @@ -129,6 +129,31 @@ and they group the values every `group points`. - ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=ses&after=-60&label=ses&value_color=brown) finds the exponential weighted moving average of the values - ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=des&after=-60&label=des&value_color=blue) applies Holt-Winters double exponential smoothing - ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=incremental_sum&after=-60&label=incremental_sum&value_color=red) finds the difference of the last vs the first value +- ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=countif&after=-60&label=countif&value_color=purple) returns the percentage (0 to 100) of values matching a condition set via `group_options` (e.g., `&group=countif&group_options=>10`) +- ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=ema&after=-60&label=ema&value_color=teal) alias for `ses`; finds the exponential weighted moving average of the values +- ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=extremes&after=-60&label=extremes&value_color=grey) returns the maximum of positive values and the minimum of negative values; when both are present, returns the one with the greater absolute magnitude +- ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=percentile&after=-60&label=percentile&value_color=olive) finds the value at a specific percentile (defaults to the 95th percentile; accepts `group_options` to specify a different percentile; `percentile50` is equivalent to median) +- ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=percentile95&after=-60&label=percentile95&value_color=olive) finds the value at the 95th percentile +- ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=percentile99&after=-60&label=percentile99&value_color=olive) finds the value at the 99th percentile +- ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=trimmed-mean&after=-60&label=trimmed-mean&value_color=maroon) finds the average after trimming outliers (defaults to trimming 5%; accepts `group_options` to specify a different percentage) +- ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=net.eth0&options=unaligned&dimensions=received&group=trimmed-median&after=-60&label=trimmed-median&value_color=navy) finds the median after trimming outliers (defaults to trimming 5%; accepts `group_options` to specify a different percentage) + +#### Percentile variants + +The following percentile methods are also available: `percentile25`, `percentile50` (equivalent to median), `percentile75`, `percentile80`, `percentile90`, `percentile95`, `percentile97`, `percentile98`, `percentile99`. The generic `percentile` method defaults to the 95th percentile and accepts `group_options` to specify a different percentile number. + +#### Trimmed variants + +The following trimmed-mean methods are available: `trimmed-mean1`, `trimmed-mean2`, `trimmed-mean3`, `trimmed-mean5`, `trimmed-mean10`, `trimmed-mean15`, `trimmed-mean20`, `trimmed-mean25`. The number indicates the percentage of values trimmed from each end. The generic `trimmed-mean` method defaults to trimming 5%. + +The following trimmed-median methods are available: `trimmed-median1`, `trimmed-median2`, `trimmed-median3`, `trimmed-median5`, `trimmed-median10`, `trimmed-median15`, `trimmed-median20`, `trimmed-median25`. + +#### group_options parameter + +Some grouping methods accept additional parameters via `group_options`: +- `countif`: A comparison operator followed by a value (e.g., `>100`, `\<=50`, `!=0`, `<:5`, `>:10`) +- `percentile`: A number from 1-99 specifying the percentile +- `trimmed-mean` / `trimmed-median`: A number specifying the percentage of values to trim from each end The examples shown above show live information from the `received` traffic on the `eth0` interface of the global Netdata Registry. Inspect any of the badges to see the parameters provided. You can directly issue the request to the Registry server's API yourself, e.g. by passing the following to get the value shown on the badge for the sum of the values within the period: diff --git a/docs/Getting Started.mdx b/docs/Getting Started.mdx index 5b32fc99b9..b30701d06d 100644 --- a/docs/Getting Started.mdx +++ b/docs/Getting Started.mdx @@ -295,7 +295,7 @@ Transform troubleshooting from complex queries to natural conversation. Ask ques
Model Context Protocol (MCP) Integration
-MCP is available via Netdata Cloud for infrastructure-wide access (Business/Homelab 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. +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. **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. diff --git a/docs/Netdata AI/MCP/MCP Clients/Claude Code.mdx b/docs/Netdata AI/MCP/MCP Clients/Claude Code.mdx index 511df1a36e..a70de45d19 100644 --- a/docs/Netdata AI/MCP/MCP Clients/Claude Code.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/Claude Code.mdx @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/docs/netdata-ai sidebar_label: "Claude Code" learn_status: "Published" learn_rel_path: "Netdata AI/MCP/MCP Clients" -sidebar_position: "60" +sidebar_position: "50" learn_link: "https://learn.netdata.cloud/docs/netdata-ai/mcp/mcp-clients/claude-code" slug: "/netdata-ai/mcp/mcp-clients/claude-code" --- @@ -46,7 +46,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP Clients/Claude Desktop.mdx b/docs/Netdata AI/MCP/MCP Clients/Claude Desktop.mdx index 1d66138861..208ac98db0 100644 --- a/docs/Netdata AI/MCP/MCP Clients/Claude Desktop.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/Claude Desktop.mdx @@ -64,7 +64,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP Clients/Crush.mdx b/docs/Netdata AI/MCP/MCP Clients/Crush.mdx index ff4962f285..9261af5a73 100644 --- a/docs/Netdata AI/MCP/MCP Clients/Crush.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/Crush.mdx @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/docs/netdata-ai sidebar_label: "Crush" learn_status: "Published" learn_rel_path: "Netdata AI/MCP/MCP Clients" -sidebar_position: "90" +sidebar_position: "80" learn_link: "https://learn.netdata.cloud/docs/netdata-ai/mcp/mcp-clients/crush" slug: "/netdata-ai/mcp/mcp-clients/crush" --- @@ -77,7 +77,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP Clients/Cursor.mdx b/docs/Netdata AI/MCP/MCP Clients/Cursor.mdx index e4390c05a6..bfc04267a7 100644 --- a/docs/Netdata AI/MCP/MCP Clients/Cursor.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/Cursor.mdx @@ -48,7 +48,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP Clients/Gemini CLI.mdx b/docs/Netdata AI/MCP/MCP Clients/Gemini CLI.mdx index f3d1825773..9bea835183 100644 --- a/docs/Netdata AI/MCP/MCP Clients/Gemini CLI.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/Gemini CLI.mdx @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/docs/netdata-ai sidebar_label: "Gemini CLI" learn_status: "Published" learn_rel_path: "Netdata AI/MCP/MCP Clients" -sidebar_position: "70" +sidebar_position: "60" learn_link: "https://learn.netdata.cloud/docs/netdata-ai/mcp/mcp-clients/gemini-cli" slug: "/netdata-ai/mcp/mcp-clients/gemini-cli" --- @@ -57,7 +57,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP Clients/JetBrains IDEs.mdx b/docs/Netdata AI/MCP/MCP Clients/JetBrains IDEs.mdx index 029ac6e3c9..3032a29ba3 100644 --- a/docs/Netdata AI/MCP/MCP Clients/JetBrains IDEs.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/JetBrains IDEs.mdx @@ -74,7 +74,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP Clients/Netdata Web Client.mdx b/docs/Netdata AI/MCP/MCP Clients/Netdata Web Client.mdx deleted file mode 100644 index 502cf06d7e..0000000000 --- a/docs/Netdata AI/MCP/MCP Clients/Netdata Web Client.mdx +++ /dev/null @@ -1,104 +0,0 @@ ---- -custom_edit_url: "https://github.com/netdata/netdata/edit/master/docs/netdata-ai/mcp/mcp-clients/netdata-web-client.md" -sidebar_label: "Netdata Web Client" -learn_status: "Published" -learn_rel_path: "Netdata AI/MCP/MCP Clients" -sidebar_position: "50" -learn_link: "https://learn.netdata.cloud/docs/netdata-ai/mcp/mcp-clients/netdata-web-client" -slug: "/netdata-ai/mcp/mcp-clients/netdata-web-client" ---- - -# Netdata Web Client - -A self-hosted AI chat interface purpose-built for infrastructure observability, featuring advanced cost optimization and multi-provider LLM support. - -![Netdata Web Client Interface](https://github.com/user-attachments/assets/f2facc59-66c1-4ea5-9404-d335e8f67ff2) - -## Purpose-Built for Observability - -The Netdata Web Client is an open-source browser-based AI assistant that connects directly to your Netdata infrastructure via MCP (Model Context Protocol). Unlike generic AI chat interfaces, it's specifically optimized for DevOps and SRE workflows with specialized system prompts and infrastructure-aware features. - -## Key Features - -### Multi-Provider LLM Support - -- **Unified Interface** - Switch between OpenAI (GPT-4), Anthropic (Claude), and Google (Gemini) models within the same conversation -- **Model Discovery** - Automatically detects available models from each provider -- **Provider Arbitrage** - Use cheaper models for simple queries, premium models for complex analysis - -### Advanced Cost Optimization - -- **Real-time Cost Tracking** - See exact costs per message and cumulative session costs -- **Token Accounting** - Detailed breakdown of input, output, cache read, and cache write tokens -- **Smart Context Management**: - - Automatic tool memory pruning after N conversation turns - - Large response summarization using cheaper models - - Configurable cache control strategies - - Auto-summarization when approaching context limits -- **Safety Limits** - Prevents runaway costs with iteration and request size limits - -### Infrastructure-Specific Features - -- **DevOps System Prompts** - Pre-configured for infrastructure monitoring and analysis -- **Time-Aware Analysis** - Understands relative time references ("last night", "this morning") -- **Multi-Chat Architecture** - Run parallel investigations in separate contexts -- **MCP WebSocket Integration** - Real-time connection to multiple Netdata instances - -### Professional Observability Workflow - -- **Persistent Conversations** - All chats auto-saved with full history -- **Accounting Logs** - JSONL export for cost analysis and auditing -- **Error Recovery** - Maintains state through API failures -- **Rich Formatting** - Markdown, code blocks, tables, and ASCII diagrams - -## Cost-Effective Infrastructure Analysis - -The web client's cost optimization features make AI-assisted troubleshooting affordable at scale: - -| Feature | Cost Impact | -|---------|------------| -| Tool Memory Window | -40% context size | -| Response Summarization | -60% for large outputs | -| Smart Caching | -30% for repetitive queries | -| Model Selection | -80% using appropriate models | - -## Get Started - -The complete source code, installation instructions, and documentation are available on GitHub: - -🔗 **[github.com/netdata/netdata/tree/master/src/web/mcp/mcp-web-client](https://github.com/netdata/netdata/tree/master/src/web/mcp/mcp-web-client)** - -### Quick Start - -```bash -# Clone and run locally -git clone https://github.com/netdata/netdata.git -cd netdata/src/web/mcp/mcp-web-client -node llm-proxy.js -# Open http://localhost:3456 in your browser -``` - -### Requirements - -- Node.js 18+ -- API keys from OpenAI, Anthropic, or Google -- Access to a Netdata instance with MCP enabled -- Modern web browser - -## Why Self-Host? - -- **Data Privacy** - Your infrastructure data never leaves your control -- **Cost Control** - Use your own API keys with transparent pay-per-use pricing -- **Customization** - Modify prompts and behavior for your specific needs -- **No Vendor Lock-in** - Switch LLM providers anytime - -## Ideal For - -- **Cost-Conscious Teams** - Pay only for what you use -- **Security-Focused Organizations** - Keep all data within your infrastructure -- **Advanced Users** - Full control over prompts and model selection -- **Multi-Cloud Environments** - Connect to multiple Netdata instances - ---- - -For detailed setup instructions, configuration options, and the complete feature list, visit the [GitHub repository](https://github.com/netdata/netdata/tree/master/src/web/mcp/mcp-web-client). diff --git a/docs/Netdata AI/MCP/MCP Clients/OpenAI Codex CLI.mdx b/docs/Netdata AI/MCP/MCP Clients/OpenAI Codex CLI.mdx index 53bee5fe3b..78d5b892ee 100644 --- a/docs/Netdata AI/MCP/MCP Clients/OpenAI Codex CLI.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/OpenAI Codex CLI.mdx @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/docs/netdata-ai sidebar_label: "OpenAI Codex CLI" learn_status: "Published" learn_rel_path: "Netdata AI/MCP/MCP Clients" -sidebar_position: "80" +sidebar_position: "70" learn_link: "https://learn.netdata.cloud/docs/netdata-ai/mcp/mcp-clients/openai-codex-cli" slug: "/netdata-ai/mcp/mcp-clients/openai-codex-cli" --- @@ -60,7 +60,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP Clients/OpenCode.mdx b/docs/Netdata AI/MCP/MCP Clients/OpenCode.mdx index 6df9a27bb3..a53eb43a71 100644 --- a/docs/Netdata AI/MCP/MCP Clients/OpenCode.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/OpenCode.mdx @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/docs/netdata-ai sidebar_label: "OpenCode" learn_status: "Published" learn_rel_path: "Netdata AI/MCP/MCP Clients" -sidebar_position: "100" +sidebar_position: "90" learn_link: "https://learn.netdata.cloud/docs/netdata-ai/mcp/mcp-clients/opencode" slug: "/netdata-ai/mcp/mcp-clients/opencode" --- @@ -66,7 +66,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP Clients/Visual Studio Code.mdx b/docs/Netdata AI/MCP/MCP Clients/Visual Studio Code.mdx index 4b92695522..d4dcbd8e68 100644 --- a/docs/Netdata AI/MCP/MCP Clients/Visual Studio Code.mdx +++ b/docs/Netdata AI/MCP/MCP Clients/Visual Studio Code.mdx @@ -60,7 +60,7 @@ or firewall changes needed. **Prerequisites:** -- Netdata Cloud account with Business plan +- Netdata Cloud account with a Paid plan - Nodes claimed to Netdata Cloud - API token with `scope:mcp` ([create one](/docs/netdata-cloud/authentication-&-authorization/api-tokens)) diff --git a/docs/Netdata AI/MCP/MCP.mdx b/docs/Netdata AI/MCP/MCP.mdx index 5350e6d814..2ccfda42ea 100644 --- a/docs/Netdata AI/MCP/MCP.mdx +++ b/docs/Netdata AI/MCP/MCP.mdx @@ -56,7 +56,7 @@ no local setup, no bridges, no firewall changes. ### Prerequisites -1. **Netdata Cloud account** with a **Business plan** +1. **Netdata Cloud account** with a **Paid plan** 2. **API token** with `scope:mcp` — [Create one in API Tokens settings](/docs/netdata-cloud/authentication-&-authorization/api-tokens) 3. **Nodes claimed to Netdata Cloud** — The Cloud MCP server can only access nodes @@ -171,7 +171,7 @@ Replace `YOUR_NETDATA_CLOUD_API_TOKEN` with your - Verify your API token has `scope:mcp` - Ensure the token is passed as `Authorization: Bearer ` (not as a query parameter) - Check that your Netdata Cloud subscription - includes a space in the Business plan + includes a space in a Paid plan #### No Nodes Visible @@ -646,7 +646,6 @@ For detailed configuration instructions for specific AI clients, see: - [Cursor](/docs/netdata-ai/mcp/mcp-clients/cursor) - AI-powered code editor - [Visual Studio Code](/docs/netdata-ai/mcp/mcp-clients/visual-studio-code) - VS Code with MCP support - [JetBrains IDEs](/docs/netdata-ai/mcp/mcp-clients/jetbrains-ides) - IntelliJ, PyCharm, WebStorm, etc. -- [Netdata Web Client](/docs/netdata-ai/mcp/mcp-clients/netdata-web-client) - Built-in web-based AI chat **DevOps Copilots:** - [Claude Code](/docs/netdata-ai/mcp/mcp-clients/claude-code) - Anthropic's CLI for Claude diff --git a/docs/Netdata Agent/Resource Utilization/RAM.mdx b/docs/Netdata Agent/Resource Utilization/RAM.mdx index 7c1cc35b31..584b35c564 100644 --- a/docs/Netdata Agent/Resource Utilization/RAM.mdx +++ b/docs/Netdata Agent/Resource Utilization/RAM.mdx @@ -63,6 +63,14 @@ memory = UNIQUE_METRICS x 16KiB + CONFIGURED_CACHES The default `CONFIGURED_CACHES` is 32MiB. +To determine `UNIQUE_METRICS` for your Agent, query the `/api/v3/info` endpoint: + +```bash +curl -s http://localhost:19999/api/v3/info | jq '.agents[0].metrics.collected' +``` + +This returns the number of unique time-series currently being collected. + For **one million concurrently collected time-series** (independently of their data collection frequency), **the required memory is 16 GiB**. In detail: ```text diff --git a/docs/Security and Privacy Design/Access Control and Feature Availability.mdx b/docs/Security and Privacy Design/Access Control and Feature Availability.mdx index db7b3589b1..a51a2a41e6 100644 --- a/docs/Security and Privacy Design/Access Control and Feature Availability.mdx +++ b/docs/Security and Privacy Design/Access Control and Feature Availability.mdx @@ -99,7 +99,7 @@ Functions provide on-demand, detailed information beyond standard metrics. Netdata provides MCP in two ways: -- **Netdata Cloud MCP** at `app.netdata.cloud/api/v1/mcp` — infrastructure-wide access to all your nodes (requires Business or Homelab plan) +- **Netdata Cloud MCP** at `app.netdata.cloud/api/v1/mcp` — infrastructure-wide access to all your nodes (requires a Paid plan) - **Agent/Parent MCP** — available directly at Netdata Agents and Parents, free and open-source When accessing Netdata via Agent/Parent MCP: diff --git a/docs/Welcome to Netdata/Enterprise Evaluation Guide.mdx b/docs/Welcome to Netdata/Enterprise Evaluation Guide.mdx index 2b441173d9..360a2e95d9 100644 --- a/docs/Welcome to Netdata/Enterprise Evaluation Guide.mdx +++ b/docs/Welcome to Netdata/Enterprise Evaluation Guide.mdx @@ -190,7 +190,7 @@ For logs, standard systemd-journal practices apply. For alert notifications, Netdata supports PagerDuty, Slack, Teams, email (SMTP), Discord, Telegram, Jira, ServiceNow, and custom webhooks. -For AI and Large Language Models, Netdata supports Model Context Protocol (MCP) — available via Netdata Cloud for infrastructure-wide access (Business/Homelab plan) and on every Agent/Parent for direct local access (free, open-source). Netdata supports AI DevOps/SRE Copilots like Claude Code and Gemini CLI, and provides an AI Chat application (access to Google, OpenAI, Anthropic LLMs is required). +For AI and Large Language Models, Netdata supports Model Context Protocol (MCP) — available via Netdata Cloud for infrastructure-wide access (Paid plan) and on every Agent/Parent for direct local access (free, open-source). Netdata supports AI DevOps/SRE Copilots like Claude Code and Gemini CLI, and provides an AI Chat application (access to Google, OpenAI, Anthropic LLMs is required). ## Compliance and Security diff --git a/docs/Welcome to Netdata/Fleet Deployment and Configuration Management.mdx b/docs/Welcome to Netdata/Fleet Deployment and Configuration Management.mdx index 0253166fc2..c9c8e424fd 100644 --- a/docs/Welcome to Netdata/Fleet Deployment and Configuration Management.mdx +++ b/docs/Welcome to Netdata/Fleet Deployment and Configuration Management.mdx @@ -203,8 +203,11 @@ The go.d.plugin provides auto-discovery for 150+ applications through multiple m - **[Docker container discovery](https://learn.netdata.cloud/docs/collecting-metrics/container-services/docker) (dockersd)** - Discovers applications running in Docker containers - **[Kubernetes service discovery](https://learn.netdata.cloud/docs/netdata-agent/installation/kubernetes) (k8ssd)** - Discovers services running in Kubernetes pods - **[SNMP device discovery](https://learn.netdata.cloud/docs/collecting-metrics/network-devices/snmp) (snmpsd)** - Discovers and profiles SNMP-enabled network devices +- **HTTP service discovery (http)** - Fetches JSON or YAML discovery items from an HTTP endpoint and creates collector jobs through service templates - **Configuration file scanning** - Detects applications based on their configuration files +HTTP service discovery templates must generate job configs with `name` and `module`. The `module` is the collector name, such as `httpcheck` or `ping`; it can be omitted only in curated rules where the service rule ID is the intended collector module. + **Platform-specific behavior**: **Linux systems (non-Kubernetes)**: diff --git a/docs/Welcome to Netdata/Reporting.mdx b/docs/Welcome to Netdata/Reporting.mdx index 4d9ec0a9f6..1369baf930 100644 --- a/docs/Welcome to Netdata/Reporting.mdx +++ b/docs/Welcome to Netdata/Reporting.mdx @@ -88,7 +88,7 @@ Connect your AI assistant directly to Netdata using the Model Context Protocol ( MCP is available in two ways: -- **Netdata Cloud MCP** at `app.netdata.cloud/api/v1/mcp` — infrastructure-wide access to all your nodes (Business/Homelab plan) +- **Netdata Cloud MCP** at `app.netdata.cloud/api/v1/mcp` — infrastructure-wide access to all your nodes (Paid plan) - **Agent/Parent MCP** on every Netdata Agent and Parent (v2.6.0+) — direct local access (free, open-source) AI assistants can query metrics, alerts, logs, and live system information across your entire infrastructure. @@ -129,7 +129,7 @@ Once connected, ask natural language questions: ### Availability -- **Cloud MCP**: Available on Business and Homelab plans — infrastructure-wide access, zero local setup +- **Cloud MCP**: Available on Paid plans — infrastructure-wide access, zero local setup - **Agent/Parent MCP**: Available on all plans (v2.6.0+) — free, open-source, direct local access - Unlimited queries with no per-query charges - Requires API key (Cloud token or local API key) for access diff --git a/docs/Welcome to Netdata/Welcome to Netdata.mdx b/docs/Welcome to Netdata/Welcome to Netdata.mdx index 4f4a726a8a..3b8c5431ca 100644 --- a/docs/Welcome to Netdata/Welcome to Netdata.mdx +++ b/docs/Welcome to Netdata/Welcome to Netdata.mdx @@ -24,6 +24,39 @@ The system consists of three components: - [**Netdata Parents**](/docs/netdata-parents): Optional centralization points for aggregating data from multiple agents (Netdata Parents are the same software component as Netdata Agents, configured as Parents) - [**Netdata Cloud**](/docs/netdata-cloud): A smart control plane for unifying multiple independent Netdata Agents and Parents, providing horizontal scalability, role based access control, access from anywhere, centralized alerts notifications, team collaboration, AI insights, and more. +The following diagram shows how Netdata components connect: + +```mermaid +flowchart TB + C1("Child Agent 1") + C2("Child Agent 2") + C3("Child Agent 3") + + P1("**Parent 1**") + P2("**Parent 2**") + + NC("**Netdata Cloud**
Dashboards, Alerts, AI") + + C1 -->|streaming| P1 + C2 -->|streaming| P1 + C3 -->|streaming| P2 + C2 -.->|failover| P2 + P1 <-->|replication| P2 + P1 <-->|ACLK| NC + P2 <-->|ACLK| NC + + classDef child fill: #e8f5e8, stroke: #27ae60, stroke-width: 2px, color: #2c3e50, rx: 10, ry: 10 + classDef parent fill: #f3e8ff, stroke: #9b59b6, stroke-width: 2px, color: #2c3e50, rx: 10, ry: 10 + classDef cloud fill: #e8f4fd, stroke: #4a90e2, stroke-width: 2px, color: #2c3e50, rx: 10, ry: 10 + + class C1 child + class C2 child + class C3 child + class P1 parent + class P2 parent + class NC cloud +``` + ## Performance at a Glance | Aspect | Netdata | Industry Standard | diff --git a/ingest/generated_map.yaml b/ingest/generated_map.yaml index bc16003da0..1700a563a9 100644 --- a/ingest/generated_map.yaml +++ b/ingest/generated_map.yaml @@ -6601,14 +6601,6 @@ description: null meta_yaml: .nan message: .nan -- custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/netdata-ai/mcp/mcp-clients/netdata-web-client.md - sidebar_label: Netdata Web Client - learn_status: Published - learn_rel_path: Netdata AI/MCP/MCP Clients - keywords: null - description: null - meta_yaml: .nan - message: .nan - custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/netdata-ai/mcp/mcp-clients/claude-code.md sidebar_label: Claude Code learn_status: Published diff --git a/ingest/one_commit_back_file-dict.yaml b/ingest/one_commit_back_file-dict.yaml index 7d63607d94..40a66a9faa 100644 --- a/ingest/one_commit_back_file-dict.yaml +++ b/ingest/one_commit_back_file-dict.yaml @@ -1366,8 +1366,6 @@ learn_path: /docs/netdata-ai/mcp/mcp-clients/openai-codex-cli - custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/netdata-ai/mcp/mcp-clients/jetbrains-ides.md learn_path: /docs/netdata-ai/mcp/mcp-clients/jetbrains-ides -- custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/netdata-ai/mcp/mcp-clients/netdata-web-client.md - learn_path: /docs/netdata-ai/mcp/mcp-clients/netdata-web-client - custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/netdata-ai/mcp/mcp-clients/claude-desktop.md learn_path: /docs/netdata-ai/mcp/mcp-clients/claude-desktop - custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/netdata-ai/mcp/mcp-clients/vs-code.md