Address Learn feedback from users (#14802)
* Update collectors/charts.d.plugin/sensors/README.md * lint the file, and correct some mistypes * add suggestions and fix wording * cover feedback by users * fix broken link * Update invite-your-team.md
Fotis Voutsas committed
Mar 27, 2023 at 16:52 UTC
00fd201803e2e368e98f5903dbe037c2c55bd8af
6 files changed
+100
-131
claim/README.md
+54
-83
@@ -1,13 +1,3 @@
1
-<!--
2
-title: "Connect Agent to Cloud"
3
-description: "Connecting a Netdata Agent, running on a distributed node, to Netdata Cloud securely via the encrypted Agent-Cloud link (ACLK)."
4
-custom_edit_url: "https://github.com/netdata/netdata/edit/master/claim/README.md"
5
-sidebar_label: "Connect Agent to Cloud"
6
-learn_status: "Published"
7
-learn_topic_type: "Tasks"
8
-learn_rel_path: "Configuration"
9
--->
10
-
1
# Connect Agent to Cloud
2
3
You can securely connect a Netdata Agent, running on a distributed node, to Netdata Cloud. A Space's
@@ -34,31 +24,33 @@ Nodes** in the [Spaces management area](https://github.com/netdata/netdata/blob/
24
25
There are two important notes regarding connecting nodes:
26
37
-- _You can only connect any given node in a single Space_. You can, however, add that connected node to multiple War Rooms
27
+- _You can only connect any given node in a single Space_. You can, however, add that connected node to multiple War Rooms
28
within that one Space.
39
-- You must repeat the connection process on every node you want to add to Netdata Cloud.
29
+- You must repeat the connection process on every node you want to add to Netdata Cloud.
30
31
## How to connect a node
32
33
There will be three main flows from where you might want to connect a node to Netdata Cloud.
44
-* when you are on an [
45
-War Room](#empty-war-room) and you want to connect your first node
46
-* when you are at the [Manage Space](#manage-space-or-war-room) area and you select **Connect Nodes** to connect a node, coming from Manage Space or Manage War Room
47
-* when you are on the [Nodes view page](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/nodes.md) and want to connect a node - this process falls into the [Manage Space](#manage-space-or-war-room) flow
34
+
35
+- when you are on a [War Room](#empty-war-room) and you want to connect your first node
36
+- when you are at the [Manage Space](#manage-space-or-war-room) area and you select **Connect Nodes** to connect a node, coming from Manage Space or Manage War Room
37
+- when you are on the [Nodes view page](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/nodes.md) and want to connect a node - this process falls into the [Manage Space](#manage-space-or-war-room) flow
38
39
Please note that only the administrators of a Space in Netdata Cloud can view the claiming token and accompanying script, generated by Netdata Cloud, to trigger the connection process.
40
41
### Empty War Room
42
43
Either at your first sign in or following ones, when you enter Netdata Cloud and are at a War Room that doesn’t have any node added to it, you will be able to:
54
-* connect a new node to Netdata Cloud and add it to the War Room
55
-* add a previously connected node to the War Room
44
+
45
+- connect a new node to Netdata Cloud and add it to the War Room
46
+- add a previously connected node to the War Room
47
48
If your case is to connect a new node and add it to the War Room, you will need to tell us what environment the node is running on (Linux, Docker, macOS, Kubernetes) and then we will provide you with a script to initiate the connection process. You just will need to copy and paste it into your node's terminal. See one of the following sections depending on your case:
58
-* [Linux](#connect-an-agent-running-in-linux)
59
-* [Docker](#connect-an-agent-running-in-docker)
60
-* [macOS](#connect-an-agent-running-in-macos)
61
-* [Kubernetes](#connect-a-kubernetes-clusters-parent-netdata-pod)
49
+
50
+- [Linux](#connect-an-agent-running-in-linux)
51
+- [Docker](#connect-an-agent-running-in-docker)
52
+- [macOS](#connect-an-agent-running-in-macos)
53
+- [Kubernetes](#connect-a-kubernetes-clusters-parent-netdata-pod)
54
55
Repeat this process with every node you want to add to Netdata Cloud during onboarding. You can also add more nodes once you've
56
finished onboarding.
@@ -74,9 +66,10 @@ When coming from [Nodes view page](https://github.com/netdata/netdata/blob/mast
66
67
If you want to connect a node that is running on a Linux environment, the script that will be provided to you by Netdata Cloud is the [kickstart](https://github.com/netdata/netdata/blob/master/packaging/installer/README.md#automatic-one-line-installation-script) which will install the Netdata Agent on your node, if it isn't already installed, and connect the node to Netdata Cloud. It should be similar to:
68
77
-```
69
+```bash
70
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://api.netdata.cloud
71
```
72
+
73
The script should return `Agent was successfully claimed.`. If the connecting to Netdata Cloud process returns errors, or if you don't see
74
the node in your Space after 60 seconds, see the [troubleshooting information](#troubleshooting).
75
@@ -105,18 +98,18 @@ and run the script.
98
```bash
99
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://api.netdata.cloud
100
```
101
+
102
### Connect an agent running in Docker
103
104
To connect an instance of the Netdata Agent running inside of a Docker container, it is recommended that you follow
111
-the instructions and use the commands provided either in the `Nodes` tab of an [empty War Room](#empty-war-room) on Netdata Cloud or
112
-in the shelf that appears when you click **Connect Nodes** and select **Docker**.
105
+the instructions and use the commands provided either in the `Nodes` tab of an [empty War Room](#empty-war-room) on Netdata Cloud or
106
+in the shelf that appears when you click **Connect Nodes** and select **Docker**.
107
114
-However, users can also claim a new node by claiming environment variables in the container to have it automatically
108
+However, users can also claim a new node by claiming environment variables in the container to have it automatically
109
connected on startup or restart.
110
111
For the connection process to work, the contents of `/var/lib/netdata` _must_ be preserved across container
118
-restarts using a persistent volume. See our [recommended `docker run` and Docker Compose
119
-examples](https://github.com/netdata/netdata/blob/master/packaging/docker/README.md#create-a-new-netdata-agent-container) for details.
112
+restarts using a persistent volume. See our [recommended `docker run` and Docker Compose examples](https://github.com/netdata/netdata/blob/master/packaging/docker/README.md#create-a-new-netdata-agent-container) for details.
113
114
#### Known issues on older hosts with seccomp enabled
115
@@ -135,9 +128,9 @@ CONFIG_SECCOMP=y
128
129
To resolve the issue, do one of the following actions:
130
138
-- Update to a newer version of Docker and `libseccomp` (recommended).
139
-- Create a custom profile and pass it for the container.
140
-- Run [without the default seccomp profile](https://docs.docker.com/engine/security/seccomp/#run-without-the-default-seccomp-profile) (unsafe, not recommended).
131
+- Update to a newer version of Docker and `libseccomp` (recommended).
132
+- Create a custom profile and pass it for the container.
133
+- Run [without the default seccomp profile](https://docs.docker.com/engine/security/seccomp/#run-without-the-default-seccomp-profile) (unsafe, not recommended).
134
135
<details>
136
<summary>See how to create a custom profile</summary>
@@ -193,13 +186,13 @@ it will use these values to attempt to connect the container, automatically addi
186
Rooms. If a proxy is specified, it will be used for the connection process and for connecting to Netdata Cloud.
187
188
These variables can be specified using any mechanism supported by your container tooling for setting environment
196
-variables inside containers.
189
+variables inside containers.
190
191
When using the `docker run` command, if you have an agent container already running, it is important to know that there will be a short period of downtime. This is due to the process of recreating the new agent container.
192
193
The command to connect a new node to Netdata Cloud is:
194
202
-```bash
195
+```bash
196
docker run -d --name=netdata \
197
-p 19999:19999 \
198
-v netdataconfig:/etc/netdata \
@@ -219,10 +212,11 @@ docker run -d --name=netdata \
212
-e NETDATA_CLAIM_PROXY=PROXY \
213
netdata/netdata
214
```
222
->Note: This command is suggested for connecting a new container. Using this command for an existing container recreates the container, though data
223
-and configuration of the old container may be preserved. If you are claiming an existing container that can not be recreated,
215
+
216
+>Note: This command is suggested for connecting a new container. Using this command for an existing container recreates the container, though data
217
+and configuration of the old container may be preserved. If you are claiming an existing container that can not be recreated,
218
you can add the container by going to Netdata Cloud, clicking the **Nodes** tab, clicking **Connect Nodes**, selecting **Docker**, and following
225
-the instructions and commands provided or by following the instructions in an [empty War Room](#empty-war-room).
219
+the instructions and commands provided or by following the instructions in an [empty War Room](#empty-war-room).
220
221
The output that would be seen from the connection process when using other methods will be present in the container logs.
222
@@ -272,6 +266,7 @@ Then run the following command in the same directory as the `docker-compose.yml`
266
```bash
267
docker-compose up -d
268
```
269
+
270
#### Using docker exec
271
272
Connect a _running Netdata Agent container_, where you don't want to recreate the existing container, append the script offered by Netdata Cloud to a `docker exec ...` command, replacing
@@ -280,7 +275,8 @@ Connect a _running Netdata Agent container_, where you don't want to recreate th
275
```bash
276
docker exec -it netdata netdata-claim.sh -token=TOKEN -rooms=ROOM1,ROOM2 -url=https://api.netdata.cloud
277
```
283
-The values for `ROOM1,ROOM2` can be found by by going to Netdata Cloud, clicking the **Nodes** tab, clicking **Connect Nodes**, selecting **Docker**, and copying the `rooms=` value in the command provided.
278
+
279
+The values for `ROOM1,ROOM2` can be found by by going to Netdata Cloud, clicking the **Nodes** tab, clicking **Connect Nodes**, selecting **Docker**, and copying the `rooms=` value in the command provided.
280
281
The script should return `Agent was successfully claimed.`. If the connection process returns errors, or if
282
you don't see the node in your Space after 60 seconds, see the [troubleshooting information](#troubleshooting).
@@ -292,6 +288,7 @@ To connect a node that is running on a macOS environment the script that will be
288
```bash
289
curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --install-prefix /usr/local/ --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://api.netdata.cloud
290
```
291
+
292
The script should return `Agent was successfully claimed.`. If the connecting to Netdata Cloud process returns errors, or if you don't see
293
the node in your Space after 60 seconds, see the [troubleshooting information](#troubleshooting).
294
@@ -314,9 +311,9 @@ will also be used to tunnel the ACLK. The default `proxy` setting is `none`.
311
312
The `proxy` setting can take one of the following values:
313
317
-- `none`: Do not use a proxy, even if the system configured otherwise.
318
-- `env`: Try to read proxy settings from set environment variables `http_proxy`.
319
-- `http://[user:pass@]host:ip`: The ACLK and connection process will use the specified HTTP(S) proxy.
314
+- `none`: Do not use a proxy, even if the system configured otherwise.
315
+- `env`: Try to read proxy settings from set environment variables `http_proxy`.
316
+- `http://[user:pass@]host:ip`: The ACLK and connection process will use the specified HTTP(S) proxy.
317
318
For example, a HTTP proxy setting may look like the following:
319
@@ -345,15 +342,15 @@ address or hostname of your Agent. The returned JSON contains four keys that wil
342
might be having with the ACLK or connection process.
343
344
```json
348
- "cloud-enabled"
349
- "cloud-available"
350
- "agent-claimed"
351
- "aclk-available"
345
+ "cloud-enabled"
346
+ "cloud-available"
347
+ "agent-claimed"
348
+ "aclk-available"
349
```
350
354
-On Netdata agent version `1.32` (`netdata -v` to find your version) and newer, the `netdata -W aclk-state` command can be used to get some diagnostic information about ACLK. Sample output:
351
+On Netdata agent version `1.32` (`netdata -v` to find your version) and newer, `sudo netdatacli aclk-state` can be used to get some diagnostic information about ACLK. Sample output:
352
356
-```
353
+```bash
354
ACLK Available: Yes
355
ACLK Implementation: Next Generation
356
New Cloud Protocol Support: Yes
@@ -367,7 +364,7 @@ Use these keys and the information below to troubleshoot the ACLK.
364
365
#### kickstart: unsupported Netdata installation
366
370
-If you run the kickstart script and get the following error `Existing install appears to be handled manually or through the system package manager.` you most probably installed Netdata using an unsupported package.
367
+If you run the kickstart script and get the following error `Existing install appears to be handled manually or through the system package manager.` you most probably installed Netdata using an unsupported package.
368
369
If you are using an unsupported package, such as a third-party `.deb`/`.rpm` package provided by your distribution,
370
please remove that package and reinstall using our [recommended kickstart
@@ -380,6 +377,7 @@ If you run the kickstart script but don't have privileges required for the actio
377
```bash
378
Failed to write new machine GUID. Please make sure you have rights to write to /var/lib/netdata/registry/netdata.public.unique.id.
379
```
380
+
381
For a successful execution you will need to run the script with root privileges or run it with the user that is running the agent, more details on the [Connect an agent without root privileges](#connect-an-agent-without-root-privileges) section.
382
383
#### bash: netdata-claim.sh: command not found
@@ -435,20 +433,20 @@ installer's output should give you more error details.
433
434
You may see one of the following error messages during installation:
435
438
-- Failed to build libmosquitto. The install process will continue, but you will not be able to connect this node to
436
+- Failed to build libmosquitto. The install process will continue, but you will not be able to connect this node to
437
Netdata Cloud.
440
-- Unable to fetch sources for libmosquitto. The install process will continue, but you will not be able to connect
438
+- Unable to fetch sources for libmosquitto. The install process will continue, but you will not be able to connect
439
this node to Netdata Cloud.
442
-- Failed to build libwebsockets. The install process will continue, but you may not be able to connect this node to
440
+- Failed to build libwebsockets. The install process will continue, but you may not be able to connect this node to
441
Netdata Cloud.
444
-- Unable to fetch sources for libwebsockets. The install process will continue, but you may not be able to connect
442
+- Unable to fetch sources for libwebsockets. The install process will continue, but you may not be able to connect
443
this node to Netdata Cloud.
446
-- Could not find cmake, which is required to build libwebsockets. The install process will continue, but you may not
444
+- Could not find cmake, which is required to build libwebsockets. The install process will continue, but you may not
445
be able to connect this node to Netdata Cloud.
448
-- Could not find cmake, which is required to build JSON-C. The install process will continue, but Netdata Cloud
446
+- Could not find cmake, which is required to build JSON-C. The install process will continue, but Netdata Cloud
447
support will be disabled.
450
-- Failed to build JSON-C. Netdata Cloud support will be disabled.
451
-- Unable to fetch sources for JSON-C. Netdata Cloud support will be disabled.
448
+- Failed to build JSON-C. Netdata Cloud support will be disabled.
449
+- Unable to fetch sources for JSON-C. Netdata Cloud support will be disabled.
450
451
One common cause of the installer failing to build Cloud features is not having one of the following dependencies on
452
your system: `cmake`, `json-c` and `OpenSSL`, including corresponding `devel` packages.
@@ -555,6 +553,7 @@ To remove a node from you Space in Netdata Cloud, and connect it to another Spac
553
The node should now appear online in that Space.
554
555
## Connecting reference
556
+
557
In the sections below, you can find reference material for the kickstart script, claiming script, connecting via the Agent's command line
558
tool, and details about the files found in `cloud.d`.
559
@@ -568,32 +567,6 @@ using the [ACLK](https://github.com/netdata/netdata/blob/master/aclk/README.md).
567
| cloud base url | https://api.netdata.cloud | The URL for the Netdata Cloud web application. You should not change this. If you want to disable Cloud, change the `enabled` setting. |
568
| enabled | yes | The runtime option to disable the [Agent-Cloud link](https://github.com/netdata/netdata/blob/master/aclk/README.md) and prevent your Agent from connecting to Netdata Cloud. |
569
571
-### kickstart script
572
-
573
-The best way to install Netdata and connect your nodes to Netdata Cloud is with our automatic one-line installation script, [kickstart](https://github.com/netdata/netdata/blob/master/packaging/installer/README.md#automatic-one-line-installation-script). This script will install the Netdata Agent, in case it isn't already installed, and connect your node to Netdata Cloud.
574
-
575
-This works with:
576
-* most Linux distributions, see [Netdata's platform support policy](https://github.com/netdata/netdata/blob/master/packaging/PLATFORM_SUPPORT.md)
577
-* macOS
578
-
579
-For details on how to run this script please check [How to connect a node](#how-to-connect-a-node) and choose your environment.
580
-
581
-In case Netdata Agent is already installed and you run this script to connect a node to Netdata Cloud it will not upgrade your agent automatically. If you also want to upgrade the Agent installation you'll need to run the script again without the connection options.
582
-
583
-Our suggestion is to first run kickstart to upgrade your agent by running the command below and the run the [How to connect a node]
584
-(#how-to-connect-a-node).
585
-
586
-**Linux**
587
-
588
-```bash
589
-wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh
590
-```
591
-
592
-**macOS**
593
-
594
-```bash
595
-curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --install-prefix /usr/local/
596
-```
570
### Claiming script
571
572
A Space's administrator can also connect an Agent by directly calling the `netdata-claim.sh` script either with root privileges
@@ -659,5 +632,3 @@ Rooms you added that node to.
632
633
The user can also put the Cloud endpoint's full certificate chain in `cloud.d/cloud_fullchain.pem` so that the Agent
634
can trust the endpoint if necessary.
662
-
663
-
collectors/apps.plugin/README.md
+2
-1
@@ -9,7 +9,8 @@ learn_rel_path: "Integrations/Monitor/System metrics"
9
10
# Application monitoring (apps.plugin)
11
12
-`apps.plugin` breaks down system resource usage to **processes**, **users** and **user groups**.
12
+`apps.plugin` breaks down system resource usage to **processes**, **users** and **user groups**.
13
+It is enabled by default on every Netdata installation.
14
15
To achieve this task, it iterates through the whole process tree, collecting resource usage information
16
for every process found running.
collectors/charts.d.plugin/sensors/README.md
+14
-18
@@ -1,16 +1,7 @@
1
-<!--
2
-title: "Linux machine sensors monitoring with Netdata"
3
-custom_edit_url: "https://github.com/netdata/netdata/edit/master/collectors/charts.d.plugin/sensors/README.md"
4
-sidebar_label: "lm-sensors"
5
-learn_status: "Published"
6
-learn_topic_type: "References"
7
-learn_rel_path: "Integrations/Monitor/Devices"
8
--->
9
-
1
# Linux machine sensors collector
2
12
-Use this collector when `lm-sensors` doesn't work on your device (e.g. for RPi temperatures).
13
-For all other cases use the [Python collector](https://github.com/netdata/netdata/blob/master/collectors/python.d.plugin/sensors), which supports multiple
3
+Use this collector when `lm-sensors` doesn't work on your device (e.g. for RPi temperatures).
4
+For all other cases use the [Python collector](https://github.com/netdata/netdata/blob/master/collectors/python.d.plugin/sensors), which supports multiple
5
jobs, is more efficient and performs calculations on top of the kernel provided values.
6
7
This plugin will provide charts for all configured system sensors, by reading sensors directly from the kernel.
@@ -30,15 +21,23 @@ One chart for every sensor chip found and each of the above will be created.
21
22
## Enable the collector
23
33
-The `sensors` collector is disabled by default. To enable it, edit the `charts.d.conf` file using `edit-config` from the
34
-Netdata [config directory](https://github.com/netdata/netdata/blob/master/docs/configure/nodes.md), which is typically at `/etc/netdata`.
24
+The `sensors` collector is disabled by default.
25
+
26
+To enable the collector, you need to edit the configuration file of `charts.d/sensors.conf`. You can do so by using the `edit config` script.
27
+
28
+> ### Info
29
+>
30
+> To edit configuration files in a safe way, we provide the [`edit config` script](https://github.com/netdata/netdata/blob/master/docs/configure/nodes.md#use-edit-config-to-edit-configuration-files) located in your [Netdata config directory](https://github.com/netdata/netdata/blob/master/docs/configure/nodes.md#the-netdata-config-directory) (typically is `/etc/netdata`) that creates the proper file and opens it in an editor automatically.
31
+> It is recommended to use this way for configuring Netdata.
32
+>
33
+> Please also note that after most configuration changes you will need to [restart the Agent](https://github.com/netdata/netdata/blob/master/docs/configure/start-stop-restart.md) for the changes to take effect.
34
35
```bash
36
cd /etc/netdata # Replace this path with your Netdata config directory, if different
37
sudo ./edit-config charts.d.conf
38
```
39
41
-It also needs to be set to "force" to be enabled:
40
+You need to uncomment the regarding `sensors`, and set the value to `force`.
41
42
```shell
43
# example=force
@@ -47,8 +46,7 @@ sensors=force
46
47
## Configuration
48
50
-Edit the `charts.d/sensors.conf` configuration file using `edit-config` from the
51
-Netdata [config directory](https://github.com/netdata/netdata/blob/master/docs/configure/nodes.md), which is typically at `/etc/netdata`.
49
+Edit the `charts.d/sensors.conf` configuration file using `edit-config`:
50
51
```bash
52
cd /etc/netdata # Replace this path with your Netdata config directory, if different
@@ -79,5 +77,3 @@ sensors_excluded=()
77
```
78
79
---
82
-
83
-
collectors/diskspace.plugin/README.md
+23
-17
@@ -1,29 +1,37 @@
1
-<!--
2
-title: "Monitor disk (diskspace.plugin)"
3
-description: "Monitor the disk usage space of mounted disks in real-time with the Netdata Agent, plus preconfigured alarms for disks at risk of filling up."
4
-custom_edit_url: "https://github.com/netdata/netdata/edit/master/collectors/diskspace.plugin/README.md"
5
-sidebar_label: "Disks"
6
-learn_status: "Published"
7
-learn_topic_type: "References"
8
-learn_rel_path: "Integrations/Monitor/System metrics"
9
--->
10
-
1
# Monitor disk (diskspace.plugin)
2
3
This plugin monitors the disk space usage of mounted disks, under Linux. The plugin requires Netdata to have execute/search permissions on the mount point itself, as well as each component of the absolute path to the mount point.
4
5
Two charts are available for every mount:
6
17
-- Disk Space Usage
18
-- Disk Files (inodes) Usage
7
+- Disk Space Usage
8
+- Disk Files (inodes) Usage
9
10
## configuration
11
12
Simple patterns can be used to exclude mounts from showed statistics based on path or filesystem. By default read-only mounts are not displayed. To display them `yes` should be set for a chart instead of `auto`.
13
24
-By default, Netdata will enable monitoring metrics only when they are not zero. If they are constantly zero they are ignored. Metrics that will start having values, after Netdata is started, will be detected and charts will be automatically added to the dashboard (a refresh of the dashboard is needed for them to appear though). Set `yes` for a chart instead of `auto` to enable it permanently. You can also set the `enable zero metrics` option to `yes` in the `[global]` section which enables charts with zero metrics for all internal Netdata plugins.
14
+By default, Netdata will enable monitoring metrics only when they are not zero. If they are constantly zero they are ignored. Metrics that will start having values, after Netdata is started, will be detected and charts will be automatically added to the dashboard (a refresh of the dashboard is needed for them to appear though).
15
+
16
+To configure this plugin, you need to edit the configuration file `netdata.conf`. You can do so by using the `edit config` script.
17
+
18
+> ### Info
19
+>
20
+> To edit configuration files in a safe way, we provide the [`edit config` script](https://github.com/netdata/netdata/blob/master/docs/configure/nodes.md#use-edit-config-to-edit-configuration-files) located in your [Netdata config directory](https://github.com/netdata/netdata/blob/master/docs/configure/nodes.md#the-netdata-config-directory) (typically is `/etc/netdata`) that creates the proper file and opens it in an editor automatically.
21
+> It is recommended to use this way for configuring Netdata.
22
+>
23
+> Please also note that after most configuration changes you will need to [restart the Agent](https://github.com/netdata/netdata/blob/master/docs/configure/start-stop-restart.md) for the changes to take effect.
24
25
+```bash
26
+cd /etc/netdata # Replace this path with your Netdata config directory, if different
27
+sudo ./edit-config netdata.conf
28
```
29
+
30
+You can enable the effect of each line by uncommenting it.
31
+
32
+You can set `yes` for a chart instead of `auto` to enable it permanently. You can also set the `enable zero metrics` option to `yes` in the `[global]` section which enables charts with zero metrics for all internal Netdata plugins.
33
+
34
+```conf
35
[plugin:proc:diskspace]
36
# remove charts of unmounted disks = yes
37
# update every = 1
@@ -34,14 +42,12 @@ By default, Netdata will enable monitoring metrics only when they are not zero.
42
# inodes usage for all disks = auto
43
```
44
37
-Charts can be enabled/disabled for every mount separately:
45
+Charts can be enabled/disabled for every mount separately, just look for the name of the mount after `[plugin:proc:diskspace:`.
46
39
-```
47
+```conf
48
[plugin:proc:diskspace:/]
49
# space usage = auto
50
# inodes usage = auto
51
```
52
53
> for disks performance monitoring, see the `proc` plugin, [here](https://github.com/netdata/netdata/blob/master/collectors/proc.plugin/README.md#monitoring-disks)
46
-
47
-
docs/cloud/manage/invite-your-team.md
+6
-11
@@ -3,25 +3,20 @@
3
Invite new users to your Space by clicking on **Invite Users** in
4
the [Space](https://github.com/netdata/netdata/blob/master/docs/cloud/spaces.md) management area.
5
6
-
6
+
7
8
-Enter the email addresses for the users you want to invite to your Space. You can enter any number of email addresses,
9
-separated by a comma, to send multiple invitations at once.
8
+
9
+You will be prompted to enter the email addresses for the users you want to invite to your Space. You can enter any number of email addresses, separated by a comma, to send multiple invitations at once.
10
11
Next, choose the War Rooms you want to invite these users to. Once logged in, these users are not restricted only to
12
these War Rooms. They can be invited to others, or join any that are public.
13
14
+Next, pick a role for the invited user. You can read more about [which roles are available](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/role-based-access.md#what-roles-are-available) based on your [subscription plan](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/plans.md).
15
+
16
Click the **Send** button to send an email invitation, which will prompt them
17
to [sign up](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/sign-in.md) and join your Space.
18
17
-
19
+
20
21
Any unaccepted invitations remain under **Invitations awaiting response**. These invitations can be rescinded at any
22
time by clicking the trash can icon.
21
-
22
-## What's next?
23
-
24
-If your team members have trouble signing in, direct them to
25
-the [sign in guide](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/sign-in.md). Once your
26
-team is onboarded to Netdata Cloud, they can view shared assets, such
27
-as [new dashboards](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/dashboards.md).
packaging/installer/methods/ansible.md
+1
-1
@@ -50,7 +50,7 @@ minutes.
50
## Download and configure the playbook
51
52
First, download the
53
-[playbook](https://github.com/netdata/community/tree/main/netdata-agent-deployment/ansible-quickstart), move it to the
53
+[playbook](https://github.com/netdata/community/tree/main/configuration-management/ansible-quickstart/), move it to the
54
current directory, and remove the rest of the cloned repository, as it's not required for using the Ansible playbook.
55
56
```bash