skywalking-python

(★ 219)

The Python agent for Apache SkyWalking

파일 탐색기

최종 버전 다운로드 (.zip)

- - CI.yaml
  - dead-link-checker.yaml
  - publish-docker.yaml
- PULL_REQUEST_TEMPLATE
- config.toml
- __init__.py
- docker-compose.yaml
- flask_consumer_fork.py
- flask_consumer_prefork.py
- flask_provider_single.py
- gunicorn_consumer_prefork.py
- README.md
- Dockerfile
- Makefile
- menu.yml
- README.md
- - __init__.py
- - __init__.py
- - __init__.py
  - grpc.py
  - grpc_aio.py
  - http.py
  - http_aio.py
  - kafka.py
  - kafka_aio.py
- - __init__.py
  - base_command.py
  - command_service.py
  - profile_task_command.py
- - __init__.py
  - formatter.py
  - sw_logging.py
- - __init__.py
  - counter.py
  - gauge.py
  - histogram.py
  - meter.py
  - meter_service.py
- - __init__.py
  - sw_aiohttp.py
  - sw_aioredis.py
  - sw_aiormq.py
  - sw_amqp.py
  - sw_asyncpg.py
  - sw_bottle.py
  - sw_celery.py
  - sw_confluent_kafka.py
  - sw_django.py
  - sw_elasticsearch.py
  - sw_falcon.py
  - sw_falcon_v3.py
  - sw_fastapi.py
  - sw_flask.py
  - sw_grpc.py
  - sw_happybase.py
  - sw_http_server.py
  - sw_httpx.py
  - sw_kafka.py
  - sw_loguru.py
  - sw_mysqlclient.py
  - sw_neo4j.py
  - sw_psycopg.py
  - sw_psycopg2.py
  - sw_pulsar.py
  - sw_pymongo.py
  - sw_pymysql.py
  - sw_pyramid.py
  - sw_rabbitmq.py
  - sw_redis.py
  - sw_requests.py
  - sw_sanic.py
  - sw_sanic_v2.py
  - sw_tornado.py
  - sw_urllib3.py
  - sw_urllib3_v2.py
  - sw_urllib_request.py
  - sw_websockets.py
- - __init__.py
  - profile_constants.py
  - profile_context.py
  - profile_service.py
  - profile_status.py
  - profile_task.py
  - snapshot.py
- - __init__.py
  - sampling_service.py
- - __init__.py
  - carrier.py
  - context.py
  - segment.py
  - snapshot.py
  - span.py
  - tags.py
- - __init__.py
  - array.py
  - atomic_ref.py
  - comparator.py
  - counter.py
  - exception.py
  - filter.py
  - integer.py
  - lang.py
  - singleton.py
  - time.py
- __init__.py
- config.py
- decorators.py
- loggings.py
- - __init__.py
  - sw_python.py
- __init__.py
- __main__.py
- - __init__.py
  - test_span.py
- - __init__.py
  - base.py
  - conftest.py
  - docker-compose.base.yml
  - Dockerfile.plugin
  - pytest.ini
- - __init__.py
  - test_ant_matcher.py
  - test_counter.py
  - test_filter.py
  - test_meter.py
  - test_sampling.py
  - test_version_check.py
- __init__.py
- gather_test_paths.sh
- orchestrator.py
- config_doc_gen.py
- grpc_code_gen.py
- plugin_doc_gen.py
.asf.yaml
.dlc.json
.dockerignore
.gitignore
.gitmodules
.licenserc.yaml
CHANGELOG.md
CLAUDE.md
CONTRIBUTING.md
LICENSE
Makefile
NOTICE
poetry.lock
poetry.toml
protocol
pyproject.toml
README.md
setup.cfg

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/apache/skywalking-python

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd skywalking-python

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker build -f docker/Dockerfile -t skywalking-python .

Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.

docker run -p 8080:80 skywalking-python

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Python

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install .

PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

4. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.