| 1 | A custom format is used. |
| 2 | |
| 3 | Each configuration line has a form like: |
| 4 | |
| 5 | ``` |
| 6 | group_name: app1 app2 app3 |
| 7 | ``` |
| 8 | |
| 9 | Where `group_name` defines an application group, and `app1`, `app2`, and `app3` are process names to match for |
| 10 | that application group. |
| 11 | |
| 12 | Each group can be given multiple times, to add more processes to it. |
| 13 | |
| 14 | The process names are the ones returned by: |
| 15 | |
| 16 | - `ps -e` or `/proc/PID/stat` |
| 17 | - in case of substring mode (see below): `/proc/PID/cmdline` |
| 18 | |
| 19 | To add process names with spaces, enclose them in quotes (single or double): |
| 20 | `'Plex Media Serv' "my other process"` |
| 21 | |
| 22 | Note that spaces are not supported for process groups. Use a dash "-" instead. |
| 23 | |
| 24 | You can add an asterisk (\*) at the beginning and/or the end of a process to do wildcard matching: |
| 25 | |
| 26 | - `*name` suffix mode: will search for processes ending with 'name' (/proc/PID/stat) |
| 27 | - `name*` prefix mode: will search for processes beginning with 'name' (/proc/PID/stat) |
| 28 | - `*name*` substring mode: will search for 'name' in the whole command line (/proc/PID/cmdline) |
| 29 | |
| 30 | If you enter even just one `*name*` (substring), apps.plugin will process /proc/PID/cmdline for all processes, |
| 31 | just once (when they are first seen). |
| 32 | |
| 33 | To add processes with single quotes, enclose them in double quotes: "process with this ' single quote" |
| 34 | |
| 35 | To add processes with double quotes, enclose them in single quotes: 'process with this " double quote' |
| 36 | |
| 37 | The order of the entries in this list is important, the first that matches a process is used, so put important |
| 38 | ones at the top. Processes not matched by any row, will inherit it from their parents or children. |
| 39 | |
| 40 | The order also controls the order of the dimensions on the generated charts (although applications started after |
| 41 | apps.plugin is started, will be appended to the existing list of dimensions the netdata daemon maintains). |