Skip to content

Ingest New Documentation #2989

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ilyam8 merged 1 commit into from
Aug 20, 2026
Merged

Ingest New Documentation #2989

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
2 changes: 1 addition & 1 deletion docs/Collecting Metrics/Collectors/Databases/ClickHouse.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -289,7 +289,7 @@ Metrics:
| clickhouse.io_seeks | lseek function calls | lseek | ops/s |
| clickhouse.io_file_opens | File opens | file_open | ops/s |
| clickhouse.replicated_parts_current_activity | Replicated parts current activity | fetch, send, check | parts |
| clickhouse.replicas_max_absolute_dela | Replicas max absolute delay | replication_delay | seconds |
| clickhouse.replicas_max_absolute_delay | Replicas max absolute delay | replication_delay | seconds |
| clickhouse.replicated_readonly_tables | Replicated tables in readonly state | read_only | tables |
| clickhouse.replicated_data_loss | Replicated data loss | data_loss | events |
| clickhouse.replicated_part_fetches | Replicated part fetches | successful, failed | fetches/s |
Expand Down
176 changes: 145 additions & 31 deletions docs/Collecting Metrics/Collectors/Databases/Microsoft SQL Server.mdx
View file
Open in desktop

Large diffs are not rendered by default.

23 changes: 14 additions & 9 deletions docs/Collecting Metrics/Collectors/Storage and Filesystems/Ceph Prometheus.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,14 +34,17 @@ The built-in profile separates cluster-wide MGR health, quorum, capacity, placem
from host-local `ceph-exporter` daemon availability and MON, MGR, OSD, and RGW performance. Optional branches cover
CephFS/MDS and CephFS Mirror, RBD images, RBD Mirror, SMB, NVMe-oF, RGW user/bucket/topic/cache/multisite and dmClock
scheduling, RocksDB binned caches, external block devices, and Ceph client I/O across Reef 18.2.8, Squid 19.2.5,
and Tentacle 20.2.2. PG state flags and RGW global/user/bucket views are overlapping diagnostic populations and are
not additive totals. Profile relabeling turns dynamic MDS-client, librbd ImageCtx/PWL, ObjectCacher, objecter, RocksDB
cache, Finisher, Throttle, KernelDevice, mClock, messenger, RDMA, DPDK, and service-identity family names into stable
profile inputs while preserving their source keys as identity labels. The source-complete profile materializes the
entire declared release/producer union with zero generic fallback. Unknown future Ceph families remain visible
through generic fallback until their source semantics can be curated; generic visibility is a forward-compatibility
guard, not evidence that a known source family was fully modeled. The profile drops only the source-proven
raw MGR RGW source-zone aliases because the stable normalized family is already charted.
and Tentacle 20.2.2. On Tentacle, the endpoints also expose primary-OSD PG-rebuild duration, while the MGR additionally
exposes cephadm node-proxy CPU, memory, storage, cooling, temperature, and per-component health metrics. Firmware
remains source metadata and is not charted because Ceph exposes it as an info family. PG state flags and RGW
global/user/bucket views are overlapping diagnostic populations and are not additive totals. Profile relabeling
turns dynamic MDS-client, librbd ImageCtx/PWL, ObjectCacher, objecter, RocksDB cache, Finisher, Throttle, KernelDevice,
mClock, messenger, RDMA, DPDK, and service-identity family names into stable profile inputs while preserving their
source keys as identity labels. The source-complete profile materializes the entire declared release/producer union
with zero generic fallback. Unknown future Ceph families remain visible through generic fallback until their source
semantics can be curated; generic visibility is a forward-compatibility guard, not evidence that a known source
family was fully modeled. The profile drops only the source-proven raw MGR RGW source-zone aliases because the stable
normalized family is already charted.

The chart model follows the producer's source lifecycle rather than relying on Prometheus wire type alone. Current
populations that Ceph increments and decrements remain absolute, while cumulative work published through gauges is
Expand Down Expand Up @@ -102,7 +105,9 @@ UI configuration requires paid Netdata Cloud plan.
Enable the [Ceph MGR Prometheus module](https://docs.ceph.com/en/latest/mgr/prometheus/) for cluster metrics or
deploy the official `ceph-exporter` for host-local daemon performance metrics. The stock profile supports the
default priority threshold and the complete priority-0 surface; use `exporter_prio_limit=0` when those diagnostic
counters are required and size the job limits for the resulting series count.
counters are required and size the job limits for the resulting series count. When cephadm node-proxy hardware
reporting is enabled, hardware series scale with the cluster-wide component inventory; size both
`max_time_series` and `max_time_series_per_metric` for that surface.



Expand Down
2 changes: 1 addition & 1 deletion docs/Netdata Agent/Installation/Linux/Linux.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ The user running the script needs write and execute permissions in the temporary
Before running the installation script, you can verify its integrity using the following command:

```bash
[ "8c1033d55647703bcea79e2de95d3f04" = "$(curl -Ss https://get.netdata.cloud/kickstart.sh | md5sum | cut -d ' ' -f 1)" ] && echo "OK, VALID" || echo "FAILED, INVALID"
[ "0643708c33f613ea078ee711b25801ae" = "$(curl -Ss https://get.netdata.cloud/kickstart.sh | md5sum | cut -d ' ' -f 1)" ] && echo "OK, VALID" || echo "FAILED, INVALID"
```

If the script is valid, this command will return `OK, VALID`. We recommend verifying script integrity before installation, especially in production environments.
Expand Down
62 changes: 59 additions & 3 deletions docs/Netdata Agent/Installation/Windows/Windows.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,11 +60,15 @@ Use silent mode to deploy Netdata without user interaction. Run the command prom
| `/qn` | Enables silent mode (no user interaction) |
| `/i` | Specifies the path to the MSI installer |
| `TOKEN=` | Claim token from your Netdata Cloud Space |
| `ROOMS=` | Comma-separated Room IDs for your node |
| `ROOMS=` | (Optional) Comma-separated Room IDs for your node |
| `PROXY=` | (Optional) Proxy address if required |
| `INSECURE=1` | (Optional) Allow insecure connections (hostname verification disabled) |
| `REINSTALL=ALL` | (Optional) It forces a complete reinstallation of all Netdata components. |

`TOKEN=` is the only option required to connect the Agent to your Space. When you omit `ROOMS=`, the
node is added to your Space and appears under **All nodes**; you can move it into Rooms later from the
Netdata Cloud UI.

### Example Command

Install Netdata and connect to your Cloud Space:
Expand All @@ -78,6 +82,12 @@ Replace:
- `<YOUR_TOKEN>` with your claim token
- `<YOUR_ROOMS>` with your Room ID(s)

To connect the node without assigning it to specific Rooms, pass the token alone:

```bash
msiexec /qn /i netdata-x64.msi TOKEN="<YOUR_TOKEN>"
```

### Download & Install in One Command (PowerShell)

```powershell
Expand All @@ -97,8 +107,8 @@ During the wizard you'll see a **Connect to the Cloud** dialog. These fields reg

| Field | What it's for |
|-------------|---------------------------------------------------------------------------------------------------|
| Claim Token | The claim token from your Netdata Cloud Space. |
| Rooms ID(s) | The Room(s) you want to add this Agent to. |
| Claim Token | The claim token from your Netdata Cloud Space. This is the only required field. |
| Rooms ID(s) | (Optional) The Room(s) you want to add this Agent to. Leave empty to use **All nodes**. |
| Proxy URL | (Optional) A proxy address, if your network requires one to reach Netdata Cloud. |
| Cloud URL | The Netdata Cloud endpoint. Defaults to `https://app.netdata.cloud`. |
| Insecure | (Optional) Disables TLS hostname verification when the Agent contacts the Netdata Cloud endpoint. |
Expand All @@ -121,6 +131,52 @@ See the [Parent-Child Configuration Reference](/docs/netdata-parents/parent-chil

:::

### Where the claim settings are stored

The values you enter in the claim dialog (or pass to `msiexec`) are written to:

```text
C:\Program Files\Netdata\etc\netdata\claim.conf
```

The Agent reads this file on startup and connects to your Space. After a successful connection it also
records the resulting identity in `C:\Program Files\Netdata\var\lib\netdata\cloud.d\cloud.conf`.

### Connect a node that was installed without a token

If the Agent is installed but not connected — no `claim.conf` exists, or it was installed without a
token — you don't need to uninstall or reboot. Create the file yourself and restart the service.

1. Open Notepad **as Administrator**.
2. Create `C:\Program Files\Netdata\etc\netdata\claim.conf` with this content, replacing
`<YOUR_TOKEN>` with your claim token:

```text
[global]
url = https://app.netdata.cloud
token = <YOUR_TOKEN>
# rooms =
# proxy =
insecure = no
```

Set `rooms` to a comma-separated list of Room IDs if you want the node placed in specific Rooms, and
set `proxy` if your network requires one to reach Netdata Cloud. Both lines are optional — leave them
commented out to connect with defaults.

3. Restart the Agent from an Administrator PowerShell prompt:

```powershell
Restart-Service Netdata
```

The node should appear in your Space within a few seconds. If it does not, the Agent reports the
claiming result to the Windows Event Log — a rejected or expired token is reported there:

```powershell
Get-WinEvent -LogName 'Netdata/Daemon' -MaxEvents 50 | Where-Object { $_.Message -match 'CLAIM' }
```

## Offline (Air-gapped) Installation

Use this method to install Netdata on a Windows system with no internet access.
Expand Down
27 changes: 14 additions & 13 deletions docs/Netdata Agent/Versions & Platforms.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,8 +80,6 @@ Our [static builds](#static-builds) are expected to work on these platforms if a
| Alma Linux | 9.x | x86\_64, AArch64 | Also includes support for Rocky Linux and other ABI compatible RHEL derivatives |
| Alma Linux | 8.x | x86\_64, AArch64 | Also includes support for Rocky Linux and other ABI compatible RHEL derivatives |
| Amazon Linux | 2023 | x86\_64, AArch64 | |
| Amazon Linux | 2 | x86\_64, AArch64 | |
| CentOS | 7.x | x86\_64 | |
| Docker | 19.03 or newer | x86\_64, ARMv7, AArch64 | See our [Docker documentation](/docs/netdata-agent/installation/docker) for more info on using Netdata on Docker |
| Debian | 13.x | x86\_64, i386, ARMv7, AArch64 | |
| Debian | 12.x | x86\_64, i386, ARMv7, AArch64 | |
Expand All @@ -93,14 +91,13 @@ Our [static builds](#static-builds) are expected to work on these platforms if a
| Oracle Linux | 10.x | x86\_64, AArch64 | |
| Oracle Linux | 9.x | x86\_64, AArch64 | |
| Oracle Linux | 8.x | x86\_64, AArch64 | |
| Red Hat Enterprise Linux | 10.x | x86\_64, AArch64 | |
| Red Hat Enterprise Linux | 9.x | x86\_64, AArch64 | |
| Red Hat Enterprise Linux | 8.x | x86\_64, AArch64 | |
| Red Hat Enterprise Linux | 7.x | x86\_64 | |
| Rocky Linux | 10.x | x86\_64, AArch64 | Also includes support for Alma Linux and other ABI compatible RHEL derivatives |
| Rocky Linux | 9.x | x86\_64, AArch64 | Also includes support for Alma Linux and other ABI compatible RHEL derivatives |
| Rocky Linux | 8.x | x86\_64, AArch64 | Also includes support for Alma Linux and other ABI compatible RHEL derivatives |
| Ubuntu | 26.04 | x86\_64, AArch64, ARMv7 | |
| Ubuntu | 25.10 | x86\_64, AArch64, ARMv7 | |
| Ubuntu | 24.04 | x86\_64, AArch64, ARMv7 | |
| Ubuntu | 22.04 | x86\_64, ARMv7, AArch64 | |

Expand Down Expand Up @@ -184,15 +181,19 @@ Platforms that meet these criteria will be immediately transitioned to the **Pre

This is a list of platforms that we have supported in the recent past but no longer officially support:

| Platform | Version | Notes |
|----------|-----------|----------------------|
| Debian | 10.x | EOL as of 2024-07-01 |
| Fedora | 42 | EOL as of 2026-05-13 |
| Fedora | 41 | EOL as of 2025-12-15 |
| openSUSE | Leap 15.6 | EOL as of 2026-04-30 |
| Ubuntu | 25.04 | EOL as of 2026-01-17 |
| Ubuntu | 20.04 | EOL as of 2025-05-31 |
| Ubuntu | 18.04 | EOL as of 2023-04-02 |
| Platform | Version | Notes |
|--------------------------|-----------|----------------------|
| Amazon Linux | 2 | EOL as of 2026-06-30 |
| CentOS | 7.x | EOL as of 2026-06-30 |
| Debian | 10.x | EOL as of 2024-07-01 |
| Fedora | 42 | EOL as of 2026-05-13 |
| Fedora | 41 | EOL as of 2025-12-15 |
| openSUSE | Leap 15.5 | EOL as of 2024-12-31 |
| Red Hat Enterprise Linux | 7.x | EOL as of 2026-06-30 |
| Ubuntu | 18.04 | EOL as of 2023-04-02 |
| Ubuntu | 25.04 | EOL as of 2026-01-17 |
| Ubuntu | 20.04 | EOL as of 2025-05-31 |
| Ubuntu | 18.04 | EOL as of 2023-04-02 |

## Static builds

Expand Down
28 changes: 28 additions & 0 deletions docs/Netdata Cloud On-Prem/Release Notes.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,34 @@ slug: "/netdata-cloud-on-prem/release-notes"

# Release notes

## 2.6.0 (2026-08-20)

### Features

- Introduced AI features on on-prem, powered by the new `cloud-insights-service`: conversations grounded in your charts and alerts, generated investigation reports, and MCP client support
- Home page revamp with nodes grouped into hexagons, selectable grouping and sorting, and significantly faster loading
- Introduced Nodes fleet operations views for inspecting and acting on the fleet at scale
- Introduced alerts history and detection of misconfigured alerts
- Silencing rules improvements: timezone selector, active/inactive distinction, automatic deletion on expiration, and correct handling of multi-day recurring windows
- Custom dashboards: import/export, playlist mode, and new cards including state timeline and alert count
- New visualizations: heatmap charts, a geomap of node locations, topology maps with network flows, and an SNMP overview tab
- Added Group Email notification integration, a space-wide channel delivering alert notifications to a single mailing-list address
- Alert and reachability notifications now include host labels, and Slack/Mattermost notifications show message previews
- Scaling and performance: Nodes and Alerts now handle rooms of up to 50,000 nodes, and data queries use less memory and return faster
- New cronjobs notify about misconfigured alerts and clean up expired silencing rules
- Replaced the Help & Resources panel with the Nedi AI assistant
- Improved the global date picker
- SCIM filter matching and sorting are now case-insensitive, per RFC
- Hardened rate limiting for Agent authentication

### Bug fixes

- Dyncfg: fixed job list corruption with slashes in names, invalid request timeouts, and checkbox rendering
- Fixed percentage aggregation returning incorrect values on empty points and on multi-agent queries
- Fixed joining a space from an invitation link
- SCIM: SSO-to-SCIM mapping now compares emails case-insensitively, and `idp-default` attributes are accepted
- Node recreation flow stability improvements

## 2.5.0 (2026-03-13)

### Features
Expand Down
Loading