Skip to content

Commit 30f97aa

Browse files
netdatabotgithub-actions[bot]
authored andcommitted
Ingest new documentation
1 parent 80671fe commit 30f97aa

4 files changed

Lines changed: 37 additions & 2 deletions

File tree

docs/Collecting Metrics/Collectors/Hardware and Sensors/Hardware information collected from kernel ring..mdx

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,15 @@ The default configuration for this integration is not expected to impose a signi
5959

6060
### Prerequisites
6161

62-
No action required.
62+
#### Install the Netdata Driver (netdata_driver.sys)
63+
64+
CPU temperature monitoring on Windows requires the Netdata kernel driver (`netdata_driver.sys`) to be installed on the host. The driver is an optional component and is not installed by default.
65+
66+
When you install Netdata with the Windows MSI installer, select the **Netdata Driver: Hardware Metrics Collection** option on the feature selection screen. If Netdata is already installed without the driver, the installer's Change/Modify option does not expose this checkbox again; uninstall Netdata first, then reinstall it and select the option during setup.
67+
68+
Editing `netdata.conf` alone is not enough. Without the driver, the `GetHardwareInfo` module cannot read the CPU `msr` register, so the `cpu.temperature` chart is never created and CPU temperature will not appear on the dashboard. The collector records an error in the Netdata log, but no temperature chart is produced.
69+
70+
6371

6472
### Configuration
6573

docs/Collecting Metrics/Collectors/Networking/tc QoS classes.mdx

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -180,3 +180,24 @@ Metrics:
180180
| tc.qos_dropped | Class Dropped Packets | a dimension per class | packets/s |
181181
| tc.qos_tokens | Class Tokens | a dimension per class | tokens |
182182
| tc.qos_ctokens | Class cTokens | a dimension per class | ctokens |
183+
184+
185+
186+
## Troubleshooting
187+
188+
### Recurring Cannot find file warnings for tc-qos-helper.conf
189+
190+
When `tc-qos-helper.sh` starts, it looks for its configuration in two places, in this order: the stock configuration directory (typically at `/usr/lib/netdata/conf.d`) and the user [config directory](/docs/netdata-agent/configuration) (typically at `/etc/netdata`). Netdata does not ship a stock `tc-qos-helper.conf`, so on a default installation neither file exists and the script emits a `Cannot find file` warning for each missing path.
191+
192+
These warnings are harmless. When no configuration file is found the script keeps its built-in defaults (for example `tc_show="qdisc"`). They reappear every hour because the script exits and is restarted by Netdata every 3600 seconds (`qos_exit_every=3600`), which re-runs the same checks on each start.
193+
194+
Creating `tc-qos-helper.conf` in your user config directory with the desired setting silences the warning for the user configuration path. The warning for the stock path is expected to remain, because no stock `tc-qos-helper.conf` ships with Netdata, and it is benign.
195+
196+
197+
### FireQOS is not installed warning
198+
199+
When `tc-qos-helper.sh` starts and cannot find FireQOS (neither the `/var/run/fireqos` directory nor the `fireqos` executable), it logs that FireQOS is not installed on this system. This is normal on systems that do not perform QoS traffic shaping with FireQOS.
200+
201+
Like the configuration warnings, this message repeats every hour because the script exits and is restarted by Netdata every 3600 seconds (`qos_exit_every=3600`), re-running the FireQOS presence check on each start.
202+
203+
FireQOS is only required to apply QoS and expose human-readable class names to Netdata. Without it the plugin still collects `tc` qdisc/class metrics directly from the `tc` command. To expose FireQOS class names, [install FireQOS](https://firehol.org/tutorial/fireqos-new-user/). To map numeric class IDs to readable names without FireQOS, list them in `/etc/iproute2/tc_cls` and set `tc_show="class"` in `tc-qos-helper.conf` in your user config directory.

docs/Collecting Metrics/Collectors/Operating Systems/System statistics.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -179,7 +179,7 @@ Labels:
179179

180180
| Label | Description |
181181
|:-----------|:----------------|
182-
| cpu | Identifier of the CPU core (e.g., core0, core1, core2). |
182+
| cpu | Identifier of the CPU core (e.g., cpu0, cpu1, cpu2). |
183183

184184
Metrics:
185185

docs/Network Performance Monitoring/Network Flows/Enrichment.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -359,6 +359,12 @@ See [Retention and querying](/docs/network-performance-monitoring/network-flows/
359359

360360
City-level GeoIP is accurate for many public IPs but wrong for VPNs, mobile carriers, and cloud-provider egress IPs (which often resolve to the cloud region's central city, not the actual user). Use country and state for trends; use city only after validating it for the prefix you care about. ASN ownership data also drifts companies merge, prefixes get reassigned. A database older than a quarter or two starts labelling reassigned prefixes with the previous owner.
361361

362+
### Private and non-routable IPs
363+
364+
CIDR-based enrichment is IP-agnostic. Both static `enrichment.networks` and dynamic `network_sources` match prefixes for any address RFC 1918 (`10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`), RFC 6598 carrier-grade NAT (`100.64.0.0/10`), and link-local (`169.254.0.0/16`) are matched the same way as public ranges. GeoIP databases carry no reliable country, city, or coordinate data for these addresses, and the ASN MMDB may render them as `AS0 Private IP Address Space` (see [AS numbers vs AS names](#as-numbers-vs-as-names)).
365+
366+
To label private-IP traffic, declare those ranges as `enrichment.networks` entries. The merge step overlays non-empty static fields (`name`, `role`, `site`, `region`, `tenant`, `country`, `city`, `latitude`, `longitude`) on top of the GeoIP base layer, so your operator-defined values replace whatever GeoIP produced or nothing at all. The `network_sources` jq schema earlier on this page applies the same pattern with `10.0.0.0/8` tagged `name: internal, role: lan`; static `networks` accepts those fields plus `latitude` and `longitude`. See the [Static Metadata](/docs/network-performance-monitoring/network-flows/enrichment-methods/static-metadata) integration card for configuration examples and the merge-order details.
367+
362368
### Sampling-rate knobs
363369

364370
Two related, easily confused knobs (set under `enrichment` in `netflow.yaml`):

0 commit comments

Comments
 (0)