[Pyroscope] Client Setup: Python

#Monitoring

python 환경에서 pyroscope를 구성해서 프로파일링을 사용하는 법을 정리해본다.

일단 python은 프로파일링 리소스가 매우 제한적이다.
현 시점에서는 CPU 사용량만 추적이 된다.

사전 구성: pyroscope

에이전트를 돌려보려면, 당연히 서버부터 있어야 한다.
pyroscope가 없다면 먼저 하나 띄운다.

sudo docker run --name pyroscope -p 4040:4040 grafana/pyroscope:latest

이렇게 들어가지면 잘 실행된 것이다.

설치

단일 모듈로 설치할 수 있다.

# uv
uv add pyroscope-io

# pip
pip install pyroscope-io

대충 다 되긴 하는데, arm linux에서는 지원이 제대로 안된다... 설치조차 안되더라.

MacOS only

Mac의 경우에는 이상한 권한 문제로 막히는 부분이 있어서, 뭘 또 세팅을 해줘야 한다.

brew update
brew install pyenv
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init - zsh)"' >> ~/.zshrc
#  Restart your shell
exec "$SHELL"

사용법

사용법 자체는 간단하다. 함수 하나 가져다가 연결 정보 넣어주면 그만이다.

import time
import pyroscope

pyroscope.configure(
    application_name="testserver",
    server_address="http://localhost:4040",
    tags={
        "env": "development",
    },
    detect_subprocesses=True,
    sample_rate=100,
    oncpu=True,
    gil_only=True,
    enable_logging=True,
)
print("Pyroscope initialized successfully.")

for i in range(1000):
    print(f"Processing item {i}...")
    time.sleep(1)  # Simulate some processing time