통사론
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에 대한 각 호출(동일한 앱 이름이더라도)이 현재 트랜잭션 데이터를 삭제하고 트랜잭션 추적의 추가 불연속성으로 이어지기 때문에 한 번만 호출하도록 되어 있습니다.
매개변수
매개변수 | 설명 |
---|---|
| |
끈 | 필수의. 앱 메트릭의 이름은 New Relic 사용자 인터페이스에서 보고되어야 합니다. |
| |
끈 | 필수의. 앱 메트릭의 이름은 New Relic 사용자 인터페이스에서 보고되어야 합니다. |
끈 | 필수(빈 문자열일 수 있음). 다른 New Relic 계정에 메트릭을 보고하려면 다른 라이센스 키를 지정하십시오. 빈 문자열로 설정하면 에이전트의 |
부울 | 선택 과목. 기본값은
|
반환 값
애플리케이션 이름이 성공적으로 변경되었으면 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);
}
...
}