통사론
NewRelic.recordMetric(string $name, string $category)NewRelic.recordMetric(string $name, string $category, double $value)NewRelic.recordMetric(string $name, string $category, int $count, double $totalValue, double $exclusiveValue)NewRelic.recordMetric(string $name, string $category, int $count, double $totalValue, double $exclusiveValue, MetricUnit $countUnit, MetricUnit $valueUnit)
사용자 정의 메트릭(임의의 숫자 데이터)을 기록합니다.
요구 사항
모든 에이전트 버전과 호환됩니다.
설명
이 방법을 사용하면 New Relic에서 자동으로 추적하지 않는 앱 활동에 대한 세부 정보를 제공하기 위해 임의의 사용자 지정 메트릭 을 기록할 수 있습니다. 호출은 선택적 세부 수준에 대해 여러 매개변수 집합을 허용합니다.
측정항목을 최대한 활용하려면 다음 지침에 따라 명확하고 간결한 측정항목 이름을 만드세요.
- 사용자 인터페이스에 표시하기에 적합한 사용 사례 및 공백 문자. 메트릭 이름은 있는 그대로 렌더링됩니다.
- 측정항목 이름을 대문자로 표시합니다.
- 측정항목의 이름을 지정할 때
/ ] [ | *
문자를 사용하지 마십시오. - 다중 바이트 문자를 피하십시오.
category
도 필요합니다. UI에 표시되며 맞춤 측정항목이 많은 경우 사용자 정의 측정항목을 구성하는 데 유용합니다. 사용자 정의 카테고리이거나 MetricCategory
열거형 을 사용하여 사전 정의된 카테고리일 수 있습니다.
매개변수
이 호출은 4개의 매개변수 세트를 허용합니다.
매개변수 | 설명 |
---|---|
| |
끈 | 필수의. 맞춤 측정항목에 대해 원하는 이름입니다. |
끈 | 필수의. 맞춤 또는 사전 정의된 측정항목 카테고리 를 사용하는 측정항목 카테고리 이름입니다. |
| |
끈 | 필수의. 맞춤 측정항목에 대해 원하는 이름입니다. |
끈 | 필수의. 맞춤 또는 사전 정의된 측정항목 카테고리 를 사용하는 측정항목 카테고리 이름입니다. |
더블 | 필수의. 측정항목의 값입니다. |
| |
끈 | 필수의. 맞춤 측정항목에 대해 원하는 이름입니다. |
끈 | 필수의. 맞춤 또는 사전 정의된 측정항목 카테고리 를 사용하는 측정항목 카테고리 이름입니다. |
더블 | 필수의. 측정항목의 값입니다. |
정수 | 필수의. 이벤트가 발생한 횟수입니다. |
더블 | 필수의. 녹음의 총 가치입니다. |
더블 | 필수의. 녹음의 배타적 가치 예를 들어, 총 값에 다른 곳에서 설명된 측정값이 포함되어 있는 경우입니다. |
| |
끈 | 필수의. 맞춤 측정항목에 대해 원하는 이름입니다. |
끈 | 필수의. 맞춤 또는 사전 정의된 측정항목 카테고리 를 사용하는 측정항목 카테고리 이름입니다. |
더블 | 필수의. 측정항목의 값입니다. |
정수 | 필수의. 이벤트가 발생한 횟수입니다. |
더블 | 필수의. 녹음의 총 가치입니다. |
더블 | 필수의. 녹음의 배타적 가치 예를 들어, 총 값에 다른 곳에서 설명된 측정값이 포함되어 있는 경우입니다. |
미터법 단위 | 필수의. |
미터법 단위 | 필수의. |
예
간단한 맞춤 측정항목
맞춤 측정항목 생성의 예:
NewRelic.recordMetric("Custom Metric Name","MyCategory", 1.0);NewRelic.recordMetric("Login Auth Metric", "Network", 1.0);
선택적 속성이 있는 측정항목
상담원 시작에 대한 사용자 지정 메트릭을 만드는 예:
NewRelic.recordMetric("Agent start", "Lifecycle");
경과 시간 값이 추가된 동일한 측정항목:
NewRelic.recordMetric("Agent start", "Lifecycle", 10.11f);
두 가지 경과 시간 및 독점 시간 계산:
NewRelic.recordMetric("Agent Start", "lifecycle", 2, 10.11, 1.23)
경과 시간, 배타적 시간 및 단위 값 매개변수의 5개 카운트:
NewRelic.recordMetric("Agent start", "Lifecycle", 5, 10.11, 1.23, MetricUnit.OPERATIONS, MetricUnit.SECONDS);