History

Andreas Gerstmayr afa20589d0 use fixed uid and gid for pcp user		2020-07-01 19:11:21 +02:00
..
etc/sysconfig	initial container import	2020-04-15 20:47:28 +02:00
usr	use fixed uid and gid for pcp user	2020-07-01 19:11:21 +02:00
README.md	remove bcc and bpftrace PMDAs to save 600 MB, fix REDIS_SERVERS default value	2020-06-09 21:12:27 +02:00

README.md

Performance Co-Pilot container

Performance Co-Pilot is a system performance analysis toolkit.

Usage

$ podman run -d \
    --systemd always \
    -p 44322:44322 \
    -v pcp-archives:/var/log/pcp/pmlogger \
    --name pcp \
    registry.fedoraproject.org/pcp

Note: On SELinux enabled systems, the following boolean needs to be set: sudo setsebool -P container_manage_cgroup true

Enabling host processes, network and container metrics

$ sudo podman run -d \
    --privileged \
    --net host \
    --systemd always \
    -v pcp-archives:/var/log/pcp/pmlogger \
    -v /:/host:ro,rslave \
    -e HOST_MOUNT=/host \
    --name pcp \
    registry.fedoraproject.org/pcp

Environment Variables

`HOST_MOUNT`

Path inside the container to the bind mount of / on the host.

`REDIS_SERVERS`

Redis connection spec(s) - could be any individual cluster host, and all hosts in the cluster will be automatically discovered. Alternately, use comma-separated hostspecs (non-clustered setup)

Volumes

`/var/log/pcp/pmlogger`

Performance Co-Pilot archive files with historical metrics.

Ports

`44322/tcp`

The pmproxy daemon listens on this port and exposes a REST API to access metrics.

Documentation

https://pcp.io