Regenerate integrations docs (#21815)
Co-authored-by: ilyam8 <22274335+ilyam8@users.noreply.github.com>
Netdata bot committed
Feb 25, 2026 at 13:29 UTC
356b6eaae9d4ae8cd876e7fe027d071c3c20b572
3 files changed
+66
-3
src/go/plugin/go.d/collector/mysql/integrations/mariadb.md
+22
-1
@@ -529,10 +529,31 @@ To create the `netdata` user with these permissions, execute the following in th
529
FLUSH PRIVILEGES;
530
```
531
532
-The `netdata` user will have the ability to connect to the MySQL server on localhost without a password.
532
+The `netdata` user will have the ability to connect to the MySQL server on localhost without a password.
533
It will only be able to gather statistics without being able to alter or affect operations in any way.
534
535
536
+#### Enable User Statistics (optional)
537
+
538
+To collect per-user statistics, the [User Statistics](https://mariadb.com/docs/server/ha-and-performance/optimization-and-tuning/query-optimizations/statistics-for-optimizing-queries/user-statistics) plugin must be enabled.
539
+This is available for **MariaDB** and **Percona**, not for MySQL.
540
+
541
+By default, statistics are not collected. To enable the plugin, set the `userstat` system variable.
542
+
543
+- **In a configuration file** (persistent, requires restart):
544
+
545
+ ```ini
546
+ [mariadb]
547
+ userstat = 1
548
+ ```
549
+
550
+- **Dynamically** (takes effect immediately, does not persist across restarts):
551
+
552
+ ```mysql
553
+ SET GLOBAL userstat=1;
554
+ ```
555
+
556
+
557
558
### Configuration
559
src/go/plugin/go.d/collector/mysql/integrations/mysql.md
+22
-1
@@ -529,10 +529,31 @@ To create the `netdata` user with these permissions, execute the following in th
529
FLUSH PRIVILEGES;
530
```
531
532
-The `netdata` user will have the ability to connect to the MySQL server on localhost without a password.
532
+The `netdata` user will have the ability to connect to the MySQL server on localhost without a password.
533
It will only be able to gather statistics without being able to alter or affect operations in any way.
534
535
536
+#### Enable User Statistics (optional)
537
+
538
+To collect per-user statistics, the [User Statistics](https://mariadb.com/docs/server/ha-and-performance/optimization-and-tuning/query-optimizations/statistics-for-optimizing-queries/user-statistics) plugin must be enabled.
539
+This is available for **MariaDB** and **Percona**, not for MySQL.
540
+
541
+By default, statistics are not collected. To enable the plugin, set the `userstat` system variable.
542
+
543
+- **In a configuration file** (persistent, requires restart):
544
+
545
+ ```ini
546
+ [mariadb]
547
+ userstat = 1
548
+ ```
549
+
550
+- **Dynamically** (takes effect immediately, does not persist across restarts):
551
+
552
+ ```mysql
553
+ SET GLOBAL userstat=1;
554
+ ```
555
+
556
+
557
558
### Configuration
559
src/go/plugin/go.d/collector/mysql/integrations/percona_mysql.md
+22
-1
@@ -529,10 +529,31 @@ To create the `netdata` user with these permissions, execute the following in th
529
FLUSH PRIVILEGES;
530
```
531
532
-The `netdata` user will have the ability to connect to the MySQL server on localhost without a password.
532
+The `netdata` user will have the ability to connect to the MySQL server on localhost without a password.
533
It will only be able to gather statistics without being able to alter or affect operations in any way.
534
535
536
+#### Enable User Statistics (optional)
537
+
538
+To collect per-user statistics, the [User Statistics](https://mariadb.com/docs/server/ha-and-performance/optimization-and-tuning/query-optimizations/statistics-for-optimizing-queries/user-statistics) plugin must be enabled.
539
+This is available for **MariaDB** and **Percona**, not for MySQL.
540
+
541
+By default, statistics are not collected. To enable the plugin, set the `userstat` system variable.
542
+
543
+- **In a configuration file** (persistent, requires restart):
544
+
545
+ ```ini
546
+ [mariadb]
547
+ userstat = 1
548
+ ```
549
+
550
+- **Dynamically** (takes effect immediately, does not persist across restarts):
551
+
552
+ ```mysql
553
+ SET GLOBAL userstat=1;
554
+ ```
555
+
556
+
557
558
### Configuration
559