| QUARK-MON(8) | System Manager's Manual | QUARK-MON(8) |
quark-mon —
monitor and print quark events
quark-mon |
[-BbDEeFGgHhkLMNnSsTtuv]
[-C filename]
[-K kubeconfig]
[-l maxlength]
[-m maxnodes]
[-P ppid]
[-r rulefile] |
quark-mon |
-h |
quark-mon |
The quark-mon program listens to all
incoming quark(7) events and prints
them to stdout, the output format used is the one in
quark_event_dump(3).
The main utility is for testing and debugging quark, it's also a
good introduction to the code base. quark-mon runs
until a SIGINT is received.
The options are as follows:
-B-b-C
filenamedot -Tsvg filename -o filename.svg
-D-E-e-F-G-g-H-h-K
kubeconfig-k-L-l
maxlength-m
maxnodes-M-N-n-P
ppid-S-s-r
rulefile-K, or from the container API of the library.
An event without a process, or from a process whose container is unknown,
matches neither field. Like “event.scope”, these fields are
only supported by the EBPF backend.-T-t-usecurity_file_mprotect()
check with effective execute permission. The event does not assert that
the protection change ultimately succeeded.-v-VIf no backend option is specified,
quark-mon uses EBPF. Exactly one of
-b, -k or
-n may be passed, there is no fallback between
backends.
The “event.scope container” rule field matches events from a process in a Kubernetes container. To keep only container events on a Kubernetes node, use:
pass on event.scope container drop on any
A container is recognized only when the last component of the process cgroup is a container scope of the systemd cgroup driver, like cri-containerd-<id>.scope or crio-<id>.scope. This is the kubeadm default since Kubernetes 1.22. The following are not recognized as containers, and the rules above drop their events:
Containers outside Kubernetes are not a supported use case. The field is only supported by the EBPF backend. The kprobe backend does not report the cgroup of new processes, so it rejects the field, and so does the NOVA backend.
quark-mon exits with 0 in if a SIGINT was
sent, or 1 in case of error.
Running:
$ quark-monoutputs:
->1607007 (FORK+EXEC+EXIT) COMM comm=locale CMDL cmdline=[ locale, charmap ] PROC ppid=1607003 PROC uid=1000 gid=1000 suid=1000 sgid=1000 euid=1000 egid=1000 PROC cap_inheritable=0x0 cap_permitted=0x0 cap_effective=0x0 PROC cap_bset=0x1ffffffffff cap_ambient=0x0 PROC time_boot=1713340073284870415 CWD cwd=/d/e/quark FILE filename=/usr/bin/locale EXIT exit_code=0 exit_time=434523672438062 ->1607008 (FORK+EXEC+EXIT) COMM comm=groff CMDL cmdline=[ groff, -mtty-char, -Tutf8, -mandoc, -rLL=109n, -rLT=109n, -P-c ] PROC ppid=1607003 PROC uid=1000 gid=1000 suid=1000 sgid=1000 euid=1000 egid=1000 PROC cap_inheritable=0x0 cap_permitted=0x0 cap_effective=0x0 PROC cap_bset=0x1ffffffffff cap_ambient=0x0 PROC time_boot=1713340073288110375 CWD cwd=/d/e/quark FILE filename=/usr/bin/groff EXIT exit_code=0 exit_time=434523688177774 ...
Refer to quark_event_dump(3) for the output format description.
quark_event_dump(3), quark_process_lookup(3), quark_queue_block(3), quark_queue_close(3), quark_queue_get_epollfd(3), quark_queue_get_event(3), quark_queue_get_stats(3), quark_queue_open(3), quark-btf(8), quark-test(8)
| October 30, 2026 | Linux |