standalone 모니터링 설정

standalone 파이썬은 웹 프레임워크나 별도의 런타임 없이 순수한 .py 스크립트를 파이썬 인터프리터로 직접 실행해 구동되는 독립 실행형 프로세스를 의미합니다.

이처럼 HTTP 요청·응답이 발생하지 않는 환경은 whatap.conf의 옵션 설정을 통해 모니터링을 수행해야 합니다.

• standalone_enabled Boolean

  기본값 false

  whatap.conf에, 해당 옵션이 true로 되어 있어야만 standalone 모니터링이 가능합니다.

standalone 타입 설정

• standalone_type String

  기본값 single-transaction

  single-transaction, multiple-transaction 중 하나를 선택합니다.

  • single-transaction

    • 파이썬 스크립트 실행을 하나의 트랜잭션으로 모니터링합니다.
    • 서비스 이름은 실행한 스크립트 파일명으로 등록됩니다.

    whatap-start-agent test.py
    # → "test.py" 트랜잭션 명으로 등록됨.

  • multiple-transaction

    • 사용자가 지정한 모듈·클래스·메소드 단위로 트랜잭션 포인트를 설정해 추적합니다.
    클래스 단위 추적 시

    standalone_transaction_patterns = “패키지:클래스.메소드”
    # 예) myPackage:MyClass.__init__

    함수 단위 추적 시

    standalone_transaction_patterns = “패키지:함수명”
    # 예) myPackage:my_function

  팁

  메인 스크립트 파일의 함수&클래스를 추적할 때 패키지명 대신 __main__ 을 사용하세요.

  • Python 인터프리터는 메인으로 실행된 스크립트를 항상 __main__ 모듈로 인식합니다.

  예시

  whatap-start-agent test.py

  • 해당 명령어를 실행한 경우, test.py 의 스크립트가 __main__ 모듈로 인식됩니다.

  # 올바른 예시
  standalone_transaction_patterns = “__main__:my_function”
  
  # 틀린 예시
  standalone_transaction_patterns = “test:my_function”