통사론
newrelic_name_transaction(string $name)
현재 트랜잭션에 대한 사용자 정의 이름을 설정합니다.
요구 사항
모든 에이전트 버전과 호환됩니다.
트랜잭션 내에서 호출되어야 합니다.
설명
트랜잭션의 이름을 지정된 이름으로 설정합니다. 이것은 고유한 디스패치 체계를 구현하고 목적에 따라 트랜잭션의 이름을 지정하려는 경우에 유용할 수 있습니다. 이 함수를 가능한 한 빨리 호출하십시오.
중요
거래 이름 끝에 대괄호 [suffix]
를 사용하지 마십시오. New Relic은 자동으로 이름에서 괄호를 제거합니다. 대신 필요한 경우 괄호 (suffix)
또는 기타 기호를 사용하십시오.
URL, 페이지 제목, 16진수 값, 세션 ID 및 고유하게 식별할 수 있는 값과 같은 고유 값은 거래 이름을 지정할 때 사용해서는 안 됩니다. 대신 해당 데이터를 newrelic_add_custom_parameter()
호출을 사용하여 사용자 정의 매개변수로 트랜잭션에 추가하십시오.
중요
고유한 트랜잭션 이름을 1000개 이상 만들지 마십시오(예: 가능하면 URL로 이름을 지정하지 마십시오). 이렇게 하면 차트의 유용성이 떨어지고 계정당 고유한 거래 이름의 수에 대해 New Relic이 설정하는 제한에 부딪힐 수 있습니다. 또한 애플리케이션의 성능을 저하시킬 수 있습니다.
매개변수
매개변수 | 설명 |
---|---|
끈 | 필수의. 트랜잭션의 이름입니다. |
반환 값
트랜잭션 이름이 성공적으로 변경된 경우 true
을 반환합니다. false
이 반환되면 에이전트 로그에서 자세한 정보를 확인하십시오.
예
일반 트랜잭션 이름 지정
/product/123
및 /product/234
이(가) 있습니다. 각각에 대해 별도의 트랜잭션 이름을 생성하면 New Relic은 이 두 트랜잭션 이름에 대해 별도의 정보를 저장합니다. 대신 트랜잭션을 /product/*
로 저장하거나 코드 자체에 대해 중요한 것을 사용하여 트랜잭션 이름을 지정합니다(예: /Product/view
.
function example() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_name_transaction("/Product/view/"); } // ...}
MVC 프레임워크 네이밍
MVC 프레임워크에서 한 가지 좋은 옵션은 요청이 라우팅되는 newrelic_name_transaction()
호출을 사용하고 컨트롤러/작업 형식으로 트랜잭션 이름을 지정하는 것입니다.