pyroscope connect

The command attaches profiler to already running process specified by PID or operating system, if applicable (for example, ebpf integration).

Command line arguments

NameDefault ValueUsage
spy-nameautoName of the profiler you want to use. Supported ones are: pyspy, rbspy, phpspy, dotnetspy, ebpfspy.
application-nameApplication name used when uploading profiling data.
sample-rate100Sample rate for the profiler in Hz. 100 means reading 100 times per second.
detect-subprocessestrueMakes pyroscope keep track of and profile subprocesses of the main process.
log-levelinfoLog level: debug|info|warn|error.
server-addresshttp://localhost:4040Address of the pyroscope server.
auth-tokenAuthorization token used to upload profiling data.
upstream-threads4Number of upload threads.
upstream-request-timeout10sProfile upload timeout.
no-loggingfalseDisables logging from pyroscope.
pid0PID of the process you want to profile. Pass -1 to profile the whole system (only supported by ebpfspy).
pyspy-blockingfalseEnables blocking mode for pyspy.

Configuration file options

---
# Name of the profiler you want to use. Supported ones are: pyspy, rbspy, phpspy, dotnetspy, ebpfspy.
spy-name: "auto"
# Application name used when uploading profiling data.
application-name: ""
# Sample rate for the profiler in Hz. 100 means reading 100 times per second.
sample-rate: "100"
# Makes pyroscope keep track of and profile subprocesses of the main process.
detect-subprocesses: "true"
# Log level: debug|info|warn|error.
log-level: "info"
# Address of the pyroscope server.
server-address: "http://localhost:4040"
# Authorization token used to upload profiling data.
auth-token: ""
# Number of upload threads.
upstream-threads: "4"
# Profile upload timeout.
upstream-request-timeout: "10s"
# Disables logging from pyroscope.
no-logging: "false"
# PID of the process you want to profile. Pass -1 to profile the whole system (only supported by ebpfspy).
pid: "0"
# Enables blocking mode for pyspy.
pyspy-blocking: "false"