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

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

반환 값

애플리케이션 이름이 성공적으로 변경되었으면 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);
    }
    ...
}