통사론
newrelic.agent.application_settings(name=None)애플리케이션 설정 개체를 반환합니다.
설명
이것은 응용 프로그램 설정 개체에 대한 참조를 반환합니다. global_settings 객체에는 구성 파일 및 환경 변수의 설정이 포함됩니다. 이 application_settings 객체에는 New Relic UI를 통해 서버 측에서 설정한 구성 변경 사항이 추가로 포함됩니다.
반환된 설정은 중첩된 계층적 개체이며 설정 이름은 에이전트 구성 파일 의 이름과 일치합니다. 애플리케이션 설정을 노출하는 주된 이유는 계측이 서버 측 설정이 아닌 에이전트별 로컬 구성을 참조하도록 하려는 경우입니다.
name 값이 설정되지 않은 경우 호출은 에이전트 구성 파일 또는 NEW_RELIC_APP_NAME 환경 변수를 통해 지정된 애플리케이션 이름을 사용합니다.
이 호출이 수행될 때 애플리케이션이 데이터 수집기에 등록되지 않은 경우 None 값을 반환합니다. 호출이 성공적으로 이루어지고 값이 반환되면 등록 중에 얻은 해당 응용 프로그램에 대한 서버 측 구성 과 중첩된 모든 로컬 구성의 값이 반영됩니다.
중요
응용 프로그램 설정 개체를 변경하지 마십시오. 서버 측 구성 변경으로 인해 에이전트가 데이터 수집기에 응용 프로그램을 다시 등록하는 경우 설정 개체가 무효화되고 교체되므로 설정 개체를 캐시하지 마십시오.
매개변수
매개변수 | 설명 |
|---|---|
끈 | 선택 과목. 애플리케이션의 이름입니다. 설정되지 않은 경우 이름은 해당 애플리케이션에 대한 Python 에이전트 구성에 설정된 이름과 일치합니다. |
반환 값
애플리케이션 설정 개체를 반환합니다. 객체 자체는 공개 API를 제공하지 않습니다. 일부 다른 호출은 전달해야 합니다.
예
IF 문 사용
구성 설정을 확인하여 구현할 사용자 지정 계측을 결정할 수 있습니다. 다음은 앱 설정 객체와 함께 if 문을 사용하는 예입니다.
settings = newrelic.agent.application_settings()
if settings and settings.error_collector.enabled: ...결과를 dict에 전달
디버깅 또는 로깅 중이고 기존 Python 사전 객체로 전역 설정이 필요한 경우 결과를 dict 에 전달할 수 있습니다. 예를 들어:
settings_dict = dict(newrelic.agent.application_settings())
for name, value in settings_dict.items(): print name, value각 name 은 해당 설정의 전체 점선 경로가 됩니다.