• 로그인

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

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

문제 신고

newrelic_set_appname(PHP 에이전트 API)

통사론

newrelic_set_appname(string $name)
newrelic_set_appname(string $name, string $license[, bool $xmit])

데이터 롤업을 제어하는 New Relic 앱 이름을 설정합니다.

요구 사항

에이전트 버전 3.1.5.111 이상.

설명

New Relic UI가 데이터를 올바른 애플리케이션에 연결하는 데 사용하는 New Relic 애플리케이션 이름 을 설정합니다.

New Relic 애플리케이션 이름을 설정하는 데 권장되고 선호되는 방법은 전역 또는 디렉토리별 INI 설정 을 사용하여 실행 시작 시 애플리케이션을 원하는 이름에 연결하는 것입니다.

에이전트 구성 파일을 편집할 수 없는 경우(예: 많은 공유 호스팅 환경에서 구성 파일 편집을 허용하지 않음) newrelic_set_appname API 호출을 사용하여 앱 이름, 라이선스 키 (선택 사항, 여러 계정을 사용하는 경우)를 구성할 수 있습니다. , 및 참/거짓 플래그(선택 사항, 이전에 기록된 데이터를 유지할지 또는 폐기할지 결정하기 위해). 최대 APM 추적 연속성을 보장하려면 가능한 한 빨리 이것을 호출하십시오. 이 API 호출은 현재 트랜잭션 데이터를 모두 버리고 지정된 앱 이름으로 다시 연결된 후 새 트랜잭션을 시작합니다.

다른 앱 이름 지정 옵션은 PHP 애플리케이션 이름 지정을 참조하세요 . 가능하면 INI 기반 솔루션이 권장됩니다.

통화 및 위치 동작

New Relic은 이 함수를 가능한 한 빨리 그리고 가능한 한 얕은 호출 스택에서 호출할 것을 강력히 권장합니다. 응용 프로그램은 APM의 개별 엔터티이며 트랜잭션 추적의 불연속성은 이 방법의 사용에 내재되어 있습니다. 새 앱 이름으로 연결한 후 새 트랜잭션은 이전 응용 프로그램의 컨텍스트 또는 보고된 데이터 없이 새 응용 프로그램에 보고를 시작합니다.

이 메서드는 API에 대한 각 호출(동일한 앱 이름이더라도)이 현재 트랜잭션 데이터를 삭제하고 트랜잭션 추적의 추가 불연속성으로 이어지기 때문에 한 번만 호출하도록 되어 있습니다.

매개변수

매개변수

설명

function newrelic_set_appname (string $name) : bool

$name

필수의. 앱 메트릭의 이름은 New Relic 사용자 인터페이스에서 보고되어야 합니다. newrelic.appname 과 동일한 형식을 사용하고 각각을 세미콜론 ; 으로 구분하여 여러 애플리케이션 이름을 설정할 수 있습니다.

function newrelic_set_appname (string $name, string $license, bool $xmit) : bool

$name

필수의. 앱 메트릭의 이름은 New Relic 사용자 인터페이스에서 보고되어야 합니다. newrelic.appname 과 동일한 형식을 사용하고 각각을 세미콜론 ; 으로 구분하여 여러 애플리케이션 이름을 설정할 수 있습니다.

$license

필수(빈 문자열일 수 있음). 다른 New Relic 계정에 메트릭을 보고하려면 다른 라이센스 키를 지정하십시오. 빈 문자열로 설정하면 에이전트의 newrelic.ini 파일에 있는 라이선스 키로 기본 설정됩니다.

$xmit

부울

선택 과목. 기본값은 false 입니다.

false 이거나 생략된 경우 에이전트는 현재 트랜잭션을 삭제하고 이 호출까지 캡처된 모든 데이터는 손실됩니다.

true 인 경우 에이전트는 이 호출을 실행하기 직전에 수집된 데이터를 보냅니다. 데이터는 이전 앱 이름과 연결됩니다 . 에이전트가 데이터를 덤프하는 데 몇 밀리초가 걸리므로 성능에 아주 약간의 영향을 미칩니다.

반환 값

애플리케이션 이름이 성공적으로 변경되었으면 true 을 반환하고 그렇지 않으면 false 을 반환합니다.

단일 앱 이름 설정

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1");
    }
    ...
}

두 개의 앱 이름 설정

이 예에서는 여러 앱 이름을 설정합니다.

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1;App2");
    }
    ...
}

앱 이름 및 라이선스 키 설정

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "01234567890abcde01234567890abcde01234567890");
    }
    ...
}

앱 이름 설정 및 이전 데이터 유지

이 예에서는 앱 이름을 설정하고 기존 데이터를 유지하지만 라이선스 키는 변경하지 않습니다.

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "", true);
    }
    ...
}

앱 이름 및 라이선스 키 설정 및 이전 데이터 유지

이 예에서는 앱 이름과 라이선스 키를 설정하고 기존 데이터를 유지합니다.

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "01234567890abcde01234567890abcde01234567890", true);
    }
    ...
}
Copyright © 2022 New Relic Inc.

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