Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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.|
Expand Down Expand Up @@ -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:
Expand Down
2 changes: 1 addition & 1 deletion docs/Getting Started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -295,7 +295,7 @@ Transform troubleshooting from complex queries to natural conversation. Ask ques
<details>
<summary><strong>Model Context Protocol (MCP) Integration</strong></summary><br/>

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.

Expand Down
4 changes: 2 additions & 2 deletions docs/Netdata AI/MCP/MCP Clients/Claude Code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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"
---
Expand Down Expand Up @@ -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))
Expand Down
2 changes: 1 addition & 1 deletion docs/Netdata AI/MCP/MCP Clients/Claude Desktop.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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))
Expand Down
4 changes: 2 additions & 2 deletions docs/Netdata AI/MCP/MCP Clients/Crush.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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"
---
Expand Down Expand Up @@ -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))
Expand Down
2 changes: 1 addition & 1 deletion docs/Netdata AI/MCP/MCP Clients/Cursor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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))
Expand Down
4 changes: 2 additions & 2 deletions docs/Netdata AI/MCP/MCP Clients/Gemini CLI.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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"
---
Expand Down Expand Up @@ -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))
Expand Down
2 changes: 1 addition & 1 deletion docs/Netdata AI/MCP/MCP Clients/JetBrains IDEs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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))
Expand Down
104 changes: 0 additions & 104 deletions docs/Netdata AI/MCP/MCP Clients/Netdata Web Client.mdx

This file was deleted.

4 changes: 2 additions & 2 deletions docs/Netdata AI/MCP/MCP Clients/OpenAI Codex CLI.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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"
---
Expand Down Expand Up @@ -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))
Expand Down
4 changes: 2 additions & 2 deletions docs/Netdata AI/MCP/MCP Clients/OpenCode.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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"
---
Expand Down Expand Up @@ -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))
Expand Down
2 changes: 1 addition & 1 deletion docs/Netdata AI/MCP/MCP Clients/Visual Studio Code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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))
Expand Down
5 changes: 2 additions & 3 deletions docs/Netdata AI/MCP/MCP.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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 <token>` (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

Expand Down Expand Up @@ -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
Expand Down
8 changes: 8 additions & 0 deletions docs/Netdata Agent/Resource Utilization/RAM.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
2 changes: 1 addition & 1 deletion docs/Welcome to Netdata/Enterprise Evaluation Guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading