Python 에이전트 API 사용 가이드

WSGI 웹 트랜잭션 모니터링

Python 에이전트는 지원되는 프레임워크 에 대한 웹 트랜잭션을 자동으로 캡처합니다. 지원되는 프레임워크가 없는 경우 wsgi_application 함수를 사용하여 WSGI 진입점을 모니터링할 수 있습니다.

ASGI 웹 트랜잭션 모니터링

Python 에이전트는 지원되는 프레임워크에 대한 웹 트랜잭션을 자동으로 캡처합니다. 지원되는 프레임워크가 없는 경우 asgi_application 함수를 사용하여 ASGI 진입점을 모니터링할 수 있습니다.

웹이 아닌 트랜잭션 모니터링

Python 에이전트는 웹이 아닌 트랜잭션 을 백그라운드 작업으로 분류합니다. 웹이 아닌 트랜잭션을 캡처하려면 background_task 을 사용합니다.

거래에 대한 자세한 정보 캡처

트랜잭션 추적 에 원하는 수준의 세부 정보가 없는 경우:

• function_trace 을 사용하여 트랜잭션에서 더 많은 기능 수준 세부정보를 캡처합니다.
• datastore_trace 을 사용하여 데이터 저장소 호출에 대한 세부정보를 캡처합니다.

트랜잭션 무시

다음 옵션 중 하나를 사용합니다.

• 트랜잭션을 완전히 무시하려면 ignore_transaction 을 사용합니다.
• 트랜잭션이 트랜잭션 추적을 생성하지 않도록 하려면 suppress_transaction_trace 을 사용합니다.
• 에이전트가 자동으로 트랜잭션을 종료하기 전에 트랜잭션을 종료하려면 end_of_transaction 을 사용합니다.

현재 트랜잭션에 대한 참조 가져오기

현재 트랜잭션을 나타내는 객체를 반환하려면 current_transaction 을 사용합니다. 이것은 일부 다른 Python 에이전트 API 호출에 필요합니다.

트랜잭션 이름 변경

set_transaction_name 을(를) 사용합니다.

거래에 메타데이터(예: 고객의 구독 수준) 추가

add_custom_attribute 를 사용하여 거래에 맞춤 속성 을 추가하거나 다른 API 호출을 사용하여 맞춤 데이터를 보고합니다 .

트랜잭션을 백그라운드 작업으로 표시

웹 트랜잭션을 백그라운드 작업으로 변환하여 UI에서 웹이 아닌 트랜잭션 으로 표시하려면 set_background_task 을 사용합니다.

거래가 Apdex 점수 에 영향을 미치지 않도록 방지

suppress_apdex_metric 을(를) 사용합니다.

데이터를 쿼리할 때 사용할 이벤트에 대한 데이터를 보냅니다.

record_custom_event 을(를) 사용합니다.

애플리케이션 성능에 대한 시간 기반 메트릭 보고

• 단일 측정항목을 보고하려면 record_custom_metric 을 사용합니다.
• 측정항목 집합을 보고하려면 record_custom_metrics 을 사용합니다.

예외를 오류로 보고

기본적으로 Python 에이전트는 처리되지 않은 예외만 보고합니다. Python 예외를 오류로 보고하려면 notice_error 을 사용합니다.

쿼리 문자열 매개변수 보고

보안상의 이유로 웹 트랜잭션과 관련된 쿼리 문자열 매개변수는 기본적으로 비활성화되어 있습니다. capture_request_params 을(를) 사용하여 활성화합니다.

메타데이터로 이벤트에 태그 지정

더 자세한 쿼리 또는 오류 분석을 위해 이벤트에 속성을 추가하려면 add_custom_attribute 을 사용합니다.

데이터 소스 및 데이터 팩터리에서 메트릭 생성

record_custom_metric() 에 의해 구현된 푸시 스타일 API가 아닌 풀 스타일 API로 측정항목을 생성하려면 다음 API 호출을 사용하세요.

• register_data_source
• data_source_generator
• data_source_factory

메시지를 트랜잭션 으로 보고

message_transaction 을(를) 사용합니다.

트랜잭션 추적 세그먼트로 메시지 세부 정보 보고

message_trace 을(를) 사용합니다.

호출된 서비스에 보낼 페이로드를 만듭니다.

create_distributed_trace_payload 을(를) 사용합니다.

첫 번째 서비스에서 보낸 페이로드를 수락합니다. 이것은 추적에서 이러한 서비스를 함께 연결합니다

accept_distributed_trace_payload 을(를) 사용합니다.

에이전트 초기화

고급 통합 프로세스 의 일부로 특정 구성 파일로 Python 에이전트를 초기화하려면 initialize 을 사용합니다.

application 객체에 대한 참조 가져오기

application 객체는 에이전트 모니터링 애플리케이션을 나타내며 일부 Python 에이전트 API 호출에서 사용됩니다.

구성 설정에 대한 참조 가져오기

Python 에이전트의 동작을 제어하기 위해 구성 설정 을 사용할 수 있습니다.

• 구성 파일 및 환경 변수 설정에 대한 참조를 가져오고 이를 변경하려면 global_settings 을 사용합니다.
• UI에서 서버측 구성 을 포함한 모든 설정에 대한 참조를 얻으려면 application_settings 을 사용합니다.

에이전트 종료

데이터 업로드를 위한 표준 최종 시도를 허용하는 대신 에이전트를 강제로 종료하려면 shutdown_agent 을 사용합니다.

특정 페이지 보기 모니터링

모니터링하려는 보기에 브라우저 에이전트 헤더 및 바닥글 JavaScript 스니펫을 삽입하려면get_browser_timing_header 및get_browser_timing_footer 모두를 사용합니다.

특정 페이지 보기 모니터링 비활성화

특정 페이지 보기에 대한 브라우저 모니터링을 비활성화하려면 disable_browser_autorum 을 사용합니다.