Pyroscope Agent records and aggregates what your application has been doing, then sends that data over to the Pyroscope Server.
Pyroscope Agent can run on Linux, macOS, Windows and in Docker. Note that some integrations are OS-specific. Visit Integrations page for details.
Pyroscope Agent may be run interactively and as a service:
pyroscope execspawns a new process and attaches configured profiler. Once
pyroscope execexits, the child process exits as well and vice-versa. This command may be used for testing, as a docker entrypoint, or as a systemd service unit command.
pyroscope connectattaches profiler to already running process specified by PID or operating system, if applicable (for example,
pyroscope agentcontinuously tracks configured
targetsand attaches profilers to them. This command is only supported on Windows and it's primarily supposed to be run in the context of Windows Service Control Manager.
pyroscope adhocprofiles a process and saves the result as a file that can later be analyzed with the Adhoc view. This command is useful for interactive or ad-hoc profiling.
Refer to Configuration page to learn more about each mode and how to configure Pyroscop Agent.