web_transaction (파이썬 에이전트 API)

통사론

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)

이러한 호출에 대한 매개변수:

매개변수	설명
`application` 애플리케이션 인스턴스	선택 과목. 데이터가 보고될 애플리케이션입니다. 값을 지정하지 않으면 에이전트 구성 (구성 파일 또는 환경 변수)에 지정된 응용 프로그램이 사용됩니다. 애플리케이션 객체 생성에 대한 자세한 내용은 `application()` 메서드를 참조하세요.
`name` 문자열 또는 함수	선택 사항. 트랜잭션 이름. callable_name 파라미터를 받는 함수일 수 있습니다. 기본값은 `None` 입니다. 기본적으로 이름은 데코레이터가 적용된 함수의 이름이 되지만, 이 이름을 제공하여 이를 재정의할 수 있습니다.
`group` 문자열 또는 함수	선택 과목. `group` 은 `name` 매개변수의 이름 지정 구조를 나타냅니다. 이것은 UI에서 트랜잭션 유형 을 설정하는 데 사용됩니다. 제공되지 않은 경우, 이름이 `module:class.function` 또는 `module:function` 형식이고 실행 중인 함수의 이름을 나타낸다고 예상하여 그룹은 `Function` (으)로 기본 설정됩니다. 사용자 지정 그룹을 생성하는 경우, `Python/`을(를) 접두사로 추가하는 것을 권장합니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`scheme` 문자열 또는 함수	선택 사항. 요청 URL의 스킴 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`host` 문자열 또는 함수	선택 사항. 요청 URL의 호스트 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`port` 정수 또는 함수	선택 사항. 요청 URL의 포트 부분. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`request_method` 문자열 또는 함수	선택 사항. GET 또는 POST와 같은 HTTP 요청 메서드. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`request_path` 문자열 또는 함수	선택 사항. 요청 URL 경로의 나머지 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`query_string` 문자열 또는 함수	선택 사항. 요청 URL에서 물음표 뒤에 오는 부분. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`headers` 이터러블 또는 dict 또는 함수	선택 사항. HTTP 요청 헤더는 [name, value] 2개 항목 이터러블의 이터러블 또는 `{name:value}`의 딕셔너리이며, 여기서 name은 헤더 이름이고, value는 헤더 값입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

매개변수

설명

application

애플리케이션 인스턴스

선택 과목. 데이터가 보고될 애플리케이션입니다. 값을 지정하지 않으면 에이전트 구성 (구성 파일 또는 환경 변수)에 지정된 응용 프로그램이 사용됩니다.

애플리케이션 객체 생성에 대한 자세한 내용은 application() 메서드를 참조하세요.

name

문자열 또는 함수

선택 사항. 트랜잭션 이름. callable_name 파라미터를 받는 함수일 수 있습니다. 기본값은 None 입니다. 기본적으로 이름은 데코레이터가 적용된 함수의 이름이 되지만, 이 이름을 제공하여 이를 재정의할 수 있습니다.

group

문자열 또는 함수

선택 과목. group 은 name 매개변수의 이름 지정 구조를 나타냅니다. 이것은 UI에서 트랜잭션 유형 을 설정하는 데 사용됩니다.

제공되지 않은 경우, 이름이 module:class.function 또는 module:function 형식이고 실행 중인 함수의 이름을 나타낸다고 예상하여 그룹은 Function (으)로 기본 설정됩니다. 사용자 지정 그룹을 생성하는 경우, Python/을(를) 접두사로 추가하는 것을 권장합니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

scheme

문자열 또는 함수

선택 사항. 요청 URL의 스킴 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

host

문자열 또는 함수

선택 사항. 요청 URL의 호스트 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

port

정수 또는 함수

선택 사항. 요청 URL의 포트 부분. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

request_method

문자열 또는 함수

선택 사항. GET 또는 POST와 같은 HTTP 요청 메서드. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

request_path

문자열 또는 함수

선택 사항. 요청 URL 경로의 나머지 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

query_string

문자열 또는 함수

선택 사항. 요청 URL에서 물음표 뒤에 오는 부분. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

headers

이터러블 또는 dict 또는 함수

선택 사항. HTTP 요청 헤더는 [name, value] 2개 항목 이터러블의 이터러블 또는 {name:value}의 딕셔너리이며, 여기서 name은 헤더 이름이고, value는 헤더 값입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

래퍼 매개변수:

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 매개변수와 동일한 매개변수 를 사용합니다.

매개변수	설명
`wrapped` 방법	필수의. 추적할 방법입니다.
`name` 문자열 또는 함수	선택 사항. 트랜잭션 이름. callable_name 파라미터를 받는 함수일 수 있습니다. 기본값은 `None` 입니다. 기본적으로 이름은 데코레이터가 적용된 함수의 이름이 되지만, 이 이름을 제공하여 이를 재정의할 수 있습니다.
`group` 문자열 또는 함수	선택 과목. `group` 은 `name` 매개변수의 이름 지정 구조를 나타냅니다. 이것은 UI에서 트랜잭션 유형 을 설정하는 데 사용됩니다. 제공되지 않은 경우, 이름이 `module:class.function` 또는 `module:function` 형식이고 실행 중인 함수의 이름을 나타낸다고 예상하여 그룹은 `Function` (으)로 기본 설정됩니다. 사용자 지정 그룹을 생성하는 경우, `Python/`을(를) 접두사로 추가하는 것을 권장합니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`scheme` 문자열 또는 함수	선택 사항. 요청 URL의 스킴 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`host` 문자열 또는 함수	선택 사항. 요청 URL의 호스트 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`port` 정수 또는 함수	선택 사항. 요청 URL의 포트 부분. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`request_method` 문자열 또는 함수	선택 사항. GET 또는 POST와 같은 HTTP 요청 메서드. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`request_path` 문자열 또는 함수	선택 사항. 요청 URL 경로의 나머지 부분입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`query_string` 문자열 또는 함수	선택 사항. 요청 URL에서 물음표 뒤에 오는 부분. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.
`headers` 이터러블 또는 dict 또는 함수	선택 사항. HTTP 요청 헤더는 [name, value] 2개 항목 이터러블의 이터러블 또는 `{name:value}`의 딕셔너리이며, 여기서 name은 헤더 이름이고, value는 헤더 값입니다. 래핑되는 함수와 동일한 파라미터를 받는 함수일 수 있습니다.

경로 기반 매개변수:

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 데코레이터와 동일한 매개변수 와 다음 추가 매개변수를 사용합니다.

매개변수	설명
`module` 모듈 또는 문자열	필수의. 계측 중인 웹 기능/활동이 포함된 모듈입니다.
`object_path` 끈	필수의. 모듈의 경로입니다.

매개변수

설명

module

모듈 또는 문자열

필수의. 계측 중인 웹 기능/활동이 포함된 모듈입니다.

object_path

끈

필수의. 모듈의 경로입니다.

예

`web_transaction`

다음은 web_transaction 데코레이터를 사용하는 예입니다.

@newrelic.agent.web_transaction()
def get():
    ...

`WebTransactionWrapper`

WebTransactionWrapper 사용 예:

task = newrelic.agent.WebTransactionWrapper(get_next_task())
result = task(*args, **kwargs)

사용자의 편의를 위해 제공되는 기계 번역입니다.

web_transaction (파이썬 에이전트 API)

통사론.css-21sua1{background:none;border:none;width:0;padding:0;}

요구 사항

설명

매개변수

데코레이터 매개변수

래퍼 매개변수:

경로 기반 매개변수:

예

web_transaction

WebTransactionWrapper

통사론

`web_transaction`

`WebTransactionWrapper`