이동 에이전트 구성

서버 측 구성 은 Go 에이전트 버전 2.7.0 이상 에서 사용할 수 있습니다. 이를 통해 UI에서 특정 설정을 구성할 수 있습니다. 이렇게 하면 변경 사항이 여러 호스트에서 실행되는 경우에도 모든 에이전트에 자동으로 적용됩니다. 사용 가능한 경우 이 문서에는 개별 구성 옵션 아래의 서버 측 구성에 대한 UI 레이블이 서버 측 레이블 로 포함됩니다.

진행 중인 구성에 설명된 단계에 따라 신청 프로세스에서 newrelic.NewApplication() 를 계속 호출해야 합니다. 서버 측 구성 옵션 세트는 로컬로 설정된 옵션을 덮어씁니다. 서버 측에서 모든 구성 옵션을 사용할 수 있는 것은 아니므로 newrelic.Config 구조체를 계속 업데이트할 수 있습니다.

로컬 프로세스 newrelic.Config 구조에서 Go 에이전트를 구성합니다. 이 구조체는 newrelic.NewApplication() 을 호출할 때 액세스할 수 있습니다.

1. main 함수 또는 init 블록에 다음을 추가합니다.

   app, err := newrelic.NewApplication(
       newrelic.ConfigAppName("Your Application Name"),
       newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
   )

   카피

   os.Getenv 을 사용하여 newrelic.ConfigLicense 에 전달된 문자열 리터럴 값으로 하드코딩하지 않고 환경에서 라이선스 키를 읽습니다. 라이선스 키 또는 기타 민감한 정보를 소스 코드에 두지 않는 것이 좋습니다. 그러면 SCM 리포지토리에 저장되어 권한이 없는 사람에게 공개될 수 있습니다.

2. newrelic.Config 구조체의 값을 업데이트하여 newrelic.ConfigOption 을 사용하여 애플리케이션을 구성합니다. 이들은 newrelic.Config 구조체에 대한 포인터를 허용하는 함수입니다. 애플리케이션을 추가로 구성하려면 newrelic.ConfigOption 을 추가하세요. 예를 들어 사전 정의된 옵션 중 하나를 사용하여 공통 구성을 수행할 수 있습니다.

   app, err := newrelic.NewApplication(
       newrelic.ConfigAppName("Your Application Name"),
       newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
       // add debug level logging to stdout
       newrelic.ConfigDebugLogger(os.Stdout),
   )

   카피

3. 또는 더 복잡한 구성을 수행하기 위해 고유한 newrelic.ConfigOption 를 만들 수 있습니다.

   app, err := newrelic.NewApplication(
       newrelic.ConfigAppName("Your Application Name"),
       newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
       newrelic.ConfigDebugLogger(os.Stdout),
       func(config *newrelic.Config) {
           // add more specific configuration of the agent within a custom ConfigOption
           config.HighSecurity = true
           config.CrossApplicationTracer.Enabled = false
       },
   )

   카피

앱의 메트릭을 New Relic 계정과 연결하는 데 사용되는 New Relic 라이선스 키 를 지정합니다. 라이선스와 앱 이름은 모두 New Relic 설치 프로세스 의 일부로 설정됩니다.

New Relic UI에서 데이터를 집계하는 데 사용되는 애플리케이션 이름 입니다. New Relic 설치 프로세스 의 일부로 라이선스와 앱 이름을 모두 설정합니다.

동시에 여러 앱에 데이터를 보고하려면 세미콜론으로 구분된 이름 목록을 지정하십시오. 세미콜론 자체 앞에 공백을 두지 마십시오. 예를 들어:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("YOUR_APP_NAME;APP_GROUP_1;ALL_APPS"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
)

true 일 때 에이전트는 앱에서 New Relic 수집기 로 데이터를 보냅니다.

New Relic 모니터링을 끄려면 이것을 false 으로 설정하십시오.

예를 들어:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.Enabled = false
    },
)

이 작업을 더 쉽게 하기 위해 ConfigEnabled 옵션을 사용할 수 있습니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    newrelic.ConfigEnabled(false),
)

이것은 개발 환경에 New Relic을 설치하거나 문제 해결을 위해 유용할 수 있습니다. Enabled 이 false 로 설정된 경우:

• New Relic Go 에이전트는 New Relic 수집기와 통신하지 않습니다.
• 에이전트는 고루틴을 생성하지 않습니다.
• 설치 중에는 라이센스 키가 필요하지 않습니다.

태그 추가 .

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.Labels = map[string]string{
            "Env":    "Dev",
            "Label2": "label2",
            "Label3": "label3",
            "Label4": "label4",
        }
    },
)

Logger 인터페이스를 사용하여 Go 로그 파일을 특정 위치 또는 로깅 시스템에 쓸 수 있습니다.

높은 보안 모드 는 특정 보안 설정을 적용하고 재정의되지 않도록 하여 에이전트가 민감한 데이터를 보내지 않도록 합니다. 높은 보안 모드는 다음을 수행합니다.

• SSL 켜기

• 오류 메시지 문자열 보고 끄기

• 맞춤 이벤트 보고 끄기

  이 설정은 UI의 해당 계정 설정과 일치해야 합니다. 예를 들어:

  app, err := newrelic.NewApplication(
      newrelic.ConfigAppName("Your Application Name"),
      newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
      func(config *newrelic.Config) {
          config.HighSecurity = true
      },
  )

  카피

  에이전트는 기본적으로 HTTPS를 통해 New Relic과 통신하며 New Relic은 APM 및 REST API에 대한 모든 트래픽에 대해 HTTPS가 필요합니다 .

HTTPS 또는 HTTP를 사용하여 New Relic에 데이터를 보낼지 여부를 제어합니다. 에이전트는 기본적으로 HTTPS(TLS 프로토콜 사용)를 통해 New Relic과 통신하고 New Relic은 APM 및 New Relic REST API에 대한 모든 트래픽에 대해 HTTPS가 필요합니다 .

이것은 APM UI에 표시되는 호스트 이름을 설정합니다. 이것은 선택적 구성입니다.

이것은 New Relic 수집기와의 http.Client 통신을 사용자 정의합니다. 이것은 프록시를 구성하는 데 사용할 수 있습니다.

true 이면 에이전트가 런타임 통계를 캡처합니다.

true 일 때 에이전트 는 맞춤 이벤트 를 New Relic 으로 보냅니다. 이 설정은 맞춤 이벤트를 비활성화하는 HighSecurity 에 의해 재정의됩니다.

사용자 지정 이벤트를 비활성화하려면 New Relic 구성 이 시작된 후 Go 앱에 다음을 배치하세요.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.CustomInsightsEvents.Enabled = false
    },
)

true 일 때 에이전트는 트랜잭션 이벤트를 수집합니다.

TransactionEvents.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

TransactionEvents.Attributes.Enabled 을 사용하여 트랜잭션 이벤트에 대한 속성 수집을 켜거나 끕니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

트랜잭션 이벤트에서 이름이 allAgentAttributeNames 인 속성 조각을 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.TransactionEvents.Attributes.Exclude = allAgentAttributeNames
    },
)

New Relic으로 보낼 분당 최대 트랜잭션 이벤트 수를 정의하며 최대 기본 최대 트랜잭션 이벤트 수는 10,000개입니다.

false 일 때 에이전트는 오류나 오류 추적을 수집하지 않습니다.

true 일 때 에이전트는 오류 분석 이벤트를 수집합니다.

이것은 어떤 HTTP 응답 코드가 오류로 무시되는지를 제어합니다.

100보다 크거나 같고 400보다 작은 응답 코드는 기본적으로 무시되며 이 함수를 호출할 때 지정할 필요가 없습니다. 응답 코드 0, 5, 404는 기본적으로 목록에 포함되지만 무시 목록에 추가할 때 지정해야 합니다.

이 함수의 기본 형식은 다음과 같습니다.

config.ErrorCollector.IgnoreStatusCodes = []int{
    0,                   // gRPC OK
    5,                   // gRPC NOT_FOUND
    http.StatusNotFound, // 404
}

위의 http.StatusNotFound 과 같이 응답 코드를 HTTP로 추가할 수도 있습니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
   newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.ErrorCollector.IgnoreStatusCodes = []int{0, 5, 404, 418}
    },
)

ErrorCollector.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

ErrorCollector.Attributes.Enabled 을 사용하여 오류에 대한 속성 수집을 켜거나 끕니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

오류에서 이름이 allAgentAttributeNames 인 속성 슬라이스를 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.ErrorCollector.Attributes.Exclude = allAgentAttributeNames
    },
)

true 일 때 에이전트는 트랜잭션 추적 (느린 트랜잭션에 대한 세부 정보)을 수집합니다.

트랜잭션 추적 임계값이 Apdex를 기반으로 하는지 여부를 제어합니다.

• true 인 경우 추적 임계값은 Apdex 임계값 의 4배입니다.
• false 인 경우 에이전트는 Threshold.Duration 을 트랜잭션 추적 임계값으로 사용합니다.

Threshold.IsApdexFailing 이 false 로 설정되면 에이전트는 이 기간을 트랜잭션 추적 임계값으로 사용합니다.

세그먼트가 추적에 추가되는 임계값입니다.

TransactionTracer.Segments.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

TransactionTracer.Segments.Attributes.Enabled 을 사용하여 트랜잭션 추적 세그먼트에 대한 속성 수집을 켜거나 끕니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

추적에서 이름이 allSegmentAttributeNames 인 속성 슬라이스를 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.TransactionTracer.Segments.Attributes.Exclude = allSegmentAttributeNames
    },
)

이것은 트랜잭션 추적에서 세그먼트에 스택 추적이 제공되는 임계값입니다.

TransactionTracer.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

TransactionTracer.Attributes.Enabled 을 사용하여 트랜잭션 추적에 대한 속성 수집을 켜거나 끕니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

추적에서 이름이 allAgentAttributeNames 인 속성 슬라이스를 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.TransactionTracer.Attributes.Exclude = allAgentAttributeNames
    },
)

이를 통해 일부 데이터베이스 드라이버에 대한 데이터 저장소 인스턴스 메트릭(예: 호스트 및 포트)을 수집할 수 있습니다. 이는 트랜잭션 추적 및 느린 쿼리 데이터 의 일부로 보고됩니다.

느린 쿼리 추적 및 트랜잭션 추적에서 데이터베이스 이름 수집을 활성화하려면 이것을 사용하십시오. 활성화된 속성의 기본값은 true 입니다.

true 일 때 에이전트는 데이터 저장소 호출 쿼리 매개변수를 수집합니다.

느린 쿼리 가 캡처되는지 여부를 제어합니다.

에이전트는 이보다 느린 쿼리에 대해 느린 쿼리 데이터 를 캡처합니다.

true 일 때 에이전트는 아웃바운드 요청에 교차 애플리케이션 추적 헤더를 추가하고 교차 애플리케이션 추적 헤더에 대해 수신 요청을 스캔합니다.

분산 추적 및 교차 애플리케이션 추적은 동시에 사용할 수 없습니다. Go 에이전트의 기본 구성은 분산 추적을 비활성화하고 애플리케이션 간 추적을 활성화합니다.

표준 추적은 Go 에이전트 버전 3.16.0 이상에서 기본적으로 켜져 있습니다.즉, 에이전트는 아웃바운드 요청에 분산 추적 헤더를 자동으로 추가하고 분산 추적 헤더에 대해 수신 요청을 검색합니다.분산 추적을 비활성화하려면 값을 false 으로 설정합니다.

분산 추적 설정에 대한 자세한 내용은 Go 애플리케이션에 분산 추적 사용 을 참조하십시오.

아웃바운드 요청에 첨부된 New Relic 헤더를 제외하고 대신 분산 추적을 위해 W3C 추적 컨텍스트 헤더에만 의존하려면 이것을 true 으로 설정합니다. 이것이 false 이면 두 가지 유형의 헤더가 모두 사용됩니다.

true 일 때 에이전트는 스팬 이벤트를 수집합니다.

SpanEvents.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

SpanEvents.Attributes.Enabled 을 사용하여 스팬 이벤트에 대한 속성 수집을 활성화하거나 비활성화합니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

추적에서 이름이 allSpanAttributeNames 인 속성 슬라이스를 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.TransactionTracer.Segments.Attributes.Exclude = allSpanAttributeNames
    },
)

true 인 경우 이러한 하위 기능 구성도 활성화된 경우 로그 이벤트 및 로깅 측정항목 수집을 활성화합니다.false 이면 로깅 계측 기능이 활성화되지 않습니다.

ConfigAppLogEnabled()를 호출하여 ApplicationLogging을 구성합니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppLogEnabled(true),
  )

true 인 경우 에이전트는 애플리케이션에서 내보낸 로그 레코드를 캡처하여 New Relic에 전달합니다. 이 설정을 적용하려면 ApplicationLogging.Enabled 도 true }여야 합니다.

ConfigAppLogForwardingEnabled()를 호출하여 로그 전달을 활성화합니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppLogForwardingEnabled(true),
  )

New Relic에 분당 보낼 로그 레코드 수입니다. 이 설정은 로그 전달 기능을 사용할 때 전체 메모리 소비를 제어합니다.

ConfigAppLogForwardingMaxSamplesStored()를 호출하여 ApplicationLogging.Forwarding.MaxSamplesStored를 구성합니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppLogForwardingMaxSamplesStored(1000),
  )

true 인 경우 에이전트는 애플리케이션에서 전송 중인 로그 라인과 관련된 측정항목을 캡처합니다. 이 설정을 적용하려면 ApplicationLogging.Enabled 도 true }여야 합니다.

ConfigAppLogMetricsEnabled()를 호출하여 ApplicationLogging.Metrics.Enabled를 구성합니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppLogConfigAppLogMetricsEnabled(true),
  )