Go 에이전트 속성

속성 은 트랜잭션 이벤트, 오류 이벤트 및 추적된 오류에 대한 정보를 포함하는 키-값 쌍입니다. 기본 속성의 대상을 조정하고 다음을 포함하여 New Relic의 Go 언어 에이전트가 수집한 속성에 대한 사용자 정의 속성을 생성할 수 있습니다.

오류 추적
트랜잭션 이벤트
페이지 조회수

모니터링 세부사항의 추가 수준을 위해 사용자 정의 속성을 작성 하십시오.

Go 에이전트는 앱에서 다음과 같은 기본 속성 을 받습니다. 이러한 기본 설정을 조정하고 특정 대상에 대한 속성을 켜거나 끌 수 있습니다.

현재 스크립트가 실행되고 있는 서버 호스트의 이름으로, newrelic.AttributeHostDisplayName 으로 호출됩니다.

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용
거래 이벤트: 비활성화됨
이 속성을 제외하는 예:
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeHostDisplayName)
```

다음으로 호출되는 웹 요청에 대한 응답 상태 코드 newrelic.AttributeResponseCodeDeprecated

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseCodeDeprecated)

중요

Go 에이전트 v3.0.0부터 이 속성은 더 이상 사용되지 않는 것으로 표시되고 이름이 http.statusCode 으로 변경되었습니다. v3.x 에이전트는 이 속성을 계속 생성하지만 v4.0.0에서 제거됩니다.

다음으로 호출되는 HTTP 요청의 Accept 헤더에서 읽은 유형 newrelic.AttributeRequestAccept

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestAccept)

newrelic.AttributeRequestContentLength 으로 호출된 Content-Length 요청 헤더에서 읽은 수신 요청 크기(바이트)입니다.

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestContentLength)

newrelic.AttributeRequestContentType 으로 호출되는 Content-Type 요청 헤더에서 읽은 수신 요청 콘텐츠 유형입니다.

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestContentType)

newrelic.AttributeRequestHost 으로 호출되는 HTTP 호스트 요청 헤더의 이름입니다.

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestHost)

newrelic.AttributeRequestReferer 으로 호출되는 Referer 요청 헤더에서 읽은 수신 요청 참조자.

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 비활성화됨

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestReferer)

다음으로 호출되는 User-Agent HTTP 헤더의 내용 newrelic.AttributeRequestUserAgentDeprecated

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용
거래 이벤트: 비활성화됨
이 속성을 제외하는 예:
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestUserAgentDeprecated)
```
중요
Go 에이전트 v3.0.0부터 이 속성은 더 이상 사용되지 않는 것으로 표시되고 이름이 request.headers.userAgent 으로 변경되었습니다. v3.x 에이전트는 이 속성을 계속 생성하지만 v4.0.0에서 제거됩니다.

다음으로 호출되는 User-Agent HTTP 헤더의 내용 newrelic.AttributeRequestUserAgent

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용
거래 이벤트: 비활성화됨
이 속성을 제외하는 예:
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestUserAgent)
```
중요
이 속성은 에이전트의 v3.0.0에 추가되었으며 원래 request.headers.User-Agent 은(는) 결국 제거됩니다. 따라서 v3.x 에이전트는 User-Agent HTTP 헤더의 내용을 나타내는 두 가지 속성을 생성합니다. v3.x 에이전트를 사용할 때 속성을 완전히 제외하려면 이전 속성과 새 속성을 모두 포함해야 합니다. 예를 들어:
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestUserAgent, newrelic.AttributeRequestUserAgentDeprecated, )

다음으로 호출되는 들어오는 요청의 HTTP 메서드 newrelic.AttributeRequestMethod

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestMethod)

newrelic.AttributeResponseContentLength 으로 호출된 Content-Length 응답 헤더에서 읽은 발신 응답 크기(바이트)입니다.

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseContentLength)

Content-Type 응답 헤더에서 읽은 발신 응답 content-type은 newrelic.AttributeResponseContentType 으로 호출됩니다.

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용

거래 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseContentType)

다음으로 호출되는 웹 요청에 대한 응답 상태 코드 newrelic.AttributeResponseCode

기본 설정:

트랜잭션 추적: 사용
오류 수집기(추적된 오류): 사용
거래 이벤트: 사용
이 속성을 제외하는 예:
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseCode)
```
중요
이 속성은 에이전트의 v3.0.0에 추가되었으며 원래 httpResponseCode 은(는) 결국 제거됩니다. 따라서 v3.x 에이전트는 웹 요청에 대한 응답 상태 코드를 나타내는 두 가지 속성을 생성합니다. v3.x 에이전트를 사용할 때 속성을 완전히 제외하려면 이전 속성과 새 속성을 모두 포함해야 합니다. 예를 들어:
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseCode, newrelic.AttributeResponseCodeDeprecated, )

스팬 및 세그먼트 속성

Go 에이전트 v2.6.0 이상 이 있는 경우 스팬 및 세그먼트에 속성을 구성할 수 있습니다. Go 에이전트는 앱에서 다음과 같은 기본 속성 을 받습니다. 이러한 속성은 범위 이벤트 및 트랜잭션 추적 세그먼트에서만 찾을 수 있습니다. 이러한 기본 설정을 조정하고 특정 대상에 대한 속성을 켜거나 끌 수 있습니다.

데이터 저장소 세그먼트 의 경우 사용되는 컬렉션이며 newrelic.SpanAttributeDBCollection 으로 호출되는 테이블 또는 그룹을 나타냅니다.

기본 설정:

트랜잭션 추적 세그먼트: 사용

스팬 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeDBCollection)

데이터 저장소 세그먼트 의 경우 이는 데이터베이스 이름이며 newrelic.SpanAttributeDBInstance 으로 호출되는 쿼리가 실행되는 데이터베이스의 이름을 나타냅니다.

기본 설정:

트랜잭션 추적 세그먼트: 사용

스팬 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeDBInstance)

데이터 저장소 세그먼트 의 경우 실행 중인 매개변수화된 쿼리이며 newrelic.SpanAttributeDBStatement 으로 호출되는 수행 중인 쿼리를 나타냅니다.

기본 설정:

트랜잭션 추적 세그먼트: 사용

스팬 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeDBStatement)

외부 세그먼트 의 경우 이것은 newrelic.SpanAttributeHTTPMethod 으로 호출되는 발신 요청의 http 메소드입니다.

기본 설정:

트랜잭션 추적 세그먼트: 사용

스팬 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeHTTPMethod)

외부 세그먼트 의 경우 이는 newrelic.SpanAttributeHTTPURL 으로 호출되는 발신 요청의 URL입니다.

기본 설정:

트랜잭션 추적 세그먼트: 사용

스팬 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeHTTPURL)

데이터 저장소 세그먼트 의 경우 이는 호스트 이름과 쿼리 중인 데이터베이스의 포트이며 newrelic.SpanAttributePeerAddress 으로 호출됩니다.

기본 설정:

트랜잭션 추적 세그먼트: 사용

스팬 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributePeerAddress)

데이터 저장소 세그먼트 의 경우 이는 쿼리 중인 데이터베이스의 호스트 이름이며 newrelic.SpanAttributePeerHostname 으로 호출됩니다.

기본 설정:

트랜잭션 추적 세그먼트: 사용

스팬 이벤트: 사용

이 속성을 제외하는 예:

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributePeerHostname)

속성 대상 변경

다음 옵션을 사용하여 속성 대상을 변경합니다.

속성에 대한 전체 대상을 열거나 닫으려면 .Enabled 플래그를 true 또는 false 로 설정합니다.

예를 들어, 끄려면 오류 수집: config뒤에 다음을 추가합니다.

config.ErrorCollector.Attributes.Enabled = false

특정 속성을 켜거나 끄려면 .Include 또는 .Exclude 메서드를 사용합니다.

예를 들어 AttributeResponseCode 을 비활성화하려면 config 뒤에 다음을 추가합니다.

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseCode)

사용자 정의 속성 만들기

트랜잭션에서 이 방법을 사용하여 사용자 정의 속성을 추가하십시오.

txn.AddAttribute("key", "value")

txn 변수는 Go 트랜잭션을 위해 계측 된 변수입니다. 예를 들어:

txn.AddAttribute("product", "widget")
txn.AddAttribute("price", 19.99)
txn.AddAttribute("importantCustomer", true)

사용자 정의 속성 대상에 대한 기본 설정:

오류 수집기(추적된 오류): 사용
거래 이벤트: 사용

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

Go 에이전트 속성