Update README.md
Costa Tsaousis committed
Oct 9, 2023 at 00:48 UTC
25e8a53dcb3d4deb5d70316e47cb1141391b8d9e
1 file changed
+8
collectors/systemd-journal.plugin/README.md
+8
@@ -32,12 +32,20 @@ For more information check [this discussion](https://github.com/netdata/netdata/
32
33
### Limitations
34
35
+The following are limitations related to the availability of the plugin:
36
+
37
- This plugin is not available when Netdata is installed in a container. The problem is that `libsystemd` is not available in Alpine Linux (there is a `libsystemd`, but it is a dummy that returns failure on all calls). We plan to change this, by shipping Netdata containers based on Debian.
38
- For the same reason (lack of `systemd` support for Alpine Linux), the plugin is not available on `static` builds of Netdata (which are based on `muslc`, not `glibc`).
39
- On old systemd systems (like Centos 7), the plugin runs always in "full data query" mode, which makes it slower. The reason, is that systemd API is missing some important calls we need to use the field indexes of `systemd` journal. However, when running in this mode, the plugin offers also negative matches on the data (like filtering for all logs that do not have set some field), and this is the reason "full data query" mode is also offered as an option even on newer versions of `systemd`.
40
41
To use the plugin, install one of our native distribution packages, or install it from source.
42
43
+The following are limitations related to the features of `systemd` journal:
44
+
45
+- This plugin does not support binary field values. `systemd` journal has the ability to assign fields with binary data. This plugin assumes all fields contain text values (text in this context includes numbers).
46
+- This plugin does not support multiple values per field. `systemd` journal has the ability to accept the same field key, multiple times, with multiple values. This plugin will present the last value and ignore the others.
47
+
48
+
49
## Journal Sources
50
51
The plugin automatically detects the available journal sources, based on the journal files available in