Node.js 에이전트 API

newrelic.setTransactionName(name)

요청 명명 요구 사항 에 따라 현재 요청의 이름을 지정합니다. 요청 처리가 시작된 후 요청이 완료되기 전에 언제든지 HTTP 요청 처리기 컨텍스트 내에서 이 함수를 호출할 수 있습니다. 일반적으로 요청 및 응답 개체가 범위 내에 있는 경우 이름을 설정할 수 있습니다.

명시적으로 newrelic.setTransactionName() 을 호출하면 Express 또는 Restify 경로에서 설정한 이름이 재정의됩니다. 또한 newrelic.setTransactionName() 및 newrelic.setControllerName() 에 대한 호출은 서로를 덮어씁니다. 요청이 종료되기 전에 마지막으로 실행한 것이 승리합니다.

newrelic.setControllerName(name, [action])

선택적으로 현재 컨트롤러 작업을 포함하는 컨트롤러 스타일 패턴을 사용하여 현재 요청의 이름을 지정합니다. 작업이 생략되면 New Relic은 HTTP 메서드(GET, POST 등)를 작업으로 포함합니다. newrelic.setControllerName() 을(를) 호출할 수 있는 경우에 대한 규칙은 요청 이름 지정 요구사항 을 포함하여 newrelic.setTransactionName() 에 대한 규칙과 동일합니다.

명시적으로 newrelic.setControllerName() 을 호출하면 Express 또는 Restify 경로에서 설정한 이름이 재정의됩니다. 또한 newrelic.setTransactionName() 및 newrelic.setControllerName() 에 대한 호출은 서로를 덮어씁니다. 요청이 종료되기 전에 마지막으로 실행한 것이 승리합니다.

newrelic.instrument(moduleName, onRequire [, onError])

특정 모듈에 대한 계측 콜백을 설정합니다.

제공된 onRequire 콜백은 지정된 모듈이 require 로 로드될 때 시작됩니다. moduleName 매개변수는 require 에 전달될 문자열이어야 합니다. 예: 'express' 또는 'amqplib/callback_api' . onRequire 매개변수에서 오류가 발생하면 선택적 onError 콜백이 호출됩니다. 이것은 계측을 디버깅하는 데 유용합니다.

이 방법을 사용하여 다음을 수행합니다.

• 현재 New Relic에서 계측하지 않는 모듈에 대한 계측을 추가합니다.
• 자신의 코드를 계측합니다.
• Node.js 에이전트의 내장 계측을 자신의 계측으로 교체하십시오.

자세한 내용 은 Github에서 New Relic의 Node.js 계측 튜토리얼을 참조하세요.

newrelic.instrumentDatastore(moduleName, onRequire [, onError])

데이터 저장소 모듈에 대한 계측 콜백을 설정합니다.

이 메서드는 데이터 저장소에 특화된 shim 을 제공한다는 점을 제외하면 newrelic.instrument() 와 같습니다. 자세한 내용 은 Github에서 New Relic의 Node.js 데이터 저장소 계측 자습서를 참조하세요.

newrelic.instrumentLoadedModule(moduleName, moduleInstance)

instrumentLoadedModule 메서드를 사용하면 require('newrelic'); 을 앱 기본 모듈의 첫 번째 줄로 포함할 수 없는 상황에서 특정 모듈에 재고 계측을 추가할 수 있습니다.

// load the agent
const newrelic = require('newrelic');

// module loaded before newrelic
const expressModule = require('express');

// instrument express after the agent has been loaded
newrelic.instrumentLoadedModule(
  'express',    // the module's name, as a string
  expressModule // the module instance
);

newrelic.instrumentMessages(moduleName, onRequire [, onError])

메시지 서비스 클라이언트 모듈에 대한 계측 콜백을 설정합니다.

이 메서드는 메시지 서비스 전문 shim을 제공한다는 점을 제외하면 newrelic.instrument() 와 같습니다. 자세한 내용 은 Github에서 New Relic의 Node.js 메시지 서비스 계측 자습서를 참조하세요.

newrelic.instrumentWebframework(moduleName, onRequire [, onError])

웹 프레임워크 모듈에 대한 계측 콜백을 설정합니다.

이 메서드는 웹 프레임워크에 특화된 shim 을 제공한다는 점을 제외하면 newrelic.instrument() 와 같습니다. 자세한 내용 은 Github에서 New Relic의 Node.js 웹 프레임워크 계측 자습서를 참조하세요.

newrelic.startWebTransaction(url, handle)

지정된 웹 트랜잭션을 계측합니다. 이 API 호출을 사용하여 New Relic 이 자동으로 감지하지 않는 트랜잭션을 계측할 수 있습니다.

• url 은 트랜잭션 이름을 정의하며 정적이어야 합니다. 사용자 ID와 같은 변수 데이터를 포함하지 마십시오.
• handle 은 계측하려는 함수를 정의합니다.

New Relic은 자동 계측 및 startSegment() 을 통한 수동 계측으로 캡처되는 모든 측정항목을 캡처합니다.

트랜잭션 시작 시 newrelic.getTransaction() 를 호출하여 사용자 정의 트랜잭션을 수동 으로 처리하고 완료되면 transaction.end() 을 호출해야 합니다. New Relic은 newrelic.startWebTransaction() 가 호출될 때 트랜잭션 타이밍을 시작하고 transaction.end() 이 호출될 때 트랜잭션을 종료합니다.

트랜잭션의 끝을 나타내는 약속을 반환할 수도 있습니다. 이 약속이 거부되면 New Relic의 오류 추적에 자동으로 연결되지 않습니다. noticeError() 을(를) 사용하여 수동으로 수행해야 합니다.

newrelic.startBackgroundTransaction(name, [group], handle)

지정된 백그라운드 트랜잭션을 계측합니다. 이 API 호출을 사용하여 New Relic의 계측을 확장하여 백그라운드 트랜잭션에서 데이터를 캡처 할 수 있습니다.

• name 은 트랜잭션 이름을 정의하며 정적이어야 합니다. 사용자 ID와 같은 변수 데이터를 포함하지 마십시오.
• group 은 선택사항이며 사용자 인터페이스의 트랜잭션 유형 을 통해 유사한 작업을 함께 그룹화할 수 있습니다. name 과 마찬가지로 { group 는 정적이어야 합니다.
• handle 은 계측하려는 전체 백그라운드 작업을 포함하는 함수를 정의합니다.

New Relic은 자동 계측 및 startSegment() 을 통한 수동 계측으로 캡처되는 모든 측정항목을 캡처합니다.

트랜잭션 시작 시 newrelic.getTransaction() 를 호출하여 사용자 정의 트랜잭션을 수동 으로 처리하고 완료되면 transaction.end() 을 호출해야 합니다. New Relic은 newrelic.startBackgroundTransaction() 가 호출될 때 트랜잭션 타이밍을 시작하고 transaction.end() 이 호출될 때 트랜잭션을 종료합니다.

트랜잭션의 끝을 나타내기 위해 약속을 반환할 수도 있습니다. 이 약속이 거부되면 New Relic의 오류 추적에 자동으로 연결되지 않습니다. noticeError() 을(를) 사용하여 수동으로 수행해야 합니다.

newrelic.getTransaction()

현재 실행 중인 트랜잭션의 핸들을 반환합니다. 그런 다음 이 핸들을 사용하여 모든 컨텍스트에서 지정된 트랜잭션과 안전하게 상호 작용할 수 있습니다. newrelic.startWebTransaction() 및 newrelic.startBackgroundTransaction() 과 함께 사용하는 것이 가장 좋습니다.

자세한 내용은 트랜잭션 핸들 섹션을 참조하십시오.

newrelic.endTransaction()

현재 웹 또는 백그라운드 사용자 지정 트랜잭션을 종료합니다. 이 메서드는 호출될 때 올바른 트랜잭션 컨텍스트에 있어야 합니다. 이 API 호출은 인수를 사용하지 않습니다.

newrelic.startSegment(name, record, handler, callback)

특정 방법을 계측 하여 트랜잭션에 대한 가시성을 향상시키 거나 선택적으로 이를 메트릭으로 전환합니다.

• name 은 세그먼트의 이름을 정의합니다. 이 이름은 트랜잭션 추적 및 New Relic UI의 새 메트릭으로 표시됩니다.
• record 플래그는 세그먼트를 측정항목으로 기록해야 하는지 여부를 정의합니다.
• handler 은 세그먼트로 추적하려는 함수입니다.
• 선택적 callback 은 작업이 완료된 후 실행되도록 핸들러에 전달되는 함수입니다.

에이전트는 startSegment 이 호출될 때 세그먼트 타이밍을 시작합니다. 세그먼트는 handler 실행이 완료되거나 제공되는 경우 callback 가 실행될 때 종료됩니다.

newrelic.recordMetric(name, value)

일반적으로 특정 기간과 관련된 이벤트 기반 측정항목을 기록하려면 recordMetric 을 사용합니다. name 은 표준 메트릭 명명 규칙을 따르는 문자열이어야 합니다. value 는 일반적으로 숫자이지만 객체일 수도 있습니다.

• value 이 숫자 값인 경우 이벤트와 관련된 측정의 크기를 나타내야 합니다. 예를 들어 특정 메서드 호출에 대한 기간입니다.
• value 이 객체인 경우 count , total , min , max 및 sumOfSquares 키가 모두 숫자 값과 함께 포함되어야 합니다. 이 양식은 자체적으로 측정항목을 집계하고 주기적으로 보고하는 데 유용합니다. 예를 들어 setInterval 에서. 이러한 값은 동일한 메트릭에 대해 이전에 수집된 값과 함께 집계됩니다. 이러한 키의 이름은 플랫폼 API에서 사용하는 키의 이름과 일치합니다.

newrelic.incrementMetric(name, [amount])

incrementMetric 을 사용하여 단순 카운터 역할을 하는 측정항목을 업데이트합니다. 선택한 측정항목의 개수는 지정된 양만큼 증가하며 기본값은 1입니다.

newrelic.recordCustomEvent(eventType, attributes)

일반적으로 특정 기간과 관련된 이벤트 기반 측정항목을 기록하려면 recordCustomEvent 을 사용합니다.

• eventType 은 255자 미만의 영숫자 문자열이어야 합니다.
• attributes 은 키 및 값 쌍의 객체여야 합니다. 키는 255자 미만이어야 하고 값은 문자열, 숫자 또는 부울이어야 합니다.

const attributes = {
  attribute1: 'value1',
  attribute2: 2
};

newrelic.recordCustomEvent('MessagingEvent', attributes);

newrelic.recordLogEvent({message, level})

자동 로깅 계측이 로깅 프레임워크에 충분하지 않은 경우 recordLogEvent 를 사용하여 로그 이벤트를 기록합니다. 허용되는 매개변수 유형에 대한 자세한 내용은 자동 생성된 문서 를 참조하세요.

const error = new SystemError('invalid state');
const timestamp = Date.now();

newrelic.recordLogEvent({message: 'an error happened', level: 'error', timestamp, error});

transactionHandle.end([callback])

transactionHandle.end 을 사용하여 핸들 인스턴스에서 참조하는 트랜잭션을 종료합니다.

트랜잭션이 완전히 종료되면 callback 이 호출됩니다. 첫 번째 인수로 콜백에 전달된 완료된 트랜잭션입니다.

transactionHandle.ignore()

핸들 인스턴스에서 참조하는 트랜잭션을 무시하려면 transactionHandle.ignore 을 사용합니다.

transactionHandle.insertDistributedTraceHeaders(headers)

이 호출과 파트너 호출 acceptDistributedTraceHeaders 을 사용하는 방법에 대한 컨텍스트를 보려면 먼저 에이전트 API로 분산 추적 사용을 읽으십시오.

transactionHandle.insertDistributedTraceHeaders 분산 추적을 구현하는 데 사용됩니다. W3C Trace Context 헤더와 New Relic Distributed Trace 헤더를 추가하여 전달된 headers 맵을 수정합니다. New Relic 헤더는 구성에서 distributed_tracing.exclude_newrelic_header: true 로 비활성화할 수 있습니다. 이 메서드는 New Relic Distributed Trace 페이로드만 생성하는 더 이상 사용되지 않는 createDistributedTracePayload 메서드를 대체합니다.

// Call newrelic.getTransaction to retrieve a handle on the current transaction.
const transactionHandle = newrelic.getTransaction();

// This could be a header object from an incoming request as well
const headersObject = {};
newrelic.startBackgroundTransaction('background task', function executeTransaction() {
  const transaction = newrelic.getTransaction();
  // generate the headers
  transaction.insertDistributedTraceHeaders(headersObject);
});

transactionHandle.acceptDistributedTraceHeaders(transportType, headers)

이 호출과 파트너 호출 insertDistributedTraceHeaders 을 사용하는 방법에 대한 컨텍스트를 보려면 먼저 에이전트 API로 분산 추적 사용을 읽으십시오.

transactionHandle.acceptDistributedTraceHeaders 분산 추적에 포함하기 위해 호출된 서비스를 계측하는 데 사용됩니다. insertDistributedTraceHeaders 에서 생성하거나 다른 W3C 추적 컨텍스트 호환 추적 프로그램에서 생성한 페이로드를 수락하여 추적의 범위를 연결합니다. 이 메서드는 들어오는 요청의 헤더를 수락하고 W3C 추적 컨텍스트 헤더를 찾고 찾지 못하면 New Relic 분산 추적 헤더로 대체합니다. 이 메서드는 New Relic 분산 추적 페이로드만 처리하는 더 이상 사용되지 않는(현재 버전 7.0.0에서 제거된) acceptDistributedTracePayload 메서드를 대체합니다.

transportType 다음 문자열 중 하나여야 합니다.

• AMQP
• HTTP
• HTTPS
• 아이언MQ
• JMS
• 카프카
• 다른
• 대기줄
• 알려지지 않은

headers 들어오는 요청의 모든 헤더를 포함하는 객체여야 합니다. 키는 소문자여야 합니다.

// incoming Kafka message headers
const headersObject = message.headers;

// Call newrelic.getTransaction to retrieve a handle on the current transaction.
const transactionHandle = newrelic.getTransaction();

newrelic.startBackgroundTransaction('background task', function executeTransaction() {
  const transaction = newrelic.getTransaction();

  // accept the headers
  transaction.acceptDistributedTraceHeaders('Kafka', headersObject);
});

transactionHandle.createDistributedTracePayload()

파트너 호출 acceptDistributedTracePayload 과 함께 이 호출을 사용하는 방법에 대한 지침은 에이전트 API로 분산 추적 사용 을 참조하십시오.

이 호출은 분산 추적을 구현하는 데 사용됩니다. acceptDistributedTracePayload 을 사용하여 수신 애플리케이션에서 읽는 페이로드를 생성합니다.

DistributedTracePayload 객체에는 다양한 형식으로 페이로드를 생성하는 데 사용되는 두 가지 메서드가 있습니다.

• DistributedTracePayload#text: 페이로드의 JSON 표현을 반환합니다.

  중첩된 백그라운드 트랜잭션 연결

  // Call newrelic.getTransaction to retrieve a handle on the current transaction.
  var transactionHandle = newrelic.getTransaction();
  var payload = transactionHandle.createDistributedTracePayload();
  var jsonPayload = payload.text();
  newrelic.startBackgroundTransaction('background task', function executeTransaction() {
    var backgroundHandle = newrelic.getTransaction();
    // Link the nested transaction by accepting the payload with the background transaction's handle
    backgroundHandle.acceptDistributedTracePayload(jsonPayload);
  });

  복사

• DistributedTracePayload#httpSafe: 페이로드의 base64로 인코딩된 JSON 표현을 반환합니다.

  나가는 요청에 페이로드 배치

  // Call newrelic.getTransaction to retrieve a handle on the current transaction.
  var transactionHandle = newrelic.getTransaction();
  var payload = transactionHandle.createDistributedTracePayload();
  // Place the base64 encoded value on an outbound request header.
  req.headers[myTracingHeader] = payload.httpSafe();

  복사

transactionHandle.acceptDistributedTracePayload(payload)

이 호출과 파트너 호출 createDistributedTracePayload 을 사용하는 방법에 대한 컨텍스트를 보려면 먼저 에이전트 API로 분산 추적 사용을 읽으십시오.

transactionHandle.acceptDistributedTracePayload 분산 추적에 포함하기 위해 호출된 서비스를 계측하는 데 사용됩니다. createDistributedTracePayload 에 의해 생성된 페이로드를 수락하여 추적의 범위를 연결합니다.

transactionHandle.isSampled()

이 추적이 샘플링되는지 여부를 반환합니다.

newrelic.addCustomAttribute(name, value)

New Relic UI에서 트랜잭션 추적과 함께 표시할 사용자 정의 속성 값을 설정합니다. 이것은 트랜잭션 컨텍스트 내에서 호출되어야 사용자 정의 속성을 설정할 장소가 있습니다. 사용자 지정 속성은 APM의 트랜잭션 추적 세부 정보 보기와 트랜잭션 오류에 나타납니다.

newrelic.addCustomAttribute('attribute1', 'value1')

newrelic.addCustomAttributes(attributes)

New Relic UI에서 트랜잭션 추적과 함께 표시할 여러 사용자 정의 속성 값을 설정합니다. 속성은 단일 개체로 전달되어야 합니다. 이것은 트랜잭션 컨텍스트 내에서 호출되어야 사용자 정의 속성을 설정할 수 있습니다. 사용자 정의 속성은 트랜잭션 추적 세부 정보 보기 및 트랜잭션 오류에 나타납니다.

const attributes = {
  attribute1: 'value1',
  attribute2: 2
};

newrelic.addCustomAttributes(attributes);

newrelic.addCustomSpanAttribute(name, value)

New Relic UI에서 트랜잭션 추적 범위와 함께 표시할 사용자 지정 범위 속성 값을 설정합니다. 이것은 활성 세그먼트/스팬의 컨텍스트 내에서 호출되어야 사용자 정의 스팬 속성을 설정할 수 있습니다. 사용자 지정 범위 속성은 범위 세부 정보 보기의 속성 섹션에 나타납니다.

newrelic.addCustomSpanAttribute('attribute1', 'value')

newrelic.addCustomSpanAttributes(attributes)

New Relic UI에서 트랜잭션 추적 범위와 함께 표시할 여러 사용자 지정 범위 속성 값을 설정합니다. 속성은 단일 개체로 전달되어야 합니다. 이것은 활성 세그먼트/스팬의 컨텍스트 내에서 호출되어야 사용자 정의 스팬 속성을 설정할 수 있습니다. 사용자 지정 범위 속성은 범위 세부 정보 보기의 속성 섹션에 나타납니다.

const attributes = {
  attribute1: 'value1',
  attribute2: 'value2'
};

newrelic.addCustomSpanAttributes(attributes);

newrelic.getBrowserTimingHeader()

브라우저 모니터링 을 활성화하기 위해 HTML 페이지의 헤더에 삽입할 HTML 스니펫을 반환합니다. HTML은 브라우저에 작은 JavaScript 파일을 가져오고 페이지 타이머를 시작하도록 지시합니다.

newrelic.noticeError(error, [customAttributes], [expected])

앱이 도메인 또는 try/catch 절을 사용하여 자체 오류 처리를 수행하지만 앱에서 얼마나 많은 오류가 발생하는지에 대한 모든 정보를 중앙에서 관리하려는 경우 이 호출을 사용합니다. 다른 Node.js 호출과 달리 경로 핸들러 외부에서 사용할 수 있지만 트랜잭션 범위 내에서 호출하면 추가 컨텍스트가 있습니다.

error Error 또는 해당 하위 유형 중 하나여야 하지만 API는 연결된 .message 또는 .stack 속성이 있는 문자열 및 객체를 처리합니다.

customAttributes New Relic UI에 표시되는 모든 사용자 정의 속성의 선택적 개체입니다.

expected 오류를 예상한 오류로 분류하기 위한 선택적 부울입니다. noticeError 로 수집된 오류가 expected 인 경우 수집 및 보고되지만 Apdex 또는 오류율 메트릭에는 영향을 미치지 않습니다. 기본적으로 expected false 입니다.

예시:

try {
  performSomeTask();
} catch(err) {
  newrelic.noticeError(
    err,
    { extraInformation: "error already handled in the application" },
    true
  );
}

newrelic.setErrorGroupCallback(callback)

이 메소드를 사용하면 사용자 정의 콜백을 정의하여 오류 그룹 이름을 생성할 수 있습니다. 이 콜백은 오류 수신함에서 error.group.name 에이전트 속성을 통해 유사한 오류를 그룹화하는 데 사용됩니다.

제공된 함수는 문자열을 반환하고 개체를 인수로 받아야 합니다. 개체에는 발생한 오류와 관련된 정보가 포함되며 형식은 다음과 같습니다.

{
  "customAttributes": object,
  "request.uri": string,
  "http.statusCode": string,
  "http.method": string,
  "error": Error,
  "error.expected": boolean
}

이 함수를 여러 번 호출하면 이 콜백 함수의 이전에 정의된 버전이 대체됩니다.

이 기능에 대해 자세히 알아보려면 예제 앱 을참조하십시오.

newrelic.setIgnoreTransaction(ignored)

주어진 요청을 무시할지 여부를 모듈에 알립니다. 이를 통해 긴 폴링, 관련 없는 경로 또는 시간이 많이 소요될 요청을 명시적으로 필터링할 수 있습니다. 또한 그렇지 않으면 무시될 요청에 대한 메트릭을 수집할 수도 있습니다.

• 트랜잭션을 무시하려면 매개변수를 true로 설정합니다. 그러면 트랜잭션이 무시됩니다.
• 이 함수로 트랜잭션이 무시되는 것을 방지하려면 false 매개변수를 전달하십시오.
• null 또는 undefined 을 전달해도 트랜잭션이 무시되는지 여부는 변경되지 않습니다.

newrelic.setUserID(string)

이 방법은 고유 식별자를 트랜잭션 이벤트, 트랜잭션 추적 및 트랜잭션 내의 오류와 연결하는 방법을 제공합니다. 새 속성인 enduser.id가 오류에 추가되고 오류 수신함에 보고됩니다.

newrelic.shutdown(options, callback)

에이전트를 정상적으로 종료하려면 이 방법을 사용하십시오. 두 매개변수는 모두 선택 사항입니다. 다음은 매개변수를 보여주는 개요 표입니다.

다음은 개체 종료 옵션을 보여주는 세부 정보 테이블입니다.

예시:

newrelic.shutdown({collectPendingData: true, timeout: 10000}, (error) => {
  process.exit();
});

newrelic.getLinkingMetadata()

추적 또는 엔터티를 연결하는 데 사용할 수 있는 키/값 쌍을 반환합니다.

의미 있는 값을 가진 항목만 포함합니다. 예를 들어 분산 추적이 비활성화된 경우 trace.id 은 포함되지 않습니다.

newrelic.getTraceMetadata()

현재 추적 ID와 범위 ID가 포함된 개체를 반환합니다.

들어오는 요청 URL을 pattern 에 일치시키고 일치하는 New Relic 트랜잭션의 이름을 { name }로 지정하기 위한 {pattern : "pattern", name : "name"} 형식의 규칙 목록입니다. 이것은 패턴을 문자열이나 JavaScript 정규식 리터럴로 설정할 수 있는 정규식 바꾸기 역할을 하며 패턴과 이름이 모두 필요합니다.

정규식을 문자열로 전달할 때 백슬래시를 이스케이프 처리합니다. 에이전트는 패턴에서 문자열로 제공될 때 백슬래시를 유지하지 않기 때문입니다. 패턴이 순서대로 평가되고 본질적으로 최종적이므로 가장 구체적인 것부터 가장 일반적인 것까지 구성 규칙을 정의하십시오. 자세한 내용은 명명 지침 을 참조하십시오.

이는 쉼표로 구분된 JSON 객체 리터럴 목록으로 전달된 여러 규칙을 사용하여 환경 변수 NEW_RELIC_NAMING_RULES 로 설정할 수도 있습니다.

NEW_RELIC_NAMING_RULES='{"pattern":"^t","name":"u"},{"pattern":"^u","name":"t"}'

선택적 규칙 속성

추가 선택적 속성을 사용할 수 있습니다.

pattern: '[0-9]+',
replace_all: true

명명 규칙 테스트

Node.js 에이전트는 명명 규칙을 테스트하기 위한 명령줄 도구와 함께 제공됩니다. 자세한 내용은 앱이 설치된 디렉터리의 터미널 창에서 다음 명령을 실행하세요.

$
node node_modules/.bin/newrelic-naming-rules

명명 규칙 예 [#examples-rules]

다음은 명명 규칙 및 결과의 몇 가지 예입니다.

pattern: "^/items/[0-9]+$",
name: "/items/:id"

/items/123   =>  /items/:id
/orders/123  =>  /orders/123   (not replaced since the rule is a full match)

pattern: "[0-9]+",
name: ":id"

/orders/123            =>  /orders/:id
/items/123             =>  /items/:id
/orders/123/items/123  =>  /orders/:id/items/123

pattern: "[0-9]+",
name: ":id",
replace_all: true

/orders/123/items/123  =>  /orders/:id/items/:id

pattern: '^/(items|orders)/[0-9]+$',
name: '/\\1/:id'

/orders/123  =>  /orders/:id
/items/123   =>  /items/:id

이는 여러 규칙이 쉼표로 구분된 패턴 목록으로 전달되는 환경 변수 NEW_RELIC_IGNORING_RULES 를 통해 설정할 수도 있습니다. 현재 패턴에서 쉼표를 이스케이프할 방법이 없습니다.

NEW_RELIC_IGNORING_RULES='^/socket\.io/\*/xhr-polling,ignore_me'

socket.io 를 사용하는 경우 즉시 규칙을 무시하는 사용 사례가 있습니다. socket.io 롱 폴링이 응답 시간 메트릭을 지배하고 애플리케이션의 Apdex 메트릭에 영향을 주지 않도록 하려면 다음과 같은 규칙을 추가하십시오.

// newrelic.js
exports.config = {
  // other configuration
  rules : {
    ignore : [
      '^\/socket\.io\/.*\/xhr-polling'
    ]
  }
};

rules.name 의 프로그래밍 방식 버전입니다. 이름 지정 규칙이 추가되면 Node.js 프로세스가 다시 시작될 때까지 제거할 수 없습니다. Node.js 에이전트의 구성을 통해 추가할 수도 있습니다. 두 매개변수가 모두 필요합니다.

rules.ignore 의 프로그래밍 방식 버전입니다. 무시 규칙이 추가되면 Node.js 프로세스가 다시 시작될 때까지 제거할 수 없습니다. Node.js 에이전트의 구성을 통해 추가할 수도 있습니다. 이 매개변수는 필수입니다.