Sign Up
Log In
Log In
or
Sign Up
Places
All Projects
Status Monitor
Collapse sidebar
devel:BCI:SLE-15-SP5
pcp-image
README.md
Overview
Repositories
Revisions
Requests
Users
Attributes
Meta
File README.md of Package pcp-image
# SLE Performance Co-Pilot (pcp): Performance Co-Pilot ## Description Performance Co-Pilot ([PCP](https://pcp.io)) is a system performance analysis toolkit. ## Usage ``` $ podman run -d \ --name pcp \ --systemd always \ -p 44321:44321 \ -p 44322:44322 \ -v pcp-archives:/var/log/pcp/pmlogger \ registry.suse.com/suse/pcp:%%pcp_patch%% ``` **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 \ --name pcp \ --privileged \ --net host \ --systemd always \ -e HOST_MOUNT=/host \ -v pcp-archives:/var/log/pcp/pmlogger \ -v /:/host:ro,rslave \ registry.suse.com/suse/pcp:%%pcp_patch%% ``` ## Configuration ### Environment variables #### `PCP_SERVICES` Default: `pmcd,pmie,pmlogger,pmproxy` Comma-separated list of PCP services to start. #### `HOST_MOUNT` Default: unset. Path inside the container to the bind mount of `/` on the host. #### `REDIS_SERVERS` Default: `localhost:6379` 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) ### Configuration files For custom configuration options beyond the above environment variables, it is advised to use a bind mount with a configuration file on the host to the container. Example command to run a pmlogger-only container: ``` $ podman run -d \ --name pmlogger \ --systemd always \ -e PCP_SERVICES=pmlogger \ -v $(pwd)/pmlogger.control:/etc/pcp/pmlogger/control.d/local:z \ -v pcp-archives:/var/log/pcp/pmlogger \ registry.suse.com/suse/pcp:%%pcp_patch%% ``` pmlogger.control: ``` $version=1.1 remote.pmcdhost.corp n n PCP_ARCHIVE_DIR/remote_pmcd -N -r -T24h10m -c config.default -v 100Mb ``` ## Volumes ### `/var/log/pcp/pmlogger` Performance Co-Pilot archive files with historical metrics. ## Ports ### `44321/tcp` The pmcd daemon listens on this port and exposes the [PMAPI(3)](https://man7.org/linux/man-pages/man3/pmapi.3.html) to access metrics. ### `44322/tcp` The pmproxy daemon listens on this port and exposes the REST [PMWEBAPI(3)](https://man7.org/linux/man-pages/man3/pmwebapi.3.html) to access metrics. ## Documentation [PCP books](https://pcp.readthedocs.io) ## Licensing `SPDX-License-Identifier: (LGPL-2.1+ AND GPL-2.0+)` The build recipe and this documentation is licensed as (LGPL-2.1+ AND GPL-2.0+). The container itself contains various software components under various open source licenses listed in the associated Software Bill of Materials (SBOM).
Locations
Projects
Search
Status Monitor
Help
OpenBuildService.org
Documentation
API Documentation
Code of Conduct
Contact
Support
@OBShq
Terms
openSUSE Build Service is sponsored by
The Open Build Service is an
openSUSE project
.
Sign Up
Log In
Places
Places
All Projects
Status Monitor