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 기반 솔루션이 권장됩니다.

통화 및 위치 동작

앱 모니터링을 시작한 후 최대한 빨리 그리고 가능한 한 얕은 호출 스택에서 이 함수를 호출하는 것이 좋습니다. 애플리케이션은 APM에서 별개의 엔터티이며 앱의 이름을 변경할 때 두 앱 이름의 데이터를 함께 묶을 것이 없습니다. newrelic_set_appname 함수를 사용하면 트랜잭션 추적이 중단될 수 있습니다. 즉, 새로운 트랜잭션은 새로운 앱 이름으로 보고되며 이전 앱 이름에 연결된 데이터와 연결할 것이 없습니다.

이 메서드는 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);
    }
    ...
}