사용자 정의 속성 수집

New Relic 솔루션에서 기본적으로 보고하지 않는 사용자 지정 데이터를 보고할 때 가장 인기 있는 두 가지 솔루션은 사용자 지정 속성과 사용자 지정 이벤트 입니다. 이 문서에서는 맞춤 속성을 사용하는 이유에 대해 자세히 설명합니다.

일부 New Relic 솔루션의 경우 사용자 지정 데이터를 New Relic에 보고 하는 한 가지 방법은 사용자 지정 속성 을 사용하는 것입니다. 데이터에 사용자 정의 속성을 추가하면 비즈니스에 대한 보다 심층적이고 사용자 정의된 분석을 수행할 수 있습니다. 예를 들어 New Relic 브라우저 모니터링의 경우 느리거나 실패한 요청과 관련된 사용자 이름을 추적하기 위해 사용자 정의 속성을 생성할 수 있습니다.

중요

사용자 지정 속성은 수집된 GB에 포함되며 청구 가능한 데이터입니다.

요구 사항

사용자 정의 속성은 다음과 같은 New Relic 솔루션에 사용할 수 있습니다.

APM
브라우저 모니터링
모바일 모니터링
인프라 모니터링
합성 모니터

아래에서 이러한 옵션에 대해 자세히 설명합니다.

사용자 정의 속성 생성 및 사용에 대한 권장 사항

New Relic에서 속성 은 연결된 이벤트 에 대한 메타데이터를 제공하는 키-값 쌍입니다.

사용자 정의 속성을 생성할 때 일반적인 패턴은 이름, ID, 이메일 등과 같은 사용자 정보를 캡처하는 것입니다. 이를 통해 운영 데이터와 비즈니스 데이터 간의 연결을 생성할 수 있습니다. 예를 들어 사용자 정보가 있는 경우 서비스 데스크 및 CRM 데이터를 New Relic의 운영 데이터와 연결합니다.

다른 유형의 비즈니스 컨텍스트에는 다음이 포함될 수 있습니다.

고객 토큰
고객 시장 부문
고객 가치 분류
URIStem에서 워크플로 제어 값이 명확하지 않음
사용자/제품/계정 권한 컨텍스트

운영 컨텍스트에는 다음이 포함될 수 있습니다.

사용된 기능 플래그
액세스한 데이터 저장소
액세스한 캐시
어떤 오류가 감지되고 무시되었는지(오류 분할)

사용자 정의 속성을 추가하면 New Relic에서 이를 쿼리하고 해당 데이터에서 사용자 정의 차트를 생성할 수 있습니다. 예를 들어 Java 에이전트 API 를 사용하여 Transaction 및 TransactionError 이벤트에 userId 속성을 추가한 경우 다음과 같이 해당 속성을 사용하여 NRQL 쿼리를 만들 수 있습니다.

SELECT count(*) FROM TransactionError 
WHERE userId = '1401961100' FACET dateOf(timestamp), `error.message` 
SINCE 1 week ago

APM: 사용자 정의 속성 기록

중요

NRQL에서 사용되는 예약어 목록을 검토하세요. 예약된 용어를 사용하면 문제가 발생할 수 있습니다.

APM에 대한 사용자 정의 속성을 활성화하고 사용하려면 에이전트에 대한 절차를 따르세요.

사용자 정의 속성 컬렉션은 Java에서 기본적으로 활성화됩니다. XML 및 Java 에이전트 API를 사용하여 사용자 정의 속성을 수집할 수 있습니다. 이 두 가지 방법은 서로 결합하여 사용할 수 있습니다. 사용자 정의 속성을 수집하려면 뉴렐릭 Java API jar가 애플리케이션의 클래스 경로에 있어야 합니다.

방법	How to do it
XML에서 속성 지정	XML을 사용하면 소스 코드를 변경하지 않고 사용자 정의 속성을 지정할 수 있습니다. 일부 논리적 패싯으로 그룹화된 사용자 정의 속성에 대해 여러 XML 파일을 가질 수 있습니다. XML을 통해 자바 앱에 대한 사용자 정의 속성을 설정하려면: XML 파일 형식, 메서드 및 클래스, 예제 에 대한 New Relic Java 에이전트 설명서를 검토하십시오. New Relic Java 에이전트 내의 `Extensions` 디렉터리에서 단일 XML 파일 을 만듭니다. XML 파일을 직접 편집하여 New Relic이 모니터링할 방법을 정의하십시오. 뉴렐릭 UI를 사용하여 XML 측정, 로그 파일을 정의합니다. 이를 위해서는 newrelic.yml 의 `common:` 블록에 추가 구성이 필요할 수 있습니다. 자세한 내용은 측정, 로그아웃 옵션 아래의 Report custom attributes 를 참조하세요.
에이전트의 API 호출	Example 1: Adding custom attributes to transactions 에이전트의 API를 사용하여 사용자 정의 속성을 수집하려면 관련 메소드를 호출하십시오. 속성을 기록하려는 각 메서드에 대해 `NewRelic.addCustomParameter(...)` 를 호출합니다. 선택사항: `attributes.include` 및 `attributes.exclude` 을 사용하여 특정 속성을 포함하거나 제외합니다. 예를 들어, `userId` 이라는 변수를 기록하려면 상위 메서드에 다음 코드를 포함합니다. `NewRelic.addCustomParameter("userId", userId);` Example 2: Adding custom attributes to spans in distributed traces 에이전트의 API를 사용하여 사용자 정의 속성을 수집하려면 관련 메소드를 호출하십시오. 속성을 기록하려는 각 범위(현재 실행 중인 메서드)에 대해 `NewRelic.getAgent().getTracedMethod().addCustomAttribute(...)` 를 호출합니다. 선택사항: `span_events.attributes.include` 및 `span_events.attributes.exclude` 을 사용하여 특정 속성을 포함하거나 제외합니다. 예를 들어 현재 범위에 `userId` 이라는 변수를 기록하려면 연결된 메서드에 다음 코드를 포함합니다. `NewRelic.getAgent().getTracedMethod().addCustomAttribute("userId", userId);`
사용자 속성 수집	Java 에이전트에는 사용자 속성을 활성화 하고 `HttpServletRequest.getUserPrincipal()` 에서 사용자 정보를 맞춤 속성으로 수집하는 기본 제공 메커니즘도 포함되어 있습니다.

방법

How to do it

XML에서 속성 지정

XML을 사용하면 소스 코드를 변경하지 않고 사용자 정의 속성을 지정할 수 있습니다. 일부 논리적 패싯으로 그룹화된 사용자 정의 속성에 대해 여러 XML 파일을 가질 수 있습니다.

XML을 통해 자바 앱에 대한 사용자 정의 속성을 설정하려면:

XML 파일 형식, 메서드 및 클래스, 예제 에 대한 New Relic Java 에이전트 설명서를 검토하십시오.
New Relic Java 에이전트 내의 Extensions 디렉터리에서 단일 XML 파일 을 만듭니다.
XML 파일을 직접 편집하여 New Relic이 모니터링할 방법을 정의하십시오.
뉴렐릭 UI를 사용하여 XML 측정, 로그 파일을 정의합니다. 이를 위해서는 newrelic.yml 의 common: 블록에 추가 구성이 필요할 수 있습니다. 자세한 내용은 측정, 로그아웃 옵션 아래의 Report custom attributes 를 참조하세요.

에이전트의 API 호출

Example 1: Adding custom attributes to transactions

에이전트의 API를 사용하여 사용자 정의 속성을 수집하려면 관련 메소드를 호출하십시오.

속성을 기록하려는 각 메서드에 대해 NewRelic.addCustomParameter(...) 를 호출합니다.
선택사항: attributes.include 및 attributes.exclude 을 사용하여 특정 속성을 포함하거나 제외합니다.
예를 들어, userId 이라는 변수를 기록하려면 상위 메서드에 다음 코드를 포함합니다.
```
NewRelic.addCustomParameter("userId", userId);
```
Example 2: Adding custom attributes to spans in distributed traces
에이전트의 API를 사용하여 사용자 정의 속성을 수집하려면 관련 메소드를 호출하십시오.
속성을 기록하려는 각 범위(현재 실행 중인 메서드)에 대해 NewRelic.getAgent().getTracedMethod().addCustomAttribute(...) 를 호출합니다.
선택사항: span_events.attributes.include 및 span_events.attributes.exclude 을 사용하여 특정 속성을 포함하거나 제외합니다.
예를 들어 현재 범위에 userId 이라는 변수를 기록하려면 연결된 메서드에 다음 코드를 포함합니다.
```
NewRelic.getAgent().getTracedMethod().addCustomAttribute("userId", userId);
```

사용자 속성 수집

Java 에이전트에는 사용자 속성을 활성화 하고 HttpServletRequest.getUserPrincipal() 에서 사용자 정보를 맞춤 속성으로 수집하는 기본 제공 메커니즘도 포함되어 있습니다.

사용자 지정 특성 수집은 .NET에서 기본적으로 활성화됩니다. 사용자 정의 속성을 수집하려면 관련 API 메소드를 호출하십시오.

속성을 기록하려는 각 메소드에 대해 AddCustomAttribute 호출하세요.
선택 사항: include 및 exclude 구성 옵션을 사용하여 속성을 포함하거나 제외합니다.
예를 들어 쿠폰 코드(문자열) 및 항목 ID 코드(숫자)에 대한 속성을 기록하려면 다음 코드를 상위 메서드에 포함할 수 있습니다.
```
IAgent agent = NewRelic.Api.Agent.NewRelic.GetAgent();
ITransaction transaction = agent.CurrentTransaction;

transaction
    .AddCustomAttribute("Discount Code", "Summer Super Sale")
    .AddCustomAttribute("Item Code", 31456);
```

사용자 정의 속성 수집은 Node.js에서 기본적으로 활성화되어 있습니다. 사용자 정의 속성을 수집하려면 관련 API 메소드를 호출하십시오.

기록하려는 각 속성에 대해 newrelic.addCustomAttribute 호출하세요.
단일 호출을 사용하여 여러 속성을 기록하려면 newrelic.addCustomAttributes 사용하세요.
예를 들어 쿠폰 코드 및 항목 ID 코드에 대한 속성을 기록하려면 다음을 상위 메서드에 포함할 수 있습니다.
```
newrelic.addCustomAttributes({
  "Discount Code": "Summer Super Sale",
  "Item Code": 31456
});
```

사용자 정의 속성 수집은 PHP에서 기본적으로 활성화되어 있습니다. 사용자 정의 속성을 수집하려면 속성을 기록하려는 각 메소드에 대해 관련 API 메소드를 호출하십시오.

거래 이벤트 및 범위의 경우 newrelic_add_custom_parameter
범위에 대해서만 newrelic_add_custom_span_parameter
예를 들어, $userId 이라는 변수를 기록하려면 상위 메서드에 다음 코드를 포함합니다.
```
newrelic_add_custom_parameter ('userID', $userId)
```

사용자 정의 속성 컬렉션은 Python에서 기본적으로 활성화됩니다. 맞춤 속성을 수집하려면 속성을 기록하려는 각 메소드에 대해 add_custom_attribute 호출하세요.

예를 들어, user_id 이라는 변수를 기록하려면 상위 메서드에 다음 코드를 포함합니다.

newrelic.agent.add_custom_attribute('user_id', user_id)

Ruby에서는 사용자 정의 속성 컬렉션이 기본적으로 활성화되어 있습니다. 맞춤 속성을 수집하려면 add_custom_attributes 메소드를 호출하세요. 예를 들어, @user_id 이라는 변수를 기록하려면 상위 메소드에 다음 코드를 포함하십시오.

::NewRelic::Agent.add_custom_attributes({ user_id: @user.id })

브라우저 모니터링: 사용자 정의 속성 기록

브라우저 에이전트는 APM에서 브라우저 모니터링으로 속성을 전달 하거나 JavaScript를 통해 사용자 정의 속성을 지정 하여 페이지 보기 또는 브라우저 상호 작용과 관련된 추가 세부 정보를 지정하는 API를 제공합니다. APM 에이전트에서 전달된 값은 브라우저 에이전트에 의해 인코딩되고 브라우저 속성에 주입됩니다.

인프라 모니터링: 사용자 정의 속성 기록

당사의 인프라 모니터링을 통해 인프라 에이전트의 데이터에 주석을 추가하는 데 사용되는 사용자 정의 속성을 생성할 수 있습니다. 이 메타데이터를 사용하여 엔터티를 필터링하고 결과를 그룹화하고 데이터에 주석을 달 수 있습니다.

모바일 모니터링: 사용자 정의 속성 기록

모바일 에이전트에는 사용자 정의 속성을 기록하기 위한 API 호출이 포함됩니다.

사용자 정의 데이터에 대한 개요는 사용자 정의 대시보드 및 속성 삽입을참조하세요.
Android 방법: setAttribute
iOS 방법: setAttribute

합성 모니터: 사용자 정의 속성 기록

합성 모니터 사용자 정의 속성 을 참조하십시오.

사용자의 편의를 위해 제공되는 기계 번역입니다.

중요

요구 사항

사용자 정의 속성 생성 및 사용에 대한 권장 사항

APM: 사용자 정의 속성 기록

중요

가다

자바

.그물

노드.js

PHP

파이썬

루비

브라우저 모니터링: 사용자 정의 속성 기록

인프라 모니터링: 사용자 정의 속성 기록

모바일 모니터링: 사용자 정의 속성 기록

합성 모니터: 사용자 정의 속성 기록

사용자의 편의를 위해 제공되는 기계 번역입니다.

사용자 정의 속성 수집

중요

요구 사항 .css-21sua1{background:none;border:none;width:0;padding:0;}

사용자 정의 속성 생성 및 사용에 대한 권장 사항

APM: 사용자 정의 속성 기록

중요

자바

.그물

노드.js

PHP

파이썬

루비

브라우저 모니터링: 사용자 정의 속성 기록

인프라 모니터링: 사용자 정의 속성 기록

모바일 모니터링: 사용자 정의 속성 기록

합성 모니터: 사용자 정의 속성 기록

요구 사항