• 로그인

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

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

Python 에이전트 구성

Python 에이전트 를 사용하면 구성 옵션을 사용하여 기본 에이전트 동작 에이전트를 변경할 수 있습니다.

유일한 필수 Python 에이전트 구성 설정은 라이선스 키 입니다. 라이센스 키는 에이전트가 애플리케이션 데이터를 보고하는 계정을 식별합니다. 애플리케이션을 호스팅하는 방법에 따라 구성 파일 또는 환경 변수를 통해 라이선스 키를 제공할 수 있습니다.

구성 방법 및 우선 순위

Python 에이전트를 구성하는 기본 방법은 표준 설치 프로세스 의 일부로 생성되는 구성 파일 을 사용하는 것입니다. UI에서 서버 측 구성을 사용하거나 환경 변수 를 사용하여 제한된 수의 구성 옵션을 설정할 수도 있습니다. WSGI 요청 환경 사전 을 사용하여 설정을 전달하여 요청별로 일부 설정을 지정할 수도 있습니다.

Python 에이전트는 구성에 대해 다음과 같은 우선 순위를 따릅니다.

Python 에이전트를 사용하면 요청별 옵션이 서버 측 구성을 재정의합니다. 활성화된 경우 서버 측 값이 비어 있는 경우에도 서버 측 구성이 에이전트 구성 파일의 모든 해당 값을 재정의합니다. 에이전트 구성 파일은 환경 변수를 재정의합니다. 환경 변수는 에이전트 기본값을 재정의합니다.

각 구성 방법에 대한 자세한 설명은 다음과 같습니다.

다중 환경 구성

에이전트는 newrelic 이라는 에이전트 구성 섹션에서 기본 구성을 읽습니다. 추가 섹션에서 특정 배포 환경(예: 개발, 스테이징, 프로덕션)에 대한 재정의를 제공할 수 있습니다. 이 섹션 앞에는 [newrelic:environment] 이 있습니다. 여기서 environment 는 환경 이름으로 바뀝니다.

에이전트가 환경 기반 구성을 사용하도록 지정하려면 다음 방법 중 하나를 사용하십시오.

  • newrelic.agent.initialize() 을 호출할 때 환경 이름을 두 번째 인수로 제공하십시오.

    또는

  • NEW_RELIC_ENVIRONMENT 환경 변수를 환경 이름으로 설정합니다.

환경을 지정하지 않으면 에이전트는 newrelic 에이전트 구성 섹션에 지정된 기본 설정을 사용합니다.

구성 파일의 기본 구조는 다음과 같습니다.

[newrelic]
... default settings

[newrelic:development]
... override settings

[newrelic:staging]
... override settings

[newrelic:production]
... override settings

일반 구성 설정

이러한 설정은 에이전트 구성 파일에서 사용할 수 있습니다.

속성

속성은 트랜잭션 추적, 추적된 오류, 브라우저 모니터링 및 트랜잭션 이벤트에 대한 정보를 제공하는 키-값 쌍입니다. 아래의 일반 속성 설정으로 4개의 모든 대상에 대한 속성을 구성하는 것 외에도 대상별로 구성할 수도 있습니다.

자세한 내용은 Python 에이전트 속성 , 속성 활성화 및 비활성화속성 예제 를 참조하십시오.

트랜잭션 추적기 구성

중요

거래 이름 끝에 대괄호 [suffix] 를 사용하지 마십시오. 에이전트는 자동으로 이름에서 대괄호를 제거합니다. 대신 필요한 경우 괄호 (suffix) 또는 기타 기호를 사용하십시오.

트랜잭션 추적에 대한 자세한 내용은 트랜잭션 추적 을 참조하십시오.

트랜잭션 세그먼트 구성

다음은 에이전트 구성 파일을 통해 사용할 수 있는 트랜잭션 세그먼트 설정입니다.

오류 수집기 구성

다음은 에이전트 구성 파일을 통해 사용할 수 있는 오류 수집기 설정입니다.

APM의 오류 구성에 대한 개요는 APM에서 오류 관리를 참조하십시오.

브라우저 모니터링 설정

다음은 에이전트 구성 파일을 통해 사용할 수 있는 브라우저 모니터링 설정입니다.

거래 이벤트 설정

다음은 에이전트 구성 파일을 통해 사용할 수 있는 트랜잭션 이벤트 설정입니다.

이러한 구성 설정은 analytic_events 이라고 했습니다. 구성 파일이 여전히 analytic_events 을 사용하는 경우 transaction_events 를 사용하도록 에이전트를 업데이트하십시오.

맞춤 이벤트 설정

다음은 에이전트 구성 파일을 통해 사용할 수 있는 사용자 지정 이벤트 설정입니다.

데이터 저장소 추적기 설정

다음 데이터 저장소 추적 프로그램 설정은 에이전트 구성 파일을 통해 사용할 수 있습니다.

분산 추적 설정

분산 추적을 사용하면 분산 시스템을 통해 이동하는 요청의 경로를 볼 수 있습니다.Python 에이전트 버전 7.0.0.166 이상 부터 분산 추적이 기본적으로 활성화됩니다.

중요

분산 추적을 활성화하면 교차 응용 프로그램 추적 이 비활성화되고 APM 기능에 다른 영향을 미칩니다. 교차 애플리케이션 추적에서 마이그레이션하는 경우 전환 가이드 를 읽으십시오.

자세한 내용 은 Python 서비스에 대한 분산 추적을 참조하십시오.

설정에는 다음이 포함됩니다.

스팬 이벤트 구성

분산 추적 을 위해 스팬 이벤트 가 수집됩니다. 스팬 이벤트를 보고하려면 분산 추적을 활성화해야 합니다. 구성 옵션에는 다음이 포함됩니다.

이벤트 수확 구성

이벤트 수집 설정은 New Relic으로 전송되는 이벤트 유형 데이터의 양을 제한합니다. 이러한 설정을 사용할 때 다음과 같은 중요한 사항을 고려하십시오.

  • 이벤트 수집 설정은 전체 애플리케이션이 아니라 에이전트의 단일 인스턴스에 대한 제한에 영향을 줍니다. 전체 애플리케이션에서 제한을 설정하는 방법은 아래 사용 예를 참조하십시오.
  • 실시간 스트리밍 은 5초마다(분당 12회) 데이터를 전송하지만 이벤트 수집 설정은 여전히 분당 이벤트 비율에 영향을 줍니다. 실시간 스트리밍을 활성화하거나 비활성화하기 위해 이러한 설정을 변경할 필요가 없습니다.
  • 실시간 스트리밍(기본적으로 활성화됨)을 사용하면 New Relic 은 5초 간격으로 엔터티에 대한 이벤트 수집 제한을 표시합니다. 이것은 예를 들어 구성 파일에서 제한 값을 1200으로 설정하면 New Relic에서 100으로 표시됨을 의미합니다.

사용 예

애플리케이션이 10개의 호스트에 배포되고 각각 호스트당 4개의 프로세스를 실행한다고 가정해 보겠습니다. 전체 애플리케이션에 대해 스팬 이벤트 수를 분당 10,000개 이벤트로 제한하려면 해당 수를 10개의 호스트로 나눕니다. 그런 다음 호스트당 4개의 프로세스로 다시 나눕니다.

10000 / (10 * 4) = 250

해당 계산에 따라 최종 설정은 다음과 같습니다.

event_harvest_config.harvest_limits.span_event_data = 250

이벤트 수집 구성 설정은 다음과 같습니다.

이벤트 루프 가시성 설정

이벤트 루프 가시성은 이벤트 루프를 차단하는 트랜잭션에 대한 정보를 표시합니다. 에이전트는 이벤트 루프의 제어를 획득하기 위해 상당한 시간을 기다린 트랜잭션에 대한 정보를 생성합니다. 설정에는 다음이 포함됩니다.

가비지 컬렉션 런타임 메트릭 설정

이러한 가비지 수집 런타임 메트릭 설정은 에이전트 구성 파일을 통해 사용할 수 있습니다.

New Relic CodeStream 설정

에이전트에서 CodeStream 코드 수준 지표를 구성하는 데 다음 설정을 사용할 수 있습니다.

애플리케이션 로깅 설정

에이전트에서 애플리케이션 로깅을 구성하기 위해 다음 설정을 사용할 수 있습니다.

기타 구성 설정

다음은 에이전트 구성 파일을 통해 사용할 수 있는 다양한 설정입니다.

헤로쿠

내장 계측

Python 에이전트는 다양한 Python 패키지/모듈을 계측합니다. 이 계측은 대상 Python 패키지/모듈을 애플리케이션에서 가져올 때만 발생합니다.

기본 계측을 비활성화하려면 계측을 트리거한 모듈의 이름에 해당하는 특수 import-hook 섹션을 제공합니다. 그런 다음 enabled 설정을 false 로 설정하여 해당 모듈의 계측을 비활성화합니다.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.