Process exporter configuration file (jpc_process_exporter.yml)

process_names

--

--

--

--

-

[name]

Each item in process_names gives a recipe for identifying and naming processes. The optional name tag defines a template to use to name matching processes; if not specified, name defaults to {{.ExeBase}}.

• {{.Comm}} contains the basename of the original executable, i.e. 2nd field in /proc/<pid>/stat

• {{.ExeBase}} contains the basename of the executable

• {{.ExeFull}}contains the fully qualified path of the executable

• {{.Username}} contains the username of the effective user

• {{.Matches}} map contains all the matches resulting from applying cmdline regexps

• {{.PID}} contains the PID of the process. Note that using PID means the group will only contain a single process.

• {{.StartTime}} contains the start time of the process. This can be useful in conjunction with PID because PIDs get reused over time.

• {{.Cgroups}} contains (if supported) the cgroups of the process (/proc/self/cgroup). This is particularly useful for identifying to which container a process belongs.

Y

Specify this to change the process name to a value other than the default value (executable file name).

{{.ExeBase}};{{.Username}};{{.Matches.cmdline}}

<selector>

comm, exe or cmdline.

If more than one selector is present, they must all match.

REQ

Monitored process selector

cmdline

-

<any>

For "comm" and "exe", the list of strings is an OR, meaning any process matching any of the strings will be added to the item's group.

For "cmdline", the list of regexes is an AND, meaning they all must match. Any capturing groups in a regexp must use the ?P<name> option to assign a name to the capture, which is used to populate ".Matches".

• comm

  comm is the second field of /proc/<pid>/stat minus parens. It is the base executable name, truncated at 15 chars. It cannot be modified by the program, unlike exe.

  ex) bash

• exe

  exe is argv[0]. If no slashes, only basename of argv[0] need match. If exe contains slashes, argv[0] must match exactly.

  ex) /usr/local/bin/prometheus

• cmdline

  Specify the regular expression for the argument, up to 4096 bytes.

If more than one value is specified, OR condition is used for comm and exe, and AND condition is used for cmdline.

REQ

Monitored process selector value

- (?P<cmdline>.*)