summaryrefslogtreecommitdiffstats
path: root/debian/netdata-core.README.Debian
blob: 2215da21270536d4fa2eea8968242e5b1879ac22 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
netdata for Debian
==================

1. Web UI
---------

If you install netdata-web, the web UI will be available by default on
http://localhost:19999


2. Plugins
----------

netdata has a lot of plugins. Some of them need extra configuration on the
host system to work. Here are some notes for that...

2.1 mysql/mariadb
-----------------

netdata by default tries to read /etc/mysql/debian.cnf and use the
debian-sys-maint credentials to access the database.

For Debian 10 and older, you *could* (but shouldn't, see below) grant netdata
access to debian.cnf by setting the group ownership to netdata.

For Debian 11 and newer, the debian.cnf is no longer used.

Instead (and preferably also for Debian 10 and older), a dedicated read-only
database user should be created:

  $ sudo mariadb -u root
  MariaDB > create user 'netdata'@'localhost';
  MariaDB > grant usage on *.* to 'netdata'@'localhost';
  MariaDB > flush privileges;
  MariaDB > exit

Note that this will allow the netdata to connect to mariadb but *not* read
any data (which it does not need to).

Naming the user 'netdata' saves you from configuring anything in netdata itself
and it will automatically pick it up once the user has been created.

2.2 Bug: netdata doesn't start
------------------------------

If netdata does not start, there could be an upgrade issue from a previous version
leading to a corrupted internal database of the cached values in /var/cache/netdata.

Try purging the package reinstalling netdata:

  $ sudo apt remove --purge netdata-core
  $ sudo apt install netdata-core

 -- Daniel Baumann <daniel.baumann@progress-linux.org>  Tue, 09 Feb 2021 11:03:31 +0100