통사론
newrelic.agent.web_transaction(application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)
웹 트랜잭션을 계측하는 데 사용됩니다.
요구 사항
에이전트 버전 4.16.0.116 이상
설명
이 Python 데코레이터는 웹 트랜잭션을 계측하는 데 사용할 수 있습니다. 이 데코레이터로 표시된 트랜잭션은 웹 트랜잭션 아래 APM UI에 표시되며 웹이 아닌 트랜잭션과 구분됩니다.
데코레이터를 사용할 수 없는 경우 다음 호출 형식 중 하나가 더 유용할 수 있습니다.
The wrapper
: 추적하려는 특정 함수가 어디에 있는지 미리 알고 있다면
web_transaction
데코레이터를 사용할 수 있습니다. 하지만 트레이스가 되어야 하는 모든 기능을 모르는 경우(예를 들어 라우팅 시스템의 일부로 동적으로 조회되는 경우)WebTransactionWrapper
을 사용하여 해당 기능을 래핑해야 합니다. 등록시 또는 전화시.The path-based wrapper
: 경로 기반 래퍼 형식은
wrap_web_transaction
입니다.
이러한 함수 형식의 차이점과 사용에 대한 자세한 내용은 변수 호출 형식 을 참조하세요.
매개변수
데코레이터 매개변수
newrelic.agent.web_transaction(application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)
이러한 호출에 대한 매개변수:
매개변수 | 설명 |
---|---|
애플리케이션 인스턴스 | 선택 과목. 데이터가 보고될 애플리케이션입니다. 값을 지정하지 않으면 에이전트 구성 (구성 파일 또는 환경 변수)에 지정된 응용 프로그램이 사용됩니다. 애플리케이션 객체 생성에 대한 자세한 내용은 |
끈 | 선택 과목. 트랜잭션의 이름입니다. 기본적으로 이름은 데코레이터가 적용된 함수의 이름이지만 이 이름을 제공하여 이를 재정의할 수 있습니다. |
끈 | 선택 과목. 제공되지 않은 경우 그룹은 이름이 |
끈 | 선택 과목. 요청 URL의 체계 부분 |
끈 | 선택 과목. 요청 URL의 호스트 부분 |
정수 | 선택 과목. 요청 URL의 포트 부분 |
끈 | 선택 과목. GET 또는 POST와 같은 HTTP 요청 방법 |
끈 | 선택 과목. 요청 URL 경로의 나머지 부분 |
끈 | 선택 과목. 물음표 다음에 오는 요청 URL 부분 |
반복 가능 또는 사전 | 선택 과목. HTTP 요청 헤더 [name, value] two-item iterables의 iterable 또는 |
래퍼 매개변수:
newrelic.agent.WebTransactionWrapper(wrapped, application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)
WebTransactionWrapper
web_transaction
데코레이터 및 이 추가 wrapped
매개변수와 동일한 매개변수 를 사용합니다.
매개변수 | 설명 |
---|---|
방법 | 필수의. 추적할 방법입니다. |
경로 기반 매개변수:
newrelic.agent.wrap_web_transaction(module, object_path, application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)
wrap_web_transaction
web_transaction
데코레이터와 동일한 매개변수 와 다음 추가 매개변수를 사용합니다.
매개변수 | 설명 |
---|---|
모듈 또는 문자열 | 필수의. 계측 중인 웹 기능/활동이 포함된 모듈입니다. |
끈 | 필수의. 모듈의 경로입니다. |
예
web_transaction
데코레이터 예제
다음은 web_transaction 데코레이터를 사용하는 예입니다.
@newrelic.agent.web_transaction()def get(): ...
WebTransactionWrapper
예시
WebTransactionWrapper
사용 예:
task = newrelic.agent.WebTransactionWrapper(get_next_task())result = task(*args, **kwargs)